Description
ReadSpan adds two lightweight engagement features to your WordPress site:
Reading Time Badge
A pill-shaped badge that displays estimated reading time, injected before, after, or both sides of post content. Supports three SVG icons (clock, book, stopwatch), custom colors, shapes, padding, and font size. Works via shortcode too.
Scroll Progress Bar
A fixed-position progress bar (top or bottom of the viewport) that fills as the reader scrolls. Supports solid color, gradient, configurable height, and a real-time countdown feature in the badge.
Highlights
- Zero JavaScript dependencies — vanilla JS, passive scroll listener with requestAnimationFrame throttle
- CSS custom properties for instant style updates
- 24 configurable settings via a clean 3-tab admin UI with live preview
- Mobile hide option (below 768 px)
- Dark mode admin UI (prefers-color-scheme: dark)
- Shortcode
[readspan]support - PHP 7.4 compatible, no Composer required on production
- Follows WordPress Coding Standards and DDD architecture
Installation
- Upload the
readspanfolder to/wp-content/plugins/ - Activate the plugin in Plugins > Installed Plugins
- Go to Settings > ReadSpan to configure
FAQ
-
Does this slow down my site?
-
No. Assets are only loaded on singular post/page views. The progress bar script is deferred (footer) and uses passive scroll events with requestAnimationFrame.
-
How does the `[readspan]` shortcode work?
-
Enable the shortcode in Settings > ReadSpan > Genel. Placing
[readspan]in post content activates the reading progress bar and badge on that post, even if its post type is not in your configured list. The badge itself is always positioned according to your Konum (position) setting — before content, after content, or both — not at the shortcode location. -
What reading speed is used?
-
Default is 200 words per minute. You can set any value between 100 and 400 WPM from the settings panel.
-
Does it support custom post types?
-
Yes — you can select which post types display the badge and bar from the settings panel.
Reviews
ഈ പ്ലഗിന് റിവ്യൂകൾ ഒന്നുമില്ല.
Contributors & Developers
“ReadSpan — Customizable Reading Time Badge & Progress Bar” is open source software. The following people have contributed to this plugin.
Contributors
Translate “ReadSpan — Customizable Reading Time Badge & Progress Bar” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release