Download the PHP package realodix/readtime without Composer
On this page you can find all versions of the php package realodix/readtime. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download realodix/readtime
More information about realodix/readtime
Files in realodix/readtime
Package readtime
Short Description Medium's like reading time estimation.
License MIT
Homepage https://github.com/realodix/readtime
Informations about the package readtime
Read time
📚 Medium's like reading time estimation, based on Medium's read time formula.
Sites like Medium.com have popularized the concept of giving users an estimate for the amount of time it will take them to read the content. With this convenience in mind, ReadTime gives PHP developers the same tool for their readable content. It's a simple feature that will give a nice touch to your PHP application.
Features
- Calculates read time of images in decreasing progression (Example - 12 seconds for the first image, 11 for the second, until images counted at 3 seconds).
- Calculates read time of the Chinese / Japanese / Korean characters separately.
- Removes unwanted html tags to calculate read time more efficiently.
Reference
- help.medium.com/articles/Read-time
- medium.com/blogging-guide/how-is-medium-article-read-time-calculated
Installation
You can install the package via composer:
Quick start
Here is an example of the most basic usage:
You may also pass several arguments to the constructor if you wish to change settings on the fly:
The ReadTime class is able to accept a string of content or a array (flat or multidimensional) of multiple pieces of content. This may come in handy if you are attempting to display the total read time of body content along with sidebar content.
For example:
:exclamation: Named arguments are not covered by Realodix Readtime backwards compatibility guidelines. We may choose to rename function arguments when necessary in order to improve codebase. Therefore, using named arguments when calling methods should be done cautiously and with the understanding that the parameter names may change in the future.
Methods
get()
Retrieve the read time.
setTranslation(array $translations)
Manually set the translation text for the class to use. If no key is passed it will default to the English counterpart. A complete translation array will contain the following:
toArray()
Get the contents and settings of the class as an array.
toJson()
Get the contents and settings of the class as a JSON string.
Variable | Description |
---|---|
duration |
Humanized actualDuration for the input |
actual_duration |
Actual duration of the input (in minutes) |
total_words |
Number of words in the input |
total_words_cjk |
Chinese / Japanese / Korean language characters count |
total_images |
Number of images in input |
word_time |
Read time of the words in the input (in minutes) |
word_time_cjk |
Read time of the Chinese / Japanese / Korean in the input (in minutes) |
image_time |
Read time of the images in the input (in minutes) |
Contributing
Thank you for your interest in ReadTime. Please check out our contributing guide.
License
This package is licensed using the MIT License.
All versions of readtime with dependencies
illuminate/collections Version ^10.0 || ^11.0
symfony/options-resolver Version ^6.1 || ^7.0