{exp:channel:entries}
tag parameters{exp:channel:entries}
tag which renders the full content of your entry:calculate_reading_time="yes"
If you would like to adjust the words per minute used in the calculation add the wpm
parameter.wpm="150"
(optional, default is 200){exp:channel:entries}
tag. Just like any other custom field added to an ExpressionEngine channel, it will be available with the name you assigned it, and it will display the total seconds of the calculated reading time:{reading_time}
{name_of_your_field_here}
finished_
that will display user friendly text such as in 10 minutes
or less than 1 minute
. You can optionally add a format parameter format="%H:%i:%s"
to change the display of the reading time.{finished_reading_time:relative}
{finished_name_of_your_field_here:relative}
finished_
prefix variables will not work when used inside of a Grid > Relationship field tag, e.g.{grid_field:relationship_field:finished_reading_time}
.{finished_reading_time:relative}
you will need to update or create a local core_lang.php
file to override the default display from ExpresssionEngine.user/language
folder create an english
(or whatever languages your site has) folder with a new file called core_lang.php
, e.g. user/language/english/core_lang.php
. Insert the following code into that file, then it should change how :relative
text is displayed.{exp:channel:entries}
tag to display the total calculated reading time of all entries listed. This only works if the template contains 1 or more {exp:channel:entries}
tags that contain a Reading Time Pro custom field that contain calculated values.{exp:channel:entries}
tag, just use the module tag around your content. Using this tag will not save the calculated reading time to the database, it will be calculatd every page load.reading_time_field
and wpm
parameters are supported, but both are optional when using the module tag. The variables will default to {reading_time}
and {finished_reading_time:relative}
unless otherwise defined.calculate_reading_time="yes"
parameter, will always re-calculate the reading time of an entry and save the value to the custom field. Part of the advantage of using Reading Time Pro is that the calculated reading time is saved to the database for optimal performance, and subsequent views of the entry will not require a re-calculation. Using this option means that a database query will be executed every time the entry is displayed in the {exp:channel:entries}
tag. Generally you would wait for an entry to be saved, which will clear the reading time, or remove the reading time in the module settings page, however, you can use this hidden setting to bypass those two methods of resetting the reading time values.