Ara RSS

Logiciel open source sous licence GPL 2.0. Réalisé par Denis Sureau.

ARA est un éditeur de flux RSS semi-automatique. Seuls les liens vers les pages Web doivent lui être donnés. Il se charge de récupérer le titre et la description de la page et de produire un fichier de syndication au format RSS.
Il vous permet de sélectionner les pages à syndiquer au lieu de publier systématiquement les derniers articles comme le font les générateurs inclus dans les gestionnaires de contenu.

Le terme ARA signifie "Atom and RSS API", donc bibliothèque de fonctions Atom et RSS, c'est aussi le nom d'une espèce de perroquet d'Amérique du Sud.

Utilisation

Le programme est un ensemble de scripts en PHP que l'on place sur son site Web.
On créer un flux à partir du navigateur en entrant l'URL de l'interface, ara.php.
Il est plus facile d'utiliser le programme avec deux navigateurs à l'écran, l'un pour sélectionner les pages dont on récupère l'URL dans la barre d'adresse, l'autre pour éditer le fichier RSS. Donc avec un simple copier-coller on transfère l'URL dans le champ de lien de l'interface et on clique sur "add" pour l'ajouter à la liste.
Le bouton EDIT à gauche du lien permet de modifier le titre et la description si l'on veut.
Pour générer le flux, on entre le nom et le chemin du flux en haut (où on peut également taper le nom d'un flux existant pour éditer un flux déja constitué), et on clique sur "Créer le flux RSS" au dessus du bloc d'édition.

Fonctionnement

C'est un script Ajax avec backend en PHP 5. Dans la version présente il ne fonctionne qu'avec les pages du site Web où le script est hébergé.
Il faut être authentifié pour l'utiliser, dans ce but le programme install.php permet de s'attribuer un login et un mot de passe. Ce fichier doit absolument être effacé ensuite. Une fois l'utilisateur enregistré, le programme est utilisable sur la durée de la session, même si on lit d'autres pages entretemps.
Pour générer automatiquement le contenu, le programme charge les pages données dans la liste et lit dans la section head le contenu des balises title et description. Si la première est absente, le premier titre avec balise H1 dans le corps de la page sera utilisé à la place.
De même si la description manque, le texte du synopsis sera pris dans la page à la place.

Documentation

Le manuel ARA décrit le fonctionnement de l'interface et les différentes options, ainsi que l'architecture du programme.
Le manuel a été écrit avec Open Office. Vous pouvez obtenir une version PDF avec la commande export du logiciel.

Téléchargement

Télécharger l'archive au format zip

L'archive comprend l'éditeur et tous les scripts utiles dont le système d'authentification, ainsi que le script Common RSS pour afficher des flux sur des pages Web et le manuel.

Démonstration

Une fois votre flux RSS créé, vous pouvez l'afficher avec la page de démonstration qui utilise le script Common Reader.
La page et le script sont inclus dans l'archive.

En cas de problème, le répertoire ara contient un fichier de logs, ara.log, que vous pouvez charger et afficher avec notepad.

Avertissement

Ara n'est pas un simple éditeur, quand on ajoute une page, il la lit pour y extraire l'information utile et dans ce but il fonctionne en Ajax (avec le framework Anaa), or Ajax ne peut lire de fichiers sur d'autres sites que celui sur lequel il est installé, prenez donc garde, d'autant que le but initial est de construire le flux du site, de ne pas donner d'URL d'autres sites.

Versions

3.0 - Janvier 2010
La date de publication pour le canal est maintenant changée lors de chaque mise à jour du flux.
Editer le canal est maintenant obligatoire avant de créer un flux, pour éviter des champs vides qui empêcheraient de le charger.
Le bouton Show montre maintenant le titre et la description du canal.
Ajouter un bouton Hide pour récupérer l'espace après affichage du canal.
ajax-check.php et ajax-test.php testent le système pour vérifier sa compatibilité.
Les titres sont encodés pour éviter qu'ils soient coupés sur les caractères spéciaux comme les guillemets.
2.1 - Décembre 2009
Encodé les liens pour permettre les URL contenant des paramètres.
2.0 - Juin 2009
Désactivé le cache quand on charge le flux pour l'afficher.
Les descriptions sont coupées sur un point quand c'est possible.
1.9 - Décembre 2008 (Merci aux utilisateurs qui ont révélé des problèmes)
Corrigé le chemin du fichier RSS sur le serveur.
Le format de la date était inapproprié, sauf à partir du formulaire d'édition, il est maintenant en GMT.
1.8 - Octobre 2008
Ajouté la reconnaissance en option de l'adresse IP du webmaster pour éviter d'entrer un login. Le choix d'utiliser l'option est fait lors de l'installation.
1.7 - Septembre 2008
Ajouté l'option "Last at top" qui est cochée par défaut. Cela permet d'ajouter les derniers articles au début de liste façon à avoir un ordre chronologique descendant et pouvoir utiliser directement le flux pour afficher les articles les plus récents.
1.6 - Avril 2008
Corrigé bug date.
On peut définir la taille max de description par la variable DESCRIPTION_MAX.
On peut définir la taille max de tite par la variable TITLE_MAX.
Titre et description sont traités pour remplacer les codes HTML par des lettres avec accents.
1.5 - Décembre 2007
Ajouté le bouton "See RSS feed".
1.4 - Octobre 2007
Affichage du titre du canal avec le bouton "view".
La date par défaut est maintenant la date du jour.
1.3 - Octobre 2007
Meilleure gestion du canal. L'url modifiée est affichée, les antislash sont supprimés.
1.2 - Septembre 2007
Les modifications de titre n'étaient pas affichées après édition. Corrigé.
Les antislash superflus ajoutés par Ajax sont supprimés.
Le fichier RSS se trouve maintenant à la source du site par défaut.
1.1 - Août 2007
Remplacé dans install.php, $login, qui est globale, par $ulogin qui est locale (les globales ne sont pas toujours activées par défaut). Merci à Pablo Javier pour avoir trouvé le bug.
1.0 Août 2007 - Première version.

Futur du logiciel

Plusieurs améliorations au programme sont envisagées:
- génération de fichiers au format Atom.
- possibilité d'utiliser le programme à distance à partir d'un poste local.
- utilisation du programme comme service Web pour des sites différents.

Licence

Le logiciel et tous les scripts qu'il contient sont sous licence GNU GPL 2.0. (Traduction). Vous êtes libre d'utiliser les scripts sur votre site, mais en conservant la notice de copyright contenant le nom de l'auteur et les liens sur le site de l'auteur.