Title: ReadSpan — Customizable Reading Time Badge & Progress Bar
Author: ibrahimhalefoglu
Published: <strong>2026-يىلى 14-ماي</strong>
Last modified: 2026-يىلى 14-ماي

---

قىستۇرما ئىزدە

![](https://ps.w.org/readspan/assets/banner-772x250.png?rev=3538645)

![](https://s.w.org/plugins/geopattern-icon/readspan_6d9298.svg)

# ReadSpan — Customizable Reading Time Badge & Progress Bar

 يازغۇچى [ibrahimhalefoglu](https://profiles.wordpress.org/ibrahimhalefoglu/)

[چۈشۈر](https://downloads.wordpress.org/plugin/readspan.1.0.0.zip)

 * [تەپسىلاتلار](https://ug.wordpress.org/plugins/readspan/#description)
 * [باھالاشلار](https://ug.wordpress.org/plugins/readspan/#reviews)
 *  [ئورنىتىش](https://ug.wordpress.org/plugins/readspan/#installation)
 * [ئىجادىيەت](https://ug.wordpress.org/plugins/readspan/#developers)

 [قوللاش](https://wordpress.org/support/plugin/readspan/)

## چۈشەندۈرۈش

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

## ئورنىتىش

 1. Upload the `readspan` folder to `/wp-content/plugins/`
 2. Activate the plugin in **Plugins > Installed Plugins**
 3. 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.

## باھالاشلار

بۇ قىستۇرمىغا تېخى باھا يېزىلمىدى.

## تۆھپىكار ۋە ئىجادكار

«ReadSpan — Customizable Reading Time Badge & Progress Bar» كودى ئوچۇق يۇمشاق دېتال.
تۆۋەندىكى كىشىلەر بۇ قىستۇرمىغا تۆھپە قوشقان.

تۆھپىكار

 *   [ ibrahimhalefoglu ](https://profiles.wordpress.org/ibrahimhalefoglu/)

[«ReadSpan — Customizable Reading Time Badge & Progress Bar» نى تىلىڭىزغا تەرجىمە قىلىڭ](https://translate.wordpress.org/projects/wp-plugins/readspan)

### ئىجادىيەتكە قىزىقامسىز؟

[كودقا كۆز يۈگۈرتۈپ](https://plugins.trac.wordpress.org/browser/readspan/)، [SVN خەزىنە](https://plugins.svn.wordpress.org/readspan/)
تەكشۈرۈپ ياكى [RSS](https://plugins.trac.wordpress.org/log/readspan/?limit=100&mode=stop_on_copy&format=rss)
ئارقىلىق [ئىجادىيەت خاتىرىسى](https://plugins.trac.wordpress.org/log/readspan/)گە
مۇشتەرى بولغىلى بولىدۇ.

## ئۆزگىرىش خاتىرىسى

#### 1.0.0

 * Initial release

## Meta

 *  Version **1.0.0**
 *  ئاخىرقى يېڭىلانغان ۋاقىت **4 ھەپتە بۇرۇن**
 *  ئاكتىپ ئورنىتىش سانى **10 دىن ئاز**
 *  WordPress نەشرى ** 5.0 ياكى يۇقىرى **
 *  **6.9.4** دا سىنالغان
 *  PHP نەشرى ** 7.4 ياكى يۇقىرى **
 *  تىل
 * [English (US)](https://wordpress.org/plugins/readspan/)
 * بەلگە
 * [badge](https://ug.wordpress.org/plugins/tags/badge/)[engagement](https://ug.wordpress.org/plugins/tags/engagement/)
   [progress bar](https://ug.wordpress.org/plugins/tags/progress-bar/)[reading progress](https://ug.wordpress.org/plugins/tags/reading-progress/)
   [reading time](https://ug.wordpress.org/plugins/tags/reading-time/)
 *  [ئالىي كۆرۈنۈش](https://ug.wordpress.org/plugins/readspan/advanced/)

## دەرىجە

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/readspan/reviews/#new-post)

[بارلىق ئىنكاسنى كۆرسەت](https://wordpress.org/support/plugin/readspan/reviews/)

## تۆھپىكار

 *   [ ibrahimhalefoglu ](https://profiles.wordpress.org/ibrahimhalefoglu/)

## قوللاش

چۈشەندۈرۈشىڭىز بارمۇ؟ ياردەم لازىممۇ؟

 [قوللاش مۇنبىرىنى كۆرسەت](https://wordpress.org/support/plugin/readspan/)