pixelsushirobot / kirby-readingtime

3.0.2 2026-07-12 09:19 UTC

Requires

• php: >=8.0
• getkirby/composer-installer: ^1.2

MIT

• Roy Lodder
• Bastian Allgeier

Published on Packagist.org on 2026-07-12 09:20 UTC

README

Estimates the reading time for any Kirby text field. A modernized fork of the archived getkirby-v2/readingtime-plugin, rewritten for the Kirby 3/4/5 plugin API.

What's different from the original

• Registered via the modern Kirby::plugin() / fieldMethods API (works on Kirby 3, 4 and 5).
• Configurable words-per-minute via a plugin option (default 200).
• KirbyText-aware word count: text is parsed and tag-stripped before counting, so Markdown/KirbyTag syntax isn't counted as words.
• Ships with composer.json and a version constant.

Installation

Manual

Copy the readingtime folder into /site/plugins.

Composer

composer require pixelsushirobot/kirby-readingtime

Usage

<?= $page->text()->readingtime() ?>

Outputs e.g. 4 minute read, or 35 second read for sub-minute content.

Configuration

Set a global words-per-minute in site/config/config.php:

return [
    'pixelsushirobot.readingtime.wpm' => 240
];

Or override per call, along with labels and format:

<?= $page->text()->readingtime([
    'wpm'     => 180,
    'minute'  => 'Minute',
    'minutes' => 'Minuten',
    'second'  => 'Sekunde',
    'seconds' => 'Sekunden',
    'format'  => '{minutesCount} {minutesLabel} – {secondsCount} {secondsLabel}'
]) ?>

Options

Option	Default	Description
wpm	200	Words read per minute
minute / minutes	minute	Singular / plural minute label
second / seconds	second	Singular / plural second label
format	{minutesCount} {minutesLabel} read	Output format
format.alt	{secondsCount} {secondsLabel} read	Format used when under one minute
format.alt.enable	true	Use the alt format for sub-minute content

Credits

Original author: Roy Lodder. Contributor: Bastian Allgeier.

License

MIT