Ce premier article suffira pour ceux qui veulent installer et utiliser 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 utilise la classe rss_write de fil_LE de Dominique Wojylac version 2.0ß04 [2].

Comme pour la version précédente de l’Editeur, on garde l’idée d’une interface en ligne, facile à utiliser, avec un formulaire.

 Les fichiers réalisés

Ce script peut réaliser en même temps plusieurs fichiers de syndication [3] :

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

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

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

 L’installation

Tout est dans editeur-rss_write.zip :

editeur-rss_write.zip

Une fois décompacté, le dossier comprend :

 Comparatif_formats.html tableau comparatif des différents formats de flux,
 doc_rss_write.html documentation sur rss_write,
 editeur.php le fichier avec le formulaire en ligne pour la récupération des données et l’édition des fils,
 rss_read.inc.php la classe rss_read pour lire les informations du dernier fil édité,
 rss_write ce dossier comprend :

• rss_w.atom10.php le plugin pour le format Atom 1.0,
• rss_w.functions.php fichier regroupant plusieurs fonctions nécessaires à l’édition des fils,
• rss_w.rdf10.php le plugin pour le format RDF 1.0,
• rss_w.rss20.php le plugin pour le format RSS 2.0,
• rss_write.inc.php la classe rss_write version 2.0ß04.

Le plus simple est d’installer ce dossier complet à la racine de votre site. Il faut ensuite protéger le dossier editeur-rss_write par un fichier .htaccess afin que seules les personnes autorisées puissent accéder à editeur.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 editeur.php. Vous voyez en haut de la page :

Cette interface reprend la présentation avec formulaire des éditeurs précédents [4]. Cette première partie est destinée à récupérer les informations contenues dans la dernière édition du fil. A priori c’est le format RSS 2.0 qui est choisi pour cela car il contient le plus d’informations.

La page se continue ensuite par :

 L’utilisation

En cas de difficulté, on trouve en haut de la page editeur.php un lien vers la documentation de rss_write qui explique tout ce que doit contenir un flux RSS ou Atom.

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

A priori on considère que vous éditez dans chaque format proposé : RSS 2.0, RDF 1.0 et Atom 1.0. Si ce n’est pas ce que vous voulez, décochez le format non désiré. Attention, pour le format Atom 1.0, il faut cocher l’option "URL du flux" et noter l’adresse dans le champ correspondant pour que le fil soit valide.

Par contre, pour les options, il faut cocher les cases souhaitées, les champs correspondants sont alors affichés :

Après le choix des options, il faut ensuite choisir combien vous voulez d’items pour cette première édition du flux, taper le nombre dans la case.

Il ne vous reste plus qu’à remplir les différents champs. A noter que pour les champs comme Description, Auteur, Catégorie, si vous récupérez des éléments dans du code HTML avec des caractères accentués codés (par exemple é pour é, à pour à) vous pouvez les mettre directement dans les champs, le script gère cela très bien [5].

Quand toutes les informations sont saisies, vous cliquez sur le bouton "Générer le(s)flux" et les fils sont créés, ils s’appellent "rss20.xml", "rdf10.xml", "atom10.xml" et sont à la racine de votre site.

2) Mise à jour d’un fichier RSS :

L’URL proposée par défaut doit normalement convenir pour récupérer les informations de l’édition précédente. Cliquez sur "Editer flux distant" vous voyez alors les informations s’afficher, les options présentes dans le flux sont cochées.

A noter si vous utilisez le format Atom 1.0 que l’"URL du flux" n’est pas récupérée, il faut donc cocher cette option et remplir le champ.

Cliquez alors sur "Nouvel Item" et remplissez les champs. Vérifiez ensuite que le nombre d’items correspond à ce que vous souhaitez, si ce nombre est dépassé, cliquez sur "Supprimer Dernier Item" [6]. Puis cliquez sur "Editer flux distant", les fils sont alors mis à jour.

Si vous avez plusieurs nouveaux items, il suffit de répéter les mêmes manœuvres plusieurs fois..

 Essayer cet éditeur

Nous avons installé une page qui permet d’essayer cet éditeur, elle se trouve ici. Pour cette version d’essai, il n’est pas possible d’éditer un fichier, mais vous obtiendrez le code qu’il n’y a plus qu’à mettre par copié-collé pour réaliser votre flux.

 Adaptation du script

On peut vouloir pour les besoins de son site modifier ce script, par exemple, pour :

 ajouter ou supprimer certains formats,
 donner des noms différents aux fils réalisés,
 partir d’un autre fil que RSS 2.0 pour récupérer les données,
 enregistrer les fils à distance sur un autre serveur...

Tout ceci est possible, mais comme il faut faire des modifications dans le code du script, nous verrrons cela dans un deuxième article.