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

---

پلگ انس ڳولھيو

![](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://snd.wordpress.org/plugins/readspan/#description)
 * [جائزو](https://snd.wordpress.org/plugins/readspan/#reviews)
 *  [تنصيب](https://snd.wordpress.org/plugins/readspan/#installation)
 * [ترقي](https://snd.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/)، يا رڪنيت حاصل ڪريو [ڊولپمينٽ لاگ](https://plugins.trac.wordpress.org/log/readspan/)
پاران [RSS](https://plugins.trac.wordpress.org/log/readspan/?limit=100&mode=stop_on_copy&format=rss).

## لاگ تبدیل ڪريو

#### 1.0.0

 * Initial release

## ميٽا

 *  Version **1.0.0**
 *  Last updated **2 مهينا اڳ**
 *  Active installations **10 کان گھٽ**
 *  WordPress version ** 5.0 يا وڌيڪ **
 *  Tested up to **6.9.4**
 *  PHP version ** 7.4 يا وڌيڪ **
 *  Language
 * [English (US)](https://wordpress.org/plugins/readspan/)
 * Tags
 * [badge](https://snd.wordpress.org/plugins/tags/badge/)[engagement](https://snd.wordpress.org/plugins/tags/engagement/)
   [progress bar](https://snd.wordpress.org/plugins/tags/progress-bar/)[reading progress](https://snd.wordpress.org/plugins/tags/reading-progress/)
   [reading time](https://snd.wordpress.org/plugins/tags/reading-time/)
 *  [ترقي يافته ڏيک](https://snd.wordpress.org/plugins/readspan/advanced/)

## درجه بندي

No reviews have been submitted yet.

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

[See all reviews](https://wordpress.org/support/plugin/readspan/reviews/)

## تعاون ڪندڙ

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

## سھائتا

چوڻ لاءِ ڪجهه آهي؟ مدد گهرجي؟

 [ڏسو سپورٽ فورم](https://wordpress.org/support/plugin/readspan/)