=== ReadSpan — Customizable Reading Time Badge & Progress Bar ===
Contributors: ibrahimhalefoglu
Tags: reading-time, progress-bar, reading-progress, badge, engagement
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Show a reading time badge and a scroll progress bar on your posts and pages — fully customizable from the admin panel.

== 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 ==

1. Upload the `readspan` folder to `/wp-content/plugins/`
2. Activate the plugin in **Plugins > Installed Plugins**
3. Go to **Settings > ReadSpan** to configure

== Frequently Asked Questions ==

= 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.

== Screenshots ==

1. Admin settings panel — Genel tab with live preview
2. Admin settings panel — Rozet tab
3. Admin settings panel — Progress Bar tab
4. Reading time badge on a post
5. Scroll progress bar at the top of the viewport

== Changelog ==

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.0.0 =
Initial release — no upgrade steps required.
