Quelle version de RSS choisir ?
Je vous recommande le RSS 2.0 pour plusieurs raisons. D'une part, ce format est stable alors que la spécification des autres versions de RSS change. Ce format est simple (la syntaxe est plus lisible que les autres formats tels que RDF, et est bien reconnu et permet surtout de spécifier diverses options (comme le délai de rafraichissement).
Un exemple de flux RSS simple
Un flux RSS est en réalité un fichier au format XML, avec une structure particulière.
Voici un exemple de flux RSS :
<?xml version="1.0" encoding="ISO-8859-1"?>
<rss version="2.0">
<channel>
<title>Mon site web</title>
<link>http://monsiteweb.com</link>
<description>Les news de mon site web</description>
<item>
<title>Un site web pour partager ses signets</title>
<link>http://del.icio.us</link>
<guid isPermaLink="true">http://del.icio.us</guid>
<description>Le site http://del.icio.us permet de partager vos signets et d'y accéder où que vous soyez.</description>
<pubDate>Tue, 16 Jan 2007 19:30:00 GMT</pubDate>
</item>
<item>
<title>Enfin un flux RSS !</title>
<link>http://monsiteweb.com/rss.html</link>
<guid isPermaLink="true">http://monsiteweb.com/rss.html</guid>
<description>Un flux RSS a été installé sur mon site. Vous pouvez le consulter avec votre logiciel favori.</description>
<pubDate>Tue, 16 Jan 2007 19:30:00 GMT</pubDate>
</item>
</channel>
</rss>
Placez ce fichier sur votre site : Il ne faut rien de plus !
En bleu, les informations sur le flux lui-même :
<title> : titre du flux (ou le nom du site web).
<link> : lien vers le site web.
<description> : description du flux.
En rouge, chacune des informations :
<title> : titre de l'information.
<link> : lien vers la page web correspondante.
<guid> : identifiant unique de votre information.
<description> : texte descriptif ou résumé de l'information.
<pubDate> : date de cette information.
Veillez respecter l'ordre d'imbrication des balises <channel> <item> <title> etc.
Important : N'oubliez pas d'indiquer l'encoding que vous avez utilisé dans votre fichier texte. Si vous êtes sous Windows, vous avez probablement utilisé l'ISO-8859-1. Il faut alors l'indiquer dans le fichier (voir encoding=... dans la balise <?xml ...>).
Comment publier un flux RSS ?
Créez et enregistrez votre document XML, puis déposez-le sur votre site web (via un logiciel de transfert FTP) et enfin, rendez visible l'URL de ce fichier.
Vous pouvez mettre le lien sur le logo ci-dessous sur votre page d'acceuil.
Vous pouvez également donner ce lien à des annuaires de flux (
NewsIsFree.com par exemple).
Une autre méthode consiste à insérrer le code suivant entre les balises <head> et </head>
<link rel="alternate" type="application/rss+xml" title="Mon site web" href="http://monsiteweb.com/monfluxrss.xml" />
Le flux est automatiquement détecté et le logo s'affichera dans la barre d'adresse du navigateur du visiteur.
Comment ajouter de nouvelles informations à mon flux ?
Il vous suffit d'ajouter un nouvel <item> (en vert ci-dessous) devant les autres :
<?xml version="1.0" encoding="ISO-8859-1"?>
<rss version="2.0">
<channel>
<title>Mon site web</title>
<link>http://monsiteweb.com</link>
<description>Les news de mon site web</description>
<item>
<title>Sale temps !</title>
<link>http://weather.com</link>
<guid isPermaLink="False">Le temps qu'il fait</guid>
<description>Il ne fait vraiment pas beau aujourd'hui.</description>
<pubDate>Tue, 9 Aug 2005 16:20:00 GMT</pubDate>
</item>
<item>
<title>Un site web pour partager ses signets</title>
<link>http://del.icio.us</link>
<guid isPermaLink="true">http://del.icio.us</guid>
<description>Le site http://del.icio.us permet de partager vos signets et d'y accéder où que vous soyez.</description>
<pubDate>Wed, 5 Aug 2005 19:30:00 GMT</pubDate>
</item>
<item>
<title>Enfin un flux RSS !</title>
<link>http://monsiteweb.com/rss.html</link>
<guid isPermaLink="true">http://monsiteweb.com/rss.html</guid>
<description>Un flux RSS a été installé sur mon site. Vous pouvez le consulter avec votre logiciel favori.</description>
<pubDate>Wed, 3 Aug 2005 15:17:00 GMT</pubDate>
</item>
</channel>
</rss>
Le formatage des dates
C'est le standard RFC822. La date est au format anglophone.
Un exemple :
Wed, 5 Aug 2005 19:30:00 GMT
Elle est notable sous la forme :
D, j M Y H:i:s GMT (voir tableau ci-dessous).
| Caractères pour le paramètre format |
Description |
Exemple de valeurs retournées |
| Jour |
--- |
--- |
| d |
Jour du mois, sur deux chiffres (avec un zéro initial) |
01 à 31 |
| D |
Jour de la semaine, en trois lettres (et en anglais) |
Mon à Sun |
| j |
Jour du mois sans les zéros initiaux |
1 à 31 |
| l ('L' minuscule) |
Jour de la semaine, textuel, version longue, en anglais |
Sunday à Saturday |
| N |
Représentation numérique ISO-8601 du jour de la semaine (ajouté en PHP 5.1.0) |
1 (pour Lundi) à 7 (pour Dimanche) |
| S |
Suffixe ordinal d'un nombre pour le jour du mois, en anglais, sur deux lettres |
st, nd, rd ou th. Fonctionne bien avec j |
| w |
Jour de la semaine au format numérique |
0 (pour dimanche) à 6 (pour samedi) |
| z |
Jour de l'année |
0 à 366 |
| Semaine |
--- |
--- |
| W |
Numéro de semaine dans l'année ISO-8601, les semaines commencent le lundi (ajouté en PHP 4.1.0) |
Exemple : 42 (la 42ème semaine de l'année) |
| Mois |
--- |
--- |
| F |
Mois, textuel, version longue; en anglais, comme January ou December |
January à December |
| m |
Mois au format numérique, avec zéros initiaux |
01 à 12 |
| M |
Mois, en trois lettres, en anglais |
Jan à Dec |
| n |
Mois sans les zéros initiaux |
1 à 12 |
| t |
Nombre de jours dans le mois |
28 à 31 |
| Année |
--- |
--- |
| L |
Est ce que l'année est bissextile |
1 si bissextile, 0 sinon. |
| o |
L'année ISO-8601. C'est la même valeur que Y, excepté que si le numéro de la semaine ISO (W) appartient à l'année précédente ou suivante, cette année sera utilisé à la place. (ajouté en PHP 5.1.0) |
Exemples : 1999 ou 2003 |
| Y |
Année sur 4 chiffres |
Exemples : 1999 ou 2003 |
| y |
Année sur 2 chiffres |
Exemples : 99 ou 03 |
| Heure |
--- |
--- |
| a |
Ante meridiem et Post meridiem en minuscules |
am ou pm |
| A |
Ante meridiem et Post meridiem en majuscules |
AM ou PM |
| B |
Heure Internet Swatch |
000 à 999 |
| g |
Heure, au format 12h, sans les zéros initiaux |
1 à 12 |
| G |
Heure, au format 24h, sans les zéros initiaux |
0 à 23 |
| h |
Heure, au format 12h, avec les zéros initiaux |
01 à 12 |
| H |
Heure, au format 24h, avec les zéros initiaux |
00 à 23 |
| i |
Minutes avec les zéros initiaux |
00 à 59 |
| s |
Secondes, avec zéros initiaux |
00 à 59 |
| Fuseau horaire |
--- |
--- |
| e |
L'identifiant du fuseau horaire (ajouté en PHP 5.1.0) |
Exemples : UTC, GMT, Atlantic/Azores |
| I (i majuscule) |
L'heure d'été est activée ou pas |
1 si oui, 0 sinon. |
| O |
Différence d'heures avec l'heure de Greenwich (GMT), exprimée en heures |
Exemple : +0200 |
| P |
Différence avec l'heure Greenwich (GMT) avec un deux-points entre les heures et les minutes (ajouté dans PHP 5.1.3) |
Exemple : +02:00 |
| T |
Fuseau horaire du serveur |
Exemples : EST, MDT ... |
| Z |
Décalage horaire en secondes. Le décalage des zones à l'ouest de la zone UTC est négative, et à l'est, il est positif. |
-43200 à 43200 |
| Date et Heure complète |
--- |
--- |
| c |
Date au format ISO 8601 (ajouté en PHP 5) |
2004-02-12T15:19:21+00:00 |
| r |
Format de date RFC 2822 |
Exemple : Thu, 21 Dec 2000 16:01:07 +0200 |
| U |
Secondes depuis l'époque Unix (1er Janvier 1970, 0h00 00s GMT) |
Voir aussi time() |
Vérifier si mon flux est correct
Il est important de vérifier si le format de votre flux est correct car il risque, s'il ne l'est pas, de ne pas s'afficher correctement dans les différents agrégateurs de flux.
Utilisez le site web suivant:
http://feedvalidator.org/ ou
http://validator.w3.org/feed/.
Enfin, pour voir ce que ça donne, utilisez un agrégateur de flux et indiquez-lui l'URL de votre fichier. Je vous recommande de tester vos flux avec plusieurs agrégateurs.
United States
