=== Blog Post Reading Time ===
Contributors: rathodnaren
Tags: reading time, estimated read time, post reading time, listen article, text to speech, blog tools
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.2
Stable tag: 2.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display estimated reading time and let your visitors listen to blog posts with a built-in text-to-speech option. Boost engagement by helping readers consume your content the way they prefer.

== Description ==

**Blog Post Reading Time** is a lightweight plugin that enhances your blog posts with two key features:  

1. **Estimated Reading Time** – show readers how long it will take to read your article.  
2. **Listen to Article (Text-to-Speech)** – allow visitors to listen to your blog post using a simple “Listen” button powered by the browser’s built-in speech API.  

These features improve accessibility, keep users engaged, and reduce bounce rates by giving them multiple ways to consume your content.  

**Features:**
- Automatically display reading time on posts
- Shortcode support: `[bprt_post_reading_time]` and `[bprt_listen_article]`
- Customizable label text (e.g., "Estimated reading time:")
- Option to show or hide the clock icon (⏱)
- Display positions: after title, after featured image, or before content
- Custom font size setting (in px)
- Adjustable words-per-minute (WPM) setting
- Add a custom postfix (e.g., "min read")
- Enable/disable “Listen to this Article” feature
- Lightweight and works without third-party APIs (uses browser’s built-in Web Speech API)

== Installation ==

1. Upload the plugin folder `blog-post-reading-time` to the `/wp-content/plugins/` directory.  
2. Activate the plugin through the **Plugins** menu in WordPress.  
3. Navigate to **Settings > Blog Post Reading Time** to configure options.  
4. Use the shortcodes `[bprt_post_reading_time]` or `[bprt_listen_article]` in your posts if you want manual placement.  

== Frequently Asked Questions ==

= Can I use this manually with a shortcode? =  
Yes. Use `[bprt_post_reading_time]` for reading time and `[bprt_listen_article]` for the listen button.  

= Does the listen feature require an external API or paid service? =  
No. It uses the browser’s built-in **Web Speech API**, which is completely free.  

= Will it work with custom post types? =  
Currently, it supports the default `post` type. Custom post type support may be added in future updates.  

= Can I hide the clock icon? =  
Yes, the plugin includes a checkbox setting to toggle the clock icon on or off.  

= Can I disable the listen feature if I don’t want it? =  
Yes. The “Listen to Article” option can be turned on or off in the plugin settings.  

== Screenshots ==

1. Plugin settings panel.  
2. Display position selection  
3. Display Mode Selection  
4. Show the reading time and listen button on post  

== Changelog ==

= 2.1 =
* Added **Listen to Article** feature with shortcode `[bprt_listen_article]`
* Added toggle option in settings to enable/disable listening feature
* Improved shortcode rendering and frontend scripts

= 1.1 =
* Added shortcode option  
* Added display mode: automatic or manual  
* New settings: font size, label, postfix, WPM, icon toggle  
* Improved rendering logic  

= 1.0 =
* Initial release  

== Upgrade Notice ==

= 2.1 =
Now includes a **Listen to Article** feature! Readers can either view reading time or listen to the blog post directly.  

== License ==

This plugin is released under the GPLv2 or later.  

== Credits ==

Developed by Rathod Narendra  
Visit: https://kappatechnosoft.com