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.

  1. 0 interface

    aucune page d’administration à maintenir

  2. 0 fichier

    aucun CSS ni JavaScript chargé sur le site public

  3. PHP direct

    un appel de fonction dans le thème

  4. 6.0+ / 8.1+

    versions minimales de WordPress et de PHP

  5. 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ée
integer
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