=== ReadJutsu – Reading Time & Scroll Progress Bar ===
Contributors: wpjutsu
Tags: reading time, progress bar, scroll progress, estimated reading time, reading progress
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Show an estimated reading time badge and a sleek scroll progress bar — keep readers engaged to the last line. No code needed.

== Description ==

**Most visitors decide in seconds whether your article is worth their time. Show them.**

A "4 min read" badge answers the question every reader silently asks before committing. A progress bar that fills as they scroll gives them a reason to finish. ReadJutsu adds both to your WordPress site in minutes — no code, no bloat.

[See it in action →](https://www.wp-jutsu.com/plugins/readjutsu)

Readers who know what they're committing to read more, scroll deeper, and finish more articles. That's better engagement signals, longer time on page, and content that actually gets read.

= Reading time badge =

* Estimated minutes-to-read, displayed before or after your content — automatically on the post types you choose
* Or place it anywhere with the **Gutenberg block** or the `[readjutsu]` shortcode
* **Three styles** (pill, minimal, inline), custom colors, prefix/postfix text, optional clock icon
* Smart calculation: words ÷ your reading speed (default 238 wpm, configurable), with optional diminishing time per image

= Scroll progress bar =

* A slim fixed bar (top, bottom, left or right) that fills as the reader scrolls
* **Solid or gradient** style, custom colors and height
* Track the article content or the full page
* Automatic on chosen post types, or manual with the `[readjutsu_bar]` shortcode

Both features support **block themes natively** and ship dependency-free, performance-first code.

= ReadJutsu Pro =

Ready to understand your readers, not just count them?

* **Privacy-first reading analytics** — views, scroll depth and completion rate per post, with no cookies and no personal data. Know which articles actually get read.
* **Floating badge** — viewport-anchored, in the corner of your choice
* **Extra badge styles** — bordered, glass
* **Animated progress bars** — animated, percent and donut styles
* **Per-post overrides** — hide or force features, set a manual reading time

[Discover ReadJutsu Pro →](https://www.wp-jutsu.com/plugins/readjutsu)

== External Services ==

This plugin uses the **Freemius SDK** (bundled) for licensing, upgrade management and optional usage tracking.

* **What data is sent and when:** Freemius does not collect any data unless you explicitly **opt in** when prompted after activation. If you opt in, diagnostic data (WordPress version, PHP version, plugin version, site URL, admin email) is sent to Freemius to provide update/licensing services. If you skip the opt-in, nothing is sent. Paid licence holders' purchase data is processed by Freemius as the payment/licensing platform.
* **Service provider:** Freemius, Inc. — [Terms of Service](https://freemius.com/terms/) · [Privacy Policy](https://freemius.com/privacy/)

The Pro analytics feature stores **only anonymous aggregated counters** (views, scroll depth, completion per post per day) in your own database. No cookies are set, no IP addresses or personal data are collected, and nothing is sent to any third party.

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/readjutsu/`, or install through the WordPress plugins screen.
2. Activate the plugin.
3. Go to **ReadJutsu** in the admin menu to configure the badge and the progress bar.

== Frequently Asked Questions ==

= Does showing a reading time really increase engagement? =

Yes — it's why major publishing platforms display one on every article. Telling readers what they're committing to upfront reduces bounce on long posts and increases the share of readers who finish. The progress bar reinforces it by giving a visible sense of advancement.

= Does it work with block themes? =

Yes. Both features support block themes natively, and both are available as Gutenberg blocks.

= Can I place the badge manually? =

Yes. Switch the badge display mode to "Manual" and use the ReadJutsu — Reading Time block or the `[readjutsu]` shortcode wherever you want. The same applies to the progress bar with `[readjutsu_bar]`.

= Can I see which articles readers actually finish? =

That's exactly what **ReadJutsu Pro** analytics is for: views, scroll depth and completion rate per post — fully anonymous, no cookies, stored in your own database. The free version focuses on the reader-facing features.

= Does the plugin slow my site down? =

No. The frontend ships one small stylesheet and one dependency-free script (only when the progress bar is active). No external requests are made.

= Is it GDPR compliant? =

The free plugin stores nothing about your visitors. The Pro analytics feature is aggregate-only by design: no cookies, no IPs, no personal data — no consent banner needed.

== Screenshots ==

1. Reading time badge styles — pill, minimal and inline, with custom colors.
2. The scroll progress bar filling as the reader scrolls.
3. Progress bar settings.
4. General settings.

== Changelog ==

= 1.0.0 =
* Initial release
