Les standards à suivre pour la construction de vos flux RSS

À quoi servent les flux RSS

Mediego utilise les flux RSS, des fichiers XML, pour récupérer automatiquement les contenus des éditeurs. Ces flux permettent de collecter des articles, journaux, vidéos et autres contenus, afin de les trier et de les afficher automatiquement ou de manière éditorialisée par les journalistes directement dans les newsletters.

Quels sont les standards à respecter par un flux RSS ?

Un flux RSS doit respecter certaines normes pour être valide et fonctionnel. Voici les éléments essentiels :

Balise racine <rss> : Doit inclure l'attribut version, généralement 2.0.
Balise <channel> : Contiens les métadonnées du flux. Les éléments qu'elle contient sont purement informatifs pour Mediego, vous pouvez y mettre tout ce que vous voulez.
- <title> : Titre du flux.
- <link> : URL du site web.
- <description> : Description du flux.
Balise <item> : Contiens les informations sur chaque contenus (article, vidéo, podcast, etc.).
- <title> : Titre de l'article.
- <link> : URL de l'article.
- <description> : Description de l'article.
- <guid> : Identifiant unique pour l'article.
- <enclosure> : Contient les informations sur l'image associée à l'article. Si la taille de l'image (length) ou son type (type) ne sont pas renseignés, il est préférable de ne pas inclure ces attributs. Cependant, l'URL de l'image est obligatoire.

Nous autorisons l’ajout de propriétés pour enrichir les données, mais la structure globale doit être respectée.

Exemple de flux conforme aux standards

Voici un exemple de flux RSS conforme aux standards contenant plusieurs articles :

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
  <channel>
  <title>Exemple de flux RSS</title>
  <link>http://www.exemple.com</link>
  <description>Ce flux contient les dernières mises à jour du site Exemple</description>
    <item>
      <title>Titre de l'article 1</title>
      <link>http://www.exemple.com/article1</link>
      <description>Description de l'article 1</description>
      <guid>http://www.exemple.com/article1</guid>
      <enclosure url="http://www.exemple.com/image1.jpg" length="12345" type="image/jpeg" />
    </item>
    <item>
      <title>Titre de l'article 2</title>
      <link>http://www.exemple.com/article2</link>
      <description>Description de l'article 2</description>
      <guid>http://www.exemple.com/article2</guid>
      <enclosure url="http://www.exemple.com/image2.jpg" />
    </item>
    <item> 
      <title>Titre de l'article 3</title>
      <link>http://www.exemple.com/article3</link>
      <description>Description de l'article 3</description>
      <guid>http://www.exemple.com/article3</guid>
      <enclosure url="http://www.exemple.com/image3.jpg" type="image/jpeg"/>
    </item>
  </channel>
  </rss>

Les métadonnées utiles pour Mediego

<title> : Indique le titre du flux ou de l'article, essentiel pour identifier rapidement le contenu.
<link> : Fournit l'URL directe vers le site ou l'article, permettant un accès facile.
<description> : Offre un résumé du contenu, aidant les utilisateurs à décider s'ils souhaitent lire l'article complet.
<language> : Spécifie la langue du contenu, utile pour les agrégateurs multilingues.
<pubDate> : Indique la date de publication, permettant de trier les articles par date.
<lastBuildDate> : Date de la dernière mise à jour du flux, utile pour les agrégateurs pour vérifier les nouvelles mises à jour.
<guid> : Identifiant unique global pour l'article, permettant de le distinguer de manière fiable des autres articles, même s'ils ont des titres similaires.
<enclosure> : Contient les informations sur l'image associée à l'article. L'URL de l'image est obligatoire, mais les attributs length (taille de l'image) et type (type de l'image) sont optionnels et ne doivent être inclus que si ces informations sont disponibles.
<premium> : Pour déclencher l'affichage d'un picto indiquant qu'un article est payant, Mediego peut utiliser la métadonnée <premium> (vous pouvez la nommer autrement). Mediego se base uniquement sur l'existence de cette métadonnée, et non sur la valeur renseignée, pour afficher le picto. Il est donc nécessaire d'inclure cette métadonnée dans les articles payants afin de déclencher l'affichage du picto correspondant et de ne pas l'inclure pour les articles gratuits.

Formats de date supportés par Mediego

Mediego supporte actuellement les formats de date suivants :

ISOOFFSETDATE_TIME : 2011-12-03T10:15:30+01:00
RFC1123DATE_TIME : Tue, 3 Jun 2008 11:05:30 GMT
ISOZONEDDATE_TIME : 2011-12-03T10:15:30+01:00[Europe/Paris]
ISOLOCALDATE_TIME : 2011-12-03T10:15:30
"yyyy-MM-dd HH:mm:ss" : 2023-09-13 16:00:00

Si un de ces formats n’est pas utilisé, nous risquons de ne pas pouvoir trier les contenus par récence dans les newsletters.

Remarques importantes

Les balises de texte susceptibles d'être utilisées dans la newsletter, comme <title> et <description>, ne doivent pas contenir de HTML. Sinon, le HTML sera affiché dans la newsletter puisqu'il ne sera pas interprété.
Ces standards permettent de trier les contenus dans les groupes d'articles et de les présenter de manière claire dans les newsletters.
Vous pouvez tester le flux sur validator.w3.org/feed avant de suivre les étapes détaillées dans l'article ajout et utilisation des flux pour l’intégrer sur Mediego.