mirror of
https://github.com/sbrl/Pepperminty-Wiki.git
synced 2024-12-22 13:45:02 +00:00
73 lines
2.9 KiB
PHP
73 lines
2.9 KiB
PHP
<?php
|
|
register_module([
|
|
"name" => "Reading time estimator",
|
|
"version" => "0.1",
|
|
"author" => "Starbeamrainbowlabs",
|
|
"description" => "Displays the approximate reading time for a page beneath it's title.",
|
|
"id" => "feature-readingtime",
|
|
"code" => function() {
|
|
|
|
page_renderer::register_part_preprocessor(function(&$parts) {
|
|
global $env, $settings;
|
|
// Only insert for the view action
|
|
if($env->action !== $settings->readingtime_action || !$settings->readingtime_enabled)
|
|
return;
|
|
|
|
$reading_time = estimate_reading_time(
|
|
file_get_contents($env->page_filename),
|
|
$settings->readingtime_language
|
|
);
|
|
|
|
$insert = "<small><em>{$reading_time[0]} - {$reading_time[1]} minute read</em></small>";
|
|
if($reading_time[0] === $reading_time[1])
|
|
$insert = "<small><em>{$reading_time[0]} minute read</em></small>";
|
|
|
|
// TODO: Create a canonical way to insert something just below the header - this might be tough though 'cause the that isn't handled by the page_renderer though
|
|
$replace_count = 1; // Without a temp variable we get "only variables can be passed by reference", ref PHP 7.4.6
|
|
$parts["{content}"] = str_replace(
|
|
"</h1>", "</h1><p class='system-text-insert readingtime-estimate'>$insert</p>",
|
|
$parts["{content}"],
|
|
$replace_count
|
|
);
|
|
});
|
|
}
|
|
]);
|
|
|
|
/**
|
|
* Estimates the reading time for a given lump of text.
|
|
* Ref https://github.com/sbrl/Pepperminty-Wiki/issues/172 (has snippet of
|
|
* original code from Firefox & link to study from which the numbers are
|
|
* taken).
|
|
* @param string $text The text to estimate for.
|
|
* @param string $lang The language code of the text - defaults to "en"
|
|
* @return array An array in the form [ low_time, high_time ] in minutes
|
|
*/
|
|
function estimate_reading_time(string $text, string $lang = "en") : array {
|
|
$chars_count = mb_strlen($text);
|
|
$langs = [
|
|
"en" => (object) [ "cpm" => 987, "variance" => 118 ],
|
|
"ar" => (object) [ "cpm" => 612, "variance" => 88 ],
|
|
"de" => (object) [ "cpm" => 920, "variance" => 86 ],
|
|
"es" => (object) [ "cpm" => 1025, "variance" => 127 ],
|
|
"fi" => (object) [ "cpm" => 1078, "variance" => 121 ],
|
|
"fr" => (object) [ "cpm" => 998, "variance" => 126 ],
|
|
"he" => (object) [ "cpm" => 833, "variance" => 130 ],
|
|
"it" => (object) [ "cpm" => 950, "variance" => 140 ],
|
|
"jw" => (object) [ "cpm" => 357, "variance" => 56 ],
|
|
"nl" => (object) [ "cpm" => 978, "variance" => 143 ],
|
|
"pl" => (object) [ "cpm" => 916, "variance" => 126 ],
|
|
"pt" => (object) [ "cpm" => 913, "variance" => 145 ],
|
|
"ru" => (object) [ "cpm" => 986, "variance" => 175 ],
|
|
"sk" => (object) [ "cpm" => 885, "variance" => 145 ],
|
|
"sv" => (object) [ "cpm" => 917, "variance" => 156 ],
|
|
"tr" => (object) [ "cpm" => 1054, "variance" => 156 ],
|
|
"zh" => (object) [ "cpm" => 255, "variance" => 29 ],
|
|
];
|
|
if(!isset($langs[$lang]))
|
|
return null;
|
|
|
|
return [
|
|
ceil($chars_count / ($langs[$lang]->cpm + $langs[$lang]->variance)),
|
|
ceil($chars_count / ($langs[$lang]->cpm - $langs[$lang]->variance))
|
|
];
|
|
}
|