Temps de lecture

Prérequis pour automatiser l’affichage

Les squelettes HTML qui affichent la page d’un article doivent inclure un « content/article.html » comme par exemple #INCLURE{fond=content/article,id_article} dans une boucle article et avoir une class css .texte pour le div contenant le texte.

Si vous utilisez le plugin Zcore le plugin Temps de lecture intègre d’office la page « content/article » avec son div.texte ou sinon récupère le 1^er répertoire de votre configuration personnelle des z_blocs de l’array $GLOBALS['z_blocs'] qui pourrait par exemple être main ou contenu.
En ajoutant le plugin compositions, vous pouvez affiner l’insertion du temps de lecture sur certaines pages d’articles, même si la composition d’un article est de type content/article-votre_composition.

Sinon, pour vous passer de ces prérequis, inscrivez le filtre directement dans votre squelette sur la balise #TEXTE (voir Méthode 2).

Deux méthodes possibles

Le plugin propose 2 méthodes pour afficher le temps de lecture :

- Méthode 1

Rien à faire : sauf à respecter les prérequis et activer le plugin qui insère automatiquement le bloc “temps de lecture” sur toutes les pages articles :

• vous pouvez configurer la class (par defaut div.texte) devant laquelle s’insère le bloc “temps de lecture” ;
• et configurer les pages article ayant une composition pour ne pas y afficher le bloc “temps de lecture”.

- Méthode 2

Inscrivez le code d’exemple suivant dans le squelette de votre choix
[Temps de lecture estimé : (#TEXTE|temps_lecture_texte) mn]
dans ce cas pensez à décocher l’insertion automatique dans la configuration.
La fonction du filtre renvoie en chiffre le nombre de minutes pour lire un texte.

Surcharges possibles

Pour modifier le texte vous pouvez créer un fichier lang/temps_lecture_fr.php dans votre repertoire de plugin ou de squelettes et inscrire la nouvelle chaine en respectant le code @temps_lecture@ le code original en français se présente comme ci :

'temps_lecture_estimation' => 'Temps de lecture estimé : @temps_lecture@ mn',

et vous pourriez vouloir le modifier comme ça :

'temps_lecture_estimation' => '@temps_lecture@ minutes pour tout lire !',

Pour modifier le rendu de l’affichage, créez un fichier css/temps_lecture.css dans votre repertoire de plugin ou de squelettes.

Todo

Intégrer différents scripts js au choix dans la config tel le défilement de la page pour le temps de lecture.

Avertissement concernant le forum de cet article

Etant donné la discussion qui a sévit un temps sur ce forum concernant un caractère qui serait digne de la fin du monde, le prochain post concernant ce sujet sera soumis à la communauté pour faire cesser tout harcèlement. Le SAD (Service Après Don) n’est pas là pour servir de défouloir.