Plugin WordPress · v2.0.0
Le temps de lecture d’un article, affiché avant la première ligne.
CINQ Reading Time compte les mots d’un article, estime sa durée de lecture et la stocke avec le post. Votre thème l’affiche comme il veut.
WordPress 6.0+ · PHP 8.1+ · MU-plugin ou classique · Open source
Avant / après
Savoir combien de temps ça prend, avant de commencer.
Sans indication, le lecteur découvre la longueur en lisant. Avec CINQ Reading Time, la durée s’affiche dès le titre.
avant
-
Avant : On ouvre l’article sans savoir sa longueur. -
Avant : ? min -
Avant : Aucune durée affichée : la longueur se découvre en faisant défiler la page.
après
- Après : On lit la durée, puis l’article.
- Après : 4 min
- Après : La durée s’affiche avant la première ligne, arrondie à la minute supérieure.
3 temps
Un calcul court, une donnée durable.
À chaque sauvegarde, l’estimation est recalculée. Si la méta manque, le plugin repart du contenu du post.
Compter les mots
Le contenu du post est nettoyé puis compté, sans dépendance externe.
Estimer à 200 mots/min
La durée est arrondie à la minute supérieure. Le rythme se change par un filtre.
Stocker le résultat
La durée calculée est enregistrée dans une méta privée du post, lisible depuis le thème.
Recalcul automatique à chaque sauvegarde
Repli sur post_content
Le thème garde la main
3 façons d’afficher la même durée.
Carte éditoriale, en-tête d’article ou liste de ressources : la fonction renvoie un nombre de minutes, votre thème choisit l’affichage.
Volontairement peu de choses
Aucun réglage à maintenir pour afficher un nombre.
-
0 interface
aucune page d’administration à maintenir
-
0 fichier
aucun CSS ni JavaScript chargé sur le site public
-
PHP direct
un appel de fonction dans le thème
-
6.0+ / 8.1+
versions minimales de WordPress et de PHP
-
Périmètre par défaut : post type: post
Élargissable à d’autres types de contenu par un filtre.
Pour les développeurs
Une seule fonction
Copier. Appeler. Formater.
La fonction renvoie un entier : la durée en minutes du post courant. Passez-lui un ID pour obtenir celle d’un autre post.
Valeur renvoyéeinteger
0 si le post est vide, 1 au minimum
Installer et appeler
cp cinq-wp-reading-time.php /path/to/wp-content/mu-plugins/
$minutes = cinq_wp_reading_time();
$minutes = cinq_wp_reading_time( 42 );
Fonctionne aussi comme plugin classique dans wp-content/plugins/.
Afficher dans le thème
if ( function_exists( 'cinq_wp_reading_time' ) ) {
$minutes = cinq_wp_reading_time();
if ( $minutes > 0 ) {
printf( esc_html__( '%d min read', 'cinq-wp-reading-time' ), $minutes );
}
}
Le thème vérifie que la fonction existe, récupère la durée, puis applique sa propre traduction et son propre balisage.
2 filtres WordPress
Adapter le périmètre. Ajuster le rythme.
Par défaut, le calcul porte sur les articles, à 200 mots par minute. Pour changer l’un ou l’autre, le plugin expose 2 filtres WordPress.
Périmètre
Ajouter les guides
défaut: post
add_filter( 'cinq_wp_reading_time_post_types', function () {
return array( 'post', 'guide' );
} );
Le calcul et la sauvegarde s’appliquent alors aux articles et au type de contenu personnalisé guide.
Rythme
Passer à 180 mots/min
défaut: 200
add_filter( 'cinq_wp_reading_time_wpm', function () {
return 180;
} );
Un rythme plus lent pour les contenus denses, sans modifier le plugin ni ajouter d’option en base.
Les détails utiles
Ce qu’il faut savoir avant de l’installer.
agencecinq/cinq-wp-reading-time · Version 2.0.0
Où vit la valeur ?
Dans la méta privée _cinq_reading_time, attachée au post.
Et si elle manque ?
Le plugin recalcule la durée depuis post_content au moment de l’affichage.
Comment l’installer ?
En must-use plugin pour l’activer partout, ou comme plugin classique.
Où sont les options ?
Il n’y en a pas : ni page d’administration, ni option, ni shortcode.
Vous voulez ce niveau de détail sur tout votre site ?
CINQ construit et accompagne des sites WordPress et Shopify. Le premier échange dure 30 minutes et vous dit si on peut vous aider.
Réserver 30 minutes