Ce premier article est destiné à ceux qui veulent installer l’Editeur RSS tel quel. Un deuxième article le complète, plutôt destiné à ceux qui veulent comprendre le script ou l’adapter à leurs besoins spécifiques [2].

Le principe

Ce script PHP utilise la classe easyRSS version 1.5.1 qui propose de lire un fichier de syndication mais aussi de pouvoir éditer un fichier RSS pour votre site. Cette version utilise le format RSS 0.91.

Malheureusement, je trouve peu convivial l’exemple donné avec les fichiers d’origine pour réaliser un fichier de syndication. Il faut en effet aller dans le code du script pour rentrer les informations, ce qui n’est pas simple pour tout le monde pour créer le fichier et encore moins pour s’y retrouver quand on le met à jour. J’ai donc cherché à réaliser une interface plus facile à utiliser, en m’inspirant de RSS Editor.

L’installation

Tout est dans easyRSS.zip (à télécharger en bas de cet article). Une fois décompacté, le dossier comprend les fichiers d’origine de la classe easyRSS plus deux fichiers :

 maker.php qui présentera l’interface pour réaliser votre fichier RSS,

 et aide.html qui peut être lancé à partir du fichier précédent pour expliquer les différents éléments.

Le plus simple est d’installer ce dossier complet à la racine de votre site [3]. Il faut ensuite protéger le dossier easyRSS par un fichier .htaccess afin que seules les personnes autorisées puissent accéder à maker.php, sinon n’importe qui peut remplacer votre fichier RSS, voyez pour cela l’article Contrôler l’accès d’une partie du site avec .htaccess.

L’interface

Après installation, ouvrez dans votre navigateur le fichier maker.php. Vous voyez en haut de la page :

Le titre reprend l’idée de "flux RSS", car cet éditeur n’est pas seulement fait pour créer ponctuellement un fichier de syndication, mais aussi pour pouvoir le mettre à jour facilement et rendre compte des nouveautés du site. Et voici le bas de la page :

Toute la page n’est pas montrée ici, mais les différents items se présentent de la même façon : des champs à remplir et un bouton d’envoi, pas besoin de se perdre dans le code pour créer ou mettre à jour son fichier de syndication.

L’utilisation

1) Création d’un fichier de syndication :

Commencez par remplir les champs de Channel sommaire (Title, Link et Description sont obligatoires) et de Channel Image (Image c’est pour mettre le logo du site, cet élément est facultatif, mais si vous le mettez, vous devez mettre URL et Link, par contre Width, Height et Description sont facultatifs) :

Ensuite, vous remplissez les Items, un pour chaque page récente de votre site, le format RSS 0.91 limite à 15 items, mais vous n’êtes pas obligé de les utiliser tous. Title et Link sont des éléments obligatoires, Date, Author et Description sont des éléments facultatifs.

Quand toutes les informations sont saisies, vous cliquez sur le bouton "Construire RSS" et votre fichier est créé, il s’appelle "backend.rss" et est à la racine de votre site.

2) Mise à jour d’un fichier RSS :

Tappez l’URL du fichier de syndication que vous voulez mettre à jour dans le champ "RSS URL", cliquez sur "Chercher RSS", et regardez la page. Les différents champs de "Channel Sommaire", "Channel Image" et "Items" se sont remplis des informations récupérées dans le fichier.

Vous pouvez maintenant utiliser les champs de "Nouvel Item 1" et "Nouvel Item 2" pour saisir les informations sur le ou les 2 derniers articles.

Cliquez ensuite sur le bouton "Construire RSS" et votre fichier "backend.rss" à la racine de votre site est remplacé par une nouvelle version. Ce nouveau fichier présentera le (ou les) nouveau(x) item(s) en début de liste. La liste est toujours au maximum de 15 items, si vous les aviez déjà, les derniers seront supprimés. Voilà, c’est tout, sauf si vous aviez 3 ou 4 articles récents, comme il n’y a que 2 nouveaux items, il faut recommencer l’opération pour le 3e et le 4e article.

Pour les explications sur le script, la suite dans un second article.