Retrouvez cet article dans : Linux Pratique 37

Dans un précédent numéro (Linux Pratique n°35), nous découvrions un plugin pour DotClear permettant d'afficher les articles suivants ou précédents de la même catégorie que l'article affiché. Nous en découvrirons ce mois-ci le pendant pour WordPress, tandis que pour DotClear nous apprendrons à configurer un lecteur de flux RSS externes.

Rappel de la procédure d'installation d'un pluginSous DotClear : dans l'outil de gestion des plugins, entrez l'URL du plugin en .pkg.gz dans le formulaire pour l'installer. En cas d'échec, téléchargez la version .zip ou .tar.gz et décompressez-la dans le répertoire ecrire/tools/ de DotClear.
Sous WordPress : après l'avoir décompressé, installez directement le plugin dans le répertoire wp-content/plugins/. Ensuite, rendez-vous dans le module Plugins du panneau d'administration, et activez-le.

Next/Previous Post in same Categorie (plugin Wordpress)

Ce plugin peut être trouvé sur le site de l'auteur : http://www.scriptygoddess.com/archives/2004/07/24/nextprevious-posts-in-same-category/ ou bien sur http://wp-plugins.net/ dans la catégorie " Features " puis " Navigation ". En version 0.2, il permet tout simplement de passer à l'article précédent ou à l'article suivant dans la même catégorie. Il faut dans un premier temps télécharger le fichier http://www.scriptygoddess.com/downloads/nextPreviousCat.txt et l'enregistrer avec une extension .php à la place de l'extension .txt. Une fois ceci fait, vous pouvez utiliser votre client FTP préféré pour l'envoyer dans le répertoire wp-contents/plugins/ de votre blog WordPress.
Rendez-vous ensuite dans l'interface d'administration de WordPress et, dans le menu, choisissez Plugins.

Ce nouveau plugin doit désormais apparaître dans la liste (Fig. 1). Il vous suffit alors de cliquer sur le lien Activer pour qu'il devienne fonctionnel. Il ne vous reste plus qu'à spécifier où ce greffon doit entrer en jeu dans vos pages. Par exemple, pour le faire figurer en fin d'article, avant les commentaires, comme sur la Figure 2, il vous faudra aller dans le menu Présentation, puis dans Éditeur de Thèmes et choisir le fichier article seul pour en modifier le contenu. Juste avant la ligne

<?php comments_template(); ?>

vous pourrez alors recopier les lignes suivantes :

<small>
<?php previous_cat_post($beforeGroup='<p>Articles précédents dans la même catégorie</p>', $afterGroup='', $beforeEach='<p>- ', $afterEach='</p>', $showtitle=false,  $textForEach='Précédent article dans %'); ?>
<?php next_cat_post($afterGroup='<p>Articles suivants dans la même catégorie</p>', $afterGroup='', $beforeEach='<p>- ', $afterEach='</p>', $showtitle=false,  $textForEach='Article suivant dans %'); ?></small>

Bien sûr, lorsqu'un article est le premier ou le dernier de sa catégorie, seuls les liens pertinents sont proposés. Par exemple, pour le premier article de la catégorie, ce code produit le résultat que vous pouvez observer sur la figure 3.

En fait, ce plugin fournit deux fonctions à utiliser : previous_cat_post(); et next_cat_post();
Les paramètres qui suivent peuvent être utilisés avec ces fonctions, comme dans l'exemple précédent :

• $beforeGroup : il s'agit de la chaîne de caractères à afficher avant la liste des catégories et des articles. Par défaut, il s'agit de la chaîne <ul>.
• $afterGroup : il s'agit de la chaîne de caractères à afficher après la liste des catégories et des articles. Par défaut, il s'agit de la chaîne </ul>.
• $beforeEach : il s'agit de la chaîne de caractères à afficher avant chaque catégorie/article. Par défaut, il s'agit de la chaîne <li>.
• $afterEach : il s'agit de la chaîne de caractères à afficher après chaque catégorie/article. Par défaut, il s'agit de la chaîne </li>.
• $showtitle : spécifiez true si vous souhaitez inclure le titre de l'article dans le lien ou false dans le cas contraire. Par défaut, il s'agit de la valeur true.
• $textForEach : il s'agit de la chaîne de caractères à afficher pour chaque ligne. Si $showtitle=false, cette chaîne devient le nom du lien vers l'article. Si $showtitle=true cette chaîne est affichée juste avant le titre-lien représentant l'article. Vous pouvez utiliser % dans la chaîne de caractères ; lors de l'affichage, le % sera remplacé par le nom de la catégorie en question. Par défaut, pour la fonction previous_cat_post(), la chaîne de caractères est Previous post in %:<br />. De même, par défaut pour la fonction next_cat_post(), la chaîne de caractères est Next post in %:<br />.

