https://github.com/samwda/srt
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.
https://github.com/samwda/srt
Last synced: 11 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/samwda/srt
- Owner: samwda
- License: gpl-2.0
- Created: 2025-07-23T19:53:33.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-08-01T15:03:40.000Z (11 months ago)
- Last Synced: 2025-08-01T16:03:16.255Z (11 months ago)
- Language: PHP
- Homepage:
- Size: 87.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ⏱️ Sam Reading Time (SRT) – WordPress Plugin
[](https://wordpress.org/plugins/sam-reading-time/)
[](https://github.com/samwda/srt/releases)
[](https://wordpress.org/plugins/sam-reading-time/)
[](https://github.com/samwda/srt/blob/main/LICENSE)
**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
- Lightweight and easy to use
- Works via `[sam_reading_time]` shortcode
- No settings page or database queries
- Clean output – fully theme-compatible
- Translation-ready and extendable
---
## 🔧 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:
> Reading Time: 4 minutes
You can place this shortcode in:
- Post or page content
- Custom post types
- Template files (using `do_shortcode()`)
Example for PHP templates:
```php
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
---
## 🌍 WordPress.org Repository
Sam Reading Time is officially listed in the [WordPress Plugin Directory](https://wordpress.org/plugins/sam-reading-time/).
### 📦 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](https://samwda.ir)
📦 GitHub: [github.com/samwda](https://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** ⏱✨