=== Reading Time ===
Contributors: contentpowered
Author: Content Powered
Author URI: https://www.contentpowered.com/wordpress-plugins/
Plugin URI: https://www.contentpowered.com
Tags: reading time, read time, estimated reading time, word count, reading progress
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.2
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Shows an accurate "5 min read" on your posts and pages, added automatically or with a block, shortcode or PHP.

== Description ==

Tell readers how long a post takes before they start. Activate the plugin and every post shows a reading time above its content, styled to match your theme. There's nothing to set up, and everything can be changed under Content Powered > Reading Time.

= Accurate counts =

* Counts only what a reader reads. Tables of contents, share buttons, related posts, forms, buttons, embeds and hidden text are left out, and so are other posts shown by blocks like Latest Posts.
* Counts text in synced patterns and inside page-builder shortcodes (columns, tabs, boxes) from Divi, WPBakery and others.
* Chinese and Japanese, which are written without spaces, are counted by character. Every other language, including Korean, Arabic and Cyrillic scripts, by word.
* Optionally adds time for images, the way Medium does.
* Leave out code blocks, captions, or anything with a CSS class you choose.
* Set the reading speed (238 words a minute by default, the adult average), the rounding, and what to say for posts under a minute.

= Shows up where you want it =

* Automatically above or below the content, on posts, pages, products or any public post type.
* Optionally on the blog page, categories, tags and search results, in classic and block themes.
* The Reading Time block for the Site Editor and Query Loops, where each post shows its own time.
* The [reading_time] shortcode, and do_action( 'reading_time' ) for theme templates.
* Optionally in your RSS feed, for feed readers and RSS-to-email newsletters.

= No surprises =

* Never ends up in excerpts, SEO meta descriptions, widgets or REST API content.
* Steps aside on posts where you've added the block, shortcode or PHP tag, so it never shows twice.
* Hide it on short posts, in chosen categories, on the homepage, or on a single post. Or set a post's time by hand.
* The settings page previews your latest posts as you change things, and says why a post doesn't show a reading time.

= Extras =

* Choose the wording, an icon and a style (plain, subtle or a badge), or write your own wording for one and several minutes.
* An optional reading progress bar that follows the article, not the whole page.
* Adds timeRequired to the Article schema from Yoast SEO, Rank Math or All in One SEO.
* A Reading time column with word counts on the Posts screen.
* A read-only reading_time field in the REST API.

It's fast: counts are worked out once per post and cached, the styles are half a kilobyte printed inline, and no JavaScript loads unless you turn on the progress bar.

Find it under Content Powered > Reading Time in the admin menu.

Found a bug or have an idea? Use Content Powered > Report a Bug or Content Powered > Submit Feedback to send it straight to us.

= Credits =

* Icons by [Lucide](https://lucide.dev), used under the ISC License. Icons derived from [Feather](https://feathericons.com) are under the MIT License. The full license text is in `icons/LICENSE`.
* Updates delivered by [Plugin Update Checker](https://github.com/YahnisElsts/plugin-update-checker) by Janis Elsts, MIT License.

== Installation ==

1. Upload the `reading-time` folder to `/wp-content/plugins/`.
2. Activate the plugin through the Plugins screen in WordPress.
3. That's it: posts now show their reading time. To change anything, go to Content Powered > Reading Time.

Updates arrive through the normal WordPress Updates screen, and you can turn on auto-updates from the Plugins screen.

== Frequently Asked Questions ==

= Why doesn't a post show its reading time? =

Open the post in the editor: the Reading Time box says why. It may be shorter than the minimum word count, in a category you've left out, hidden on that post, or a post type that isn't switched on. The preview on the settings page explains it for your latest posts too.

= Why is it different from the reading time WordPress shows in the editor? =

The editor's own estimate uses a slower, fixed speed and counts everything in the post. This plugin uses the speed you set (238 words a minute by default) and leaves out things nobody reads, like tables of contents and buttons. You can change the speed under Calculation.

= How do I put it next to the date? =

In a block theme, add the Reading Time block beside the date in your single post template (Appearance > Editor). In a classic theme, add <?php do_action( 'reading_time' ); ?> to the template where the date is printed. Either way, the automatic one steps aside on those posts.

= Will it show up in my meta descriptions or excerpts? =

No. It's left out of excerpts built from the content, anything printed in the page's head (where SEO plugins build descriptions), widgets and REST API content.

= Does it work with page builders? =

Yes, with any builder that saves its content as normal post content or shortcodes, like Elementor, Divi, WPBakery and Beaver Builder. The text inside their shortcodes is counted, without running them. Developers can count content stored elsewhere with the reading_time_content filter.

= Does it slow my site down? =

No. Each post is counted once and the result is cached until the post or the counting settings change. The styles are about half a kilobyte, printed inline, and there's no JavaScript unless you turn on the progress bar.

= How do I get updates? =

Through the normal WordPress Updates screen. The plugin checks our GitHub releases twice a day, and you can update with one click or turn on auto-updates from the Plugins screen.

== Changelog ==

See https://github.com/jmsprsns/reading-time/releases for the full release history.
