⏱️ Sam Reading Time (SRT) – WordPress Plugin

Sam Reading Time (SRT) is a super lightweight WordPress plugin that calculates and displays the estimated reading time for your posts and pages using a simple shortcode.

✨ Features

• Estimate reading time based on word count
• Massively lightweight and optimized codebase
• Works via [sam_reading_time] shortcode
• Clean output – fully theme-compatible
• Translation-ready and extendable
• Automatically recalculates times when WPM changes
• SEO plugin conflict warnings
• Requires WordPress 6.3+ and PHP 7.2+

---

🔧 Installation

1. Download the plugin ZIP or clone the repository into your WordPress plugin directory:
   /wp-content/plugins/sam-reading-time/

2. Activate the plugin from the WordPress admin dashboard.

---

🧩 Usage

To display the reading time anywhere in your post, simply add the following shortcode:

[sam_reading_time]

This will output something like:

[time] minutes read

You can place this shortcode in:

• Post or page content
• Custom post types
• Template files (using do_shortcode())

Example for PHP templates:

echo do_shortcode('[sam_reading_time]');

---

🧠 How Reading Time Is Calculated

• The plugin counts all words in the current post or page content.
• Default reading speed is 200 words per minute.
• The number of words is divided by 200, then rounded up to the nearest full minute.

For example:

• 765 words / 200 = 3.825
• Rounded = 4 minutes

Note: If you change the WPM setting, all existing posts will automatically have their reading time recalculated.

---

🌍 SEO & Rich Snippets

• Supports Schema.org timeRequired JSON-LD for Google Rich Snippets.
• Can be toggled on/off in settings.
• Enhances search visibility and user engagement.
• The schema output is now independent of the shortcode, working seamlessly on all singular pages.
• If you use plugins like Yoast SEO or Rank Math, the plugin will display an admin notice to prevent schema conflicts.

---

🌐 Multilingual Support

• Fully compatible with Polylang and WPML.
• Calculates reading time correctly for translated content.

---

🌍 WordPress.org Repository

Sam Reading Time is officially listed in the WordPress Plugin Directory.

📦 Install from WordPress Admin

1. Navigate to Plugins → Add New.
2. Search for Sam Reading Time.
3. Click Install Now, then Activate.

---

🛡 License

Released under the GPLv2 License

---

👨‍💻 Author

SAM Web Design Agency
🔗 Website: samwda.ir
📦 GitHub: github.com/samwda

---

💬 Feedback & Contributions

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

---

Enjoy fast, clean reading time calculation with SRT ⏱✨