Lecteur RSS (plugin DotClear)

Vous souhaitez afficher sur votre blog les nouveautés en provenance d'autres blogs ou d'autres sites offrant des flux RSS à leurs visiteurs ? Rien de plus simple grâce au plugin Lecteur RSS. Il est disponible sur le Wiki de Dotclear, dans la rubrique Plugins : http://www.dotclear.net/trac/wiki/DotClear/Plugins et supporte les formats RSS 0.9 et 1.0 (ainsi que 2.0, mais dans une moindre mesure d'après les indications du Wiki). Il est lui-même en version 2.2 à date de rédaction de cet article.
Pour l'installer, il suffit de copier l'URL de l'installeur : http://yffic.cloarec.free.fr/dotclear/plugin-rssreader-2.2.pkg.gz et de la coller dans le Gestionnaire de Plugins de Dotclear, et enfin de cliquer sur le bouton Installer.
Son usage est relativement simple, puisqu'il suffit de copier le code suivant à l'endroit du fichier template.php où vous souhaitez voir apparaître le flux surveillé :

<?php rssreader::dcLectureRSS("URL_RSS_externe", nb, affichage_date, affichage_description); ?>

où vous remplacerez :

• URL_RSS_externe : par l'URL du flux à surveiller, par exemple : http://www.blendernation.com/feed/ pour être tenu au courant des dernières nouvelles de la communauté consacrée à Blender, ou http://www.linuxgraphic.org/backend_actualites.php pour être informé de l'actualité du site Linuxgraphic.
• nb : par le nombre d'entrées (en commençant par les plus récentes) que vous souhaitez afficher ; par défaut, la valeur est de 5.
• affichage_date : pour le flux RSS indiqué, force ou non l'affichage de la date de l'article, quel que soit le réglage correspondant dans l'interface d'administration du plugin (voir ci-après) ; true affiche toujours la date, false ne l'affiche jamais.
• affichage_description : pour le flux RSS indiqué, force ou non l'affichage de la description de l'article, quel que soit le réglage correspondant dans l'interface d'administration du plugin (voir ci-après) ; true affiche toujours la description, false ne l'affiche jamais.

Les deux derniers paramètres sont optionnels, mais si vous en utilisez un, vous devez également utiliser l'autre ou vous rencontrerez dans certains cas des erreurs à l'affichage des flux. Le format d'affichage des flux RSS externes est défini dans l'option Lecteur RSS de l'onglet Outils du panneau d'administration de DotClear (Fig. 4). En cliquant dessus, vous arrivez sur l'interface d'administration du plugin.

Activation du cache du flux RSS : l'activation du cache permet de soulager le serveur hébergeant le blog ; à moins de rencontrer des problèmes spécifiques, il est conseillé de l'activer (option Oui) et de définir sa durée dans le champ Durée du cache, tout en bas de l'interface d'administration. Une valeur recommandée pourrait être de 3600 s, garantissant ainsi à une heure près la " fraîcheur " des flux RSS présentés sans pour autant écrouler le serveur d'hébergement à chaque accès.
L'affichage par défaut prévoit de mettre en évidence la date de l'article pointé par le flux, son titre, et une description de l'article (en fait, le début de celui-ci). Les principaux contrôles en sont les suivants :

• Limite de coupure de la description en nombre de caractères : permet de déterminer la longueur maximale de la description affichée ; par défaut, 160 caractères.
• Date activée : permet d'afficher ou non la date de l'article ; par défaut, Oui.
• Description activée : permet d'afficher ou non la description de l'article, dans la limite du nombre de caractères défini plus haut ; par défaut, Oui.

Bien sûr, vous penserez à enregistrer vos modifications avant de quitter l'interface d'administration pour qu'elles soient prises en compte.

Liens
Liste de plugins pour DotClear : http://www.dotclear.net/trac/wiki/DotClear/Plugins
Liste de plugins pour WordPress : http://wordpress.org/extend/plugins/