La syndication de contenu : explications
Présentation
Dans le cas qui nous intéresse, la syndication de contenu correspond à la mise à disposition par un éditeur de site web d'une sorte de résumé des dernières mises à jour effectuées sur son site, de façon que d'autres éditeurs puissent intégrer ce résumé sur leur site ou le consulter à l'aide d'un logiciel spécifique (appelé "agrégateur").
Notre blog propose différents flux XML, aux formats RSS et Atom. Le flux principal contient la liste des derniers articles (titre et URL), tandis que le flux secondaire contient les derniers commentaires apportés à nos articles.
Intégration sur votre site
Cet article n'aborde pas la création d'un flux de syndication mais seulement son utilisation.
Si vous souhaitez afficher sur votre site la liste des derniers articles du blog de PR Weaver, il faut utiliser un code qui sache lire le fichier XML. Nous vous proposons d'utiliser un outil en PHP disponible sous licence GPL : il s'agit de MagpieRSS - "a simple RSS integration tool".
Parmi les fonctionnalités de MagpieRSS, citons :
- support des formats RSS v0.91 et v1.0 (et dans une moindre mesure la v2.0)
- support du format Atom
- interface très simple, orientée objet
- code accompagné de nombreux commentaires
Pour l'installer, il suffit de copier le répertoire quelque part sur votre site. Dans cet exemple nous l'avons copié dans un répertoire nommé magpierss situé à la racine du site.
La seule configuration à effectuer se trouve dans le fichier rss_cache.inc dans lequel vous pouvez choisir le répertoire utilisé pour la gestion du cache, et la durée de vie du cache en secondes (si vous mettez 3600, le cache sera recréé si le fichier dans le cache date de plus de 3600 secondes, soit 1h).
Pour l'utiliser, nous vous conseillons de créer une fonction nommée FeedParser() qui sera chargée de formater la liste des derniers éléments des flux à lire. De cette façon, si vous souhaitez changer l'aspect, vous n'aurez qu'à le changer à cet endroit. Voici le code de cette fonction, que nous avons écrit dans le fichier feedparser.php stocké à la racine du site :
<?php
// inclusion de la classe magpierss
require_once("magpierss/rss_fetch.inc");
function FeedParser($url_feed, $nb_items_affiches=5)
{
// lecture du fichier distant (flux XML)
$rss = fetch_rss($url_feed);
// si la lecture s'est bien passee, on lit les elements
if (is_array($rss->items))
{
// on ne recupere que les elements les + recents
$items = array_slice($rss->items, 0, $nb_items_affiches);
// debut de la liste
// (vous pouvez indiquer un style CSS pour la formater)
$html = "<ul>\n";
// boucle sur tous les elements
foreach ($items as $item)
{
$html .= "<li><a href=\"".$item['link']."\">";
$html .= $item['title']."</a></li>\n";
}
$html .= "</ul>\n";
}
// retourne le code HTML a inclure dans la page
return $html;
}
?>
Exemple d'intégration
Pour intégrer une liste à puces contenant les derniers éléments d'un flux XML, il suffit de deux lignes de code.
Dans le cas de notre blog, si vous souhaitez afficher des liens vers les 10 derniers articles du blog, il suffit de mettre ce code sur votre page :
<?php
require_once("feedparser.php");
echo FeedParser("http://www.prweaver.fr/blog/rss.php", 10);
?>
Trop compliqué pour vous ?
Si vous trouvez tout ça trop compliqué, vous pouvez tout simplement recopier sur votre site les articles que vous avez trouvés intéressants, à condition de faire un lien vers notre article et notre blog.
Si vous avez des questions au sujet de la syndication, n'hésitez surtout pas à nous contacter, nous serons ravis de pouvoir vous aider ou clarifier nos explications.
