Descripción
WP Distraction Free View adds a clean frontend Reader Mode to WordPress, helping visitors focus on your content without sidebars, widgets, navigation, and visual clutter.
WordPress core already includes distraction-free writing tools for the admin editor. This plugin is for the frontend visitor reading experience.
Use it to offer focused reading for posts, pages, and selected public custom post types. Visitors can open content in a polished Reader Mode overlay, use the Reader settings control in the modal header to adjust font size, switch between light/dark/sepia themes, choose a comfortable content width, print the reader view, or use browser fullscreen.
Features
- Frontend Reader Mode for posts, pages, and selected public custom post types.
- Clean reading column with comfortable typography, spacing, and width.
- Reader Mode Toggle block for posts, pages, custom post types, and Query Loop templates.
- Shortcode support with
[wpdfv]. - Optional automatic toggle placement before content, after content, or as a floating button.
- URL activation with
?reader-mode=1. - Visitor preferences for font size, theme, and content width saved in localStorage only.
- Optional reading progress indicator.
- Optional estimated reading time.
- Block-based Reader Mode templates for full site editing themes.
- WordPress-components settings screen.
- Lightweight frontend assets with no external tracking, telemetry, or third-party libraries.
Settings Overview
Go to Settings > Reader Mode to configure:
The settings screen is organized into About, Configure, and More Plugins tabs. Reader Mode configuration lives under Configure.
- Enable Reader Mode for selected public post types.
- Toggle placement: manual only, before content, after content, or floating.
- Reading progress.
- Estimated reading time.
- Reader preference controls.
- Default reader theme: light, dark, or sepia.
- Default content width: narrow, default, or wide.
- Default font size: small, default, or large.
- Custom toggle label.
- Custom exit label.
- Reader template.
Automatic toggle insertion is disabled for new installs. Existing installs keep their previous automatic insertion behavior during upgrade unless it was already disabled.
Usage
Use the Reader Mode Toggle block in posts, pages, public custom post types, single templates, and Query Loop templates.
Use the shortcode:
[wpdfv]
Reader Mode can also open from the URL on enabled single content:
https://example.com/my-post/?reader-mode=1
Template Customization
The Reader Mode content is rendered through block-based templates. The plugin registers a default Reader Mode layout and a WP Distraction Free View pattern category for block themes.
Themes and site-specific code can add templates with the wpdfv_modal_templates filter.
Capturas
Bloques
Este plugin proporciona 1 bloque.
- Reader Mode Toggle Adds a button that opens the current post in frontend Reader Mode.
Instalación
- Upload
wp-distraction-free-viewto thewp-content/plugins/directory. - Activate the plugin through the Plugins menu in WordPress.
- Configure the plugin from Settings > Reader Mode.
- Add the Reader Mode Toggle block or shortcode where needed, or enable automatic toggle insertion.
Preguntas frecuentes
-
Is this the same as WordPress editor distraction-free mode?
-
No. WordPress core distraction-free mode is for writing in the admin editor. WP Distraction Free View is for the frontend visitor reading experience.
-
Can I place the Reader Mode toggle manually?
-
Yes. Use the Reader Mode Toggle block or the
[wpdfv]shortcode. -
Can Reader Mode open from a URL?
-
Yes. Add
?reader-mode=1to enabled single posts, pages, or selected public custom post types. -
Are visitor preferences stored on the server?
-
No. Font size, theme, and content width preferences are saved only in the visitor browser with localStorage.
-
Does Reader Mode support print and fullscreen?
-
Yes. Reader Mode includes icon-only print and fullscreen controls in the modal header.
-
Can block themes customize the Reader Mode layout?
-
Yes. The plugin registers a default block-based Reader Mode template and a WP Distraction Free View pattern category. Themes and site-specific code can add more templates with the
wpdfv_modal_templatesfilter. -
Will old settings keep working?
-
Yes. Existing saved settings remain in the
wpdfv_settingsoption and oldwpdfv_generalvalues are migrated during upgrade. The supported shortcode remains[wpdfv].
Reseñas
No hay reseñas para este plugin.
Colaboradores y desarrolladores
Este software es de código abierto. Las siguientes personas han contribuido a este plugin.
ColaboradoresTraduce “WP Distraction Free View” a tu idioma.
¿Interesado en el desarrollo?
Revisa el código, echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
1.7.0
- Added: Frontend Reader Mode positioning and product copy while keeping the WP Distraction Free View name and slug.
- Added: Reader Mode Toggle block for posts, pages, public custom post types, and Query Loop templates.
- Added: Visitor reader preferences for font size, light/dark/sepia theme, and content width, stored in localStorage.
- Added: Optional reading progress indicator, estimated reading time, and URL activation with
?reader-mode=1. - Added: Block-based modal templates with a default template and pattern category for FSE themes.
- Added: More Plugins settings tab with free WordPress.org plugin install/activate actions and paid plugin links.
- Added: Shared Reader Mode defaults, sanitization, and idempotent 1.7.0 upgrade handling from existing 1.6.0 installs.
- Changed: Minimum requirements are now WordPress 6.0 and PHP 8.2.
- Changed: Rebuilt admin settings and Reader Mode modal with WordPress components and REST API.
- Changed: Modernized the asset build around
@wordpress/scripts. - Changed: Automatic toggle insertion is disabled for new installs while existing installs keep their previous automatic insertion behavior unless it was already disabled.
- Changed: Kept
[wpdfv]as the only documented shortcode. - Changed: Default toggle label for new installs is now “Read in Reader Mode”.
- Changed: Settings menu copy now frames the feature as Reader Mode.
- Added: PHPUnit test coverage and CI workflow for PHP, PHPCS, JS/CSS linting, and asset builds.
- Fixed: Activation no longer marks legacy inactive installs as fully upgraded before migrations run.
- Fixed: Reader Mode block output now uses the shared frontend asset handle and settings payload.
- Fixed: Reader content requests now respect the enabled post type configuration.
- Fixed: Reading time is calculated once per Reader Mode response without rendering dynamic blocks.
- Fixed: Shortcode rendering no longer calls a removed helper function.
- Changed: Runtime autoloading now uses Composer’s PSR-4 autoloader.
1.6.0: 16th May 2021
- Refactor: Improved UX for the admin settings UI
- Added: Support for display on post types
1.5.0: 10th March 2021
- Improvement: Refactor code to use PHP namespaces
- Fix: Resolve issues related to assets not loading
- Feature: Add settings and support links on plugins list
1.4.5: 26th November 2019
- Ensure that “Read Mode” button text can be changed from settings
1.4.4: 23rd November 2019
- Updated CSS for the “Read Mode” button to have cursor pointer.
1.4.3: 19th November 2019
- Included Automated Development Process
- Fix for Fullscreen and Print icon
1.4.2: 19th November 2019
- Shortcode renamed from
[dfview]to[wpdfv] - Fix: refactor plugin for stability #4
- Feat: update code to support latest WP 5.3 #1
- Security Improvements
- UI Improvements
- Stability Improvements
- Removed Font Awesome support
1.4.0
- Removed Genericons Support
- Added Font Awesome Support using CDN
1.3.0
- Improved Print Support
- Improved Fullscreen support
- Powerful Admin Settings Panel Support Added
- Light weight Adjustments
- Added Flexibility
- Improved User Experience
1.2.0
- Fixed overlay issues on mostly all the themes
1.1.0
- Fixed few alignment and validation errors
- Fixed popup inconsistency
- Added Print Support
1.0.0: Initial Release
- Ability to display button at specified location in a post.
- [dfview] Shortcode supported.
- Ability to change “DF View” button text.



