Flux WordPress

Introduction Introduction

Un flux est une fonction d’un logiciel spécial qui permet aux lecteurs de flux d’accéder à un site, de rechercher automatiquement du nouveau contenu et des mises à jours, et de les envoyer vers un autre site. Cela permet aux utilisateurs et utilisatrices de se tenir au courant des informations les plus récentes publiées sur différents blogs.

Il existe plusieurs types de flux différents, lus par différents lecteurs de flux. Certains flux comprennent des fichiers RSS (définis alternativement comme « Rich Site Summary » ou « Really Simple Syndication »), Atom ou RDF.

Haut ↑

Flux intégrés à WordPress Flux intégrés à WordPress

Par défaut, WordPress propose différents flux. Les URL de ces flux sont générées par la balise bloginfo() pour chaque type de flux. Ces liens sont généralement listés dans la colonne latérale et/ou le pied de page de la plupart des thèmes WordPress.
Voici comment afficher différents types de flux en PHP :

URL pour les flux RDF/RSS 1.0 :

<?php bloginfo('rdf_url'); ?>

URL pour les flux RSS 0.92 :

<?php bloginfo('rss_url'); ?>

URL pour les flux RSS 2.0 :

<?php bloginfo('rss2_url'); ?>

URL pour les flux Atom : 

<?php bloginfo('atom_url'); ?>

URL pour les flux des commentaires RSS 2.0 :

<?php bloginfo('comments_rss2_url'); ?>

Les quatre premiers flux affichent les dernières publications et mises à jour de votre site pour les différents lecteurs de flux. Parmi ceux-ci, les flux RSS sont les plus connus.
Le dernier flux est utilisé par les lecteurs de flux RSS 2.0 et affiche uniquement les commentaires de votre site.

Pour suivre les commentaire d’une publication spécifique, la balise post_comments_feed_link() est utilisée comme ceci sur les publications uniques :

<?php post_comments_feed_link('RSS 2.0'); ?>

Il existe plusieurs solutions pour modifier ces flux, elles sont abordées dans l’article Personnaliser les flux (en anglais).

Haut ↑

Trouver l’URL de votre flux Trouver l’URL de votre flux

Si vous souhaitez partager l’URL du flux de votre site, ou si vous avez besoin de la soumette à des moteurs de recherche et des annuaires, vous avez à disposition quatre URL possibles pour chacun de vos flux. Chacune d’entre elles fonctionnera :

http://example.com/?feed=rss
http://example.com/?feed=rss2
http://example.com/?feed=rdf
http://example.com/?feed=atom

Si vous utilisez des permaliens personnalisés, vous pourrez les trouver en suivant ce schéma d’URL :

http://example.com/feed/
http://example.com/feed/rss/
http://example.com/feed/rss2/
http://example.com/feed/rdf/
http://example.com/feed/atom/

Commentaires Commentaires

Votre site propose des flux pour tous les commentaires, et chaque publication possède son propre flux de commentaires.

Flux de tous les commentaires Flux de tous les commentaires

Format permalien :

http://example.com/comments/feed/

Format par défaut :

http://example.com/?feed=comments-rss2

Haut ↑

Flux des commentaires pour une publication Flux des commentaires pour une publication

Format permalien :

http://example.com/post-name/feed/

Format par défaut :

http://example.com/?p=33&feed=rss2

Haut ↑

Catégories et étiquettes Catégories et étiquettes

Vous pouvez fournir des flux spécifiques à des catégories ou des étiquettes de votre site en ajoutant les paramètres suivants à la fin de l’URL :

http://www.example.com/?cat=42&feed=rss2
http://www.example.com/?tag=tagname&feed=rss2
http://www.example.com/category/categoryname/feed
http://www.example.com/tag/tagname/feed

Il est possible d’inclure une ou plusieurs catégories ou étiquettes dans un flux en séparant les valeurs par des virgules :

http://www.example.com/?cat=42,43&feed=rss2
http://www.example.com/?tag=tag1,tag2&feed=rss2
http://www.example.com/category/cat1,cat2/feed

Vous pouvez inclure les articles de plusieurs catégories ou étiquettes dans un flux en les ajoutant à la fin de l’URL :

http://www.example.com/category/cat1/category/cat2/feed
http://www.example.com/tag/tag1/tag/tag2/feed

Vous pouvez exclure une catégorie d’un flux en précédent son identifiant d’un tiret :

http://www.example.com/?cat=-123&feed=rss2

Dans des versions plus anciennes de WordPress, il était possible d’inclure des catégories en utilisant des arguments sur une page PHP de flux, mais cela a été déprécié sur les nouvelles versions :

http://example.com/wp-rss2.php?cat=42

Haut ↑

Auteurs Auteurs

Chaque auteur ou autrice possède son propre flux, sous ce format d’URL :

http://example.com/author/authorname/feed/

Haut ↑

Résultats de recherche Résultats de recherche

Les résultats de recherche peuvent également avoir un flux, voici le format :

http://example.com/?s=searchterm&feed=rss2

Haut ↑

Afficher des flux Afficher des flux

Tous les thèmes n’affichent pas tous les types de flux RSS qui sont disponibles avec WordPress. Pour ajouter un nouveau flux à votre site, trouvez l’endroit où sont affichés les flux, le plus souvent dans les fichiers modèles sidebar.php ou footer.php de votre thème. Si ce n’est pas déjà fait, créez un thème enfant, et copiez à l’intérieur de ce dernier le fichier concerné pour pouvoir y ajouter les URL des flux :

<ul class="feeds">
    <li><a href="<?php bloginfo('rss2_url'); ?>"><?php _e( 'Lien du flux RSS' ); ?></a></li>
    <li><a href="<?php bloginfo('atom_url'); ?>"><?php _e('Lien du flux Atom'); ?></a></li>
    <li><a href="<?php bloginfo('comments_rss2_url'); ?>"><?php _e('Lien du flux RSS des commentaires'); ?></a></li>
</ul>

Haut ↑

Ajouter des images aux URL des flux Ajouter des images aux URL des flux

Certaines personnes préféreront afficher des images plutôt que des mots sur les liens de leurs flux. Il existe des standards pour ces images ou boutons, et vous pouvez créer les vôtres pour qu’elles correspondent à la charte graphique de votre site.

Pour ajouter des images sur les liens de vos flux, insérez simplement la balise image à l’intérieur de votre lien. Pensez à ajouter un attribut alt à l’image pour décrire votre lien s’il ne contient pas de texte :

<a href="<?php bloginfo('rss2_url'); ?>"><img src="http://www.mozilla.org/images/feed-icon-14x14.png" alt="Lien du flux RSS"/></a>

Haut ↑

Modifier l’adresse d’un flux Modifier l’adresse d’un flux

Si vous utilisez actuellement un autre outil pour votre blog et que vous en changez pour WordPress, ou que votre blog change d’URL, vous pouvez faire suivre vos lecteurs de flux RSS vers votre nouveau flux en utilisant des réécritures de fichiers et des redirections dans votre fichier .htaccess.

Ouvrez le fichier .htaccess situé à la racine de votre site, ou créez-le s’il n’existe pas.

Voici un exemple pour un flux b2 :

RewriteRule ^b2rss2.php(.*)? /wordpress/?feed=rss2 [QSA]

Voici un exemple pour les utilisateur de MovableType :

RewriteRule ^index.xml(.*)? /wordpress/?feed=rss2 [QSA]

Haut ↑

Format de date et d’heure des flux Format de date et d’heure des flux

WordPress adhère aux spécifications du format RSS. Cela veut dire que le format de date et d’heure de votre flux ne suivra pas celui de votre site, comme défini dans ses réglages. C’est la spécification RFC822 qui sera utilisée à la place. Voici à quoi ressemblera une date dans ce format : Sun, 06 Sep 2009 16:10:34 +0000.

À noter que les formats de date et d’heure ne doivent pas être localisés, étant donné que les spécifications RSS se réfèrent à la spécification RFC822 qui spécifie l’anglais par défaut. Cela implique que chaque lecteur de flux RSS doit veiller à traduire l’heure et la date en fonction de son lieu.

Haut ↑

Erreurs des flux dans les navigateurs Erreurs des flux dans les navigateurs

Un flux fournit des données qui sont destinées à être interprétées par un lecteur de flux comme NewsBlur, Liferea ou RSSOwl.

Actuellement, aucun des principaux navigateurs n’a la capacité d’afficher des flux sans l’aide de modules complémentaires ou d’extensions tierces. Les utilisateurs de ces navigateurs liront un message comme « Ce fichier XML ne semble pas avoir d’informations de style associées. L’arborescence des documents est présentée ci-dessous », suivie du flux brut, ou un message plus utile indiquant qu’un module ou une extension de lecteur de flux doit être installée.

Haut ↑

Plus d’informations et de ressources Plus d’informations et de ressources

Traduit par Marie Comet
Relu par Didier Demory, Jb Audras & Jenny Dupuy
Dernière mise à jour le 2 décembre 2020

Contribuer à la documentation en français de WordPress