Download the PHP package jalendport/craft-readtime without Composer
On this page you can find all versions of the php package jalendport/craft-readtime. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download jalendport/craft-readtime
More information about jalendport/craft-readtime
Files in jalendport/craft-readtime
Package craft-readtime
Short Description Calculate the estimated read time for content.
License MIT
Informations about the package craft-readtime
Read Time plugin for Craft CMS 3
Calculate the estimated read time for content.
Installation
Requirements
This plugin requires Craft CMS 4.0.0, or later.
Plugin Store
Log into your control panel and click on 'Plugin Store'. Search for 'Read Time'.
Composer
-
Open your terminal and go to your Craft project:
-
Then tell Composer to load the plugin:
- In the Control Panel, go to Settings → Plugins and click the “Install” button for Read Time.
Configuration
The average user read speed is set at 200 words per minute by default, this can be changed in the plugin settings.
Using the Filter
The |readTime
filter returns a TimeModel of how long it takes the average user to read the provided content. The value provided can be a string or an array of values.
Seconds are included by default, but can be disabled by using |readTime(false)
- this only affects the human time format.
Examples
Using the Function
The readTime()
function returns a TimeModel for matrix fields or the whole entry based on it's field layout.
Seconds are included by default, but can be disabled by adding a second parameter of false
- this only affects the human time format.
Examples
TimeModel
Whenever you're dealing with the read time in your template, you're actually working with a TimeModel object.
Simple Output
Outputting a TimeModel object without attaching a property or method will return the time in the form of a human time duration.
Properties
human
The human time duration.
interval(format)
A DateInterval
object. You'll need to set the format as a parameter:
seconds
The total number of seconds.
minutes
The total number of minutes.
hours
The total number of hours.
Overriding Plugin Settings
If you create a config file in your config
folder called read-time.php
, you can override the plugin’s settings in the Control Panel. Since that config file is fully multi-environment aware, this is a handy way to have different settings across multiple environments.
Here’s what that config file might look like along with a list of all of the possible values you can override.
Roadmap
Some things to do, and ideas for potential features:
Brought to you by Luke Youell