Ce premier article s’adresse à ceux qui veulent installer cet Editeur tel quel. Un deuxième article le complète pour ceux qui veulent comprendre le script ou l’adapter à leurs besoins spécifiques.

 Le principe

Ce script PHP part de la classe EasyRSS de Philippe Rodier version 1.5.1, mais tous les fichiers ont été modifiés pour obtenir le résultat présenté ici.

Comme pour l’Editeur RSS on garde l’idée d’une interface en ligne, facile à utiliser, avec un formulaire inspiré de RSS Editor.

 Les fichiers réalisés

Ce script réalise en même temps plusieurs fichiers de syndication :

 un fichier au format RSS 0.91, voici un exemple, ce fichier est valide :

 un fichier au format RSS 2.0, voici un exemple, ce fichier est valide :

 un fichier au format Atom 0.3, voici un exemple, ce fichier est valide :

 un fichier au format HTML, voici un exemple, ce type de fichier peut s’afficher directement dans un navigateur ou dans une page Web avec une <iframe> [2]

 un fichier au format Javascript, destiné à l’affichage dans une page Web [3], voici un exemple.

 L’installation

Tout est dans editeur.zip (à télécharger en bas de cet article). Une fois décompacté, le dossier comprend :

 aide.html ce fichier peut être lancé à partir de maker.php pour expliquer les différents éléments,
 easyRSS_maker_2.inc.php c’est la classe EasyRSS modifiée pour réaliser un fichier au format RSS 2.0,
 easyRSS_maker_3.inc.php la classe EasyRSS modifiée pour réaliser un fichier au format Atom 0.3,
 easyRSS_maker_htm.inc.php la classe EasyRSS modifiée pour réaliser un fichier au format HTML,
 easyRSS_maker_js.inc.php la classe EasyRSS modifiée pour réaliser un fichier au format JavaScript,
 easyRSS_maker.inc.php la classe EasyRSS modifiée pour réaliser un fichier au format RSS 0.91,
 easyRSS_reader_2.inc.php la classe EasyRSS 1.5.1 pour lire et récupérer les données d’un fichier de syndication existant, modifiée, c’est pourquoi je lui ai donné un autre nom que le fichier d’origine easyRSS_reader.inc.php,
 maker.php qui présente l’interface en ligne pour réaliser vos fichiers de syndications.

J’ai trouvé plus commode d’avoir un fichier easyRSS_maker... pour chaque document de syndication réalisé, cela facilite la mise au point ou les modifications du code).

Le plus simple est d’installer ce dossier complet à la racine de votre site [4]. 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 vos fichiers de syndication. 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 d’"Editeur de flux", car il n’est pas seulement fait pour créer ponctuellement des fichiers de syndication, mais aussi pour pouvoir les 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 ses fichiers de syndication.

Cette page présente des différences avec l’Editeur RSS 1ère version :

 bien sûr le titre et le bouton d’envoi en bas de page, puisqu’ici, ce n’est pas un mais plusieurs fichiers de syndication qui seront réalisés,
 le champ URL propose par défaut le fichier de syndication du site [5],
 les Items comportent un nouveau sous-élément "Category" que j’utilise pour indiquer à quelle rubrique ce ratache l’article (on peut aussi y noter des mots clefs),
 le champ Webmaster est remplacé par Dc:creator, en effet "Webmaster" exige une adresse email, ce qui n’est pas raisonnable en raison du spam, "Dc:creator" peut permettre d’indiquer le nom du Maître-Toile ou l’adresse de la page contact.

 L’utilisation

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

Comme pour l’Editeur RSS 1ère version, 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, jusqu’à 15 mais vous n’êtes pas obligé de les utiliser tous. Title et Link sont des éléments obligatoires, Date, Author, Category et Description sont des éléments facultatifs.

Quand toutes les informations sont saisies, vous cliquez sur le bouton "Editer les fichiers RSS 0.91 + RSS 2.0 + Atom 0.3 + HTM + JS" et les cinqs fichiers sont créés, ils s’appellent "backend.xml", "rss2.xml", "atom03.xml", "backend.htm", "distrib.php" et sont à 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" si l’adresse proposée par défaut ne vous convient pas [6]. Cliquez sur "Chercher le fichier RSS", et regardez la page :

Un message vous informe que les données sont récupérées. Les différents champs de "Channel Sommaire", "Channel Image" et "Items" se sont remplis des informations provenant de votre 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 "Editer les fichiers RSS 0.91 + RSS 2.0 + Atom 0.3 + HTM + JS" et vos fichiers à la racine de votre site sont remplacés par leur nouvelle version. Les nouveaux fichiers présentent toujours le (ou les) nouveau(x) item(s) en début de liste. La liste est au maximum de 15 items pour les fichiers RSS 0.91, RSS 2.0 et Atom 0.3, et de 10 items pour les fichiers HTML et JavaScript. 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 les scripts, la suite dans un second article.