ARA, éditeur de flux RSS
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.
Téléchargement et 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.
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.
Une fois votre flux RSS créé, vous pouvez l'afficher avec les pages de démonstration du lecteur RSS.
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.5 - 28 avril 2014
Résolu un problème qui peut survenir quand la page de contient pas de balise description. - 3.4 - Avril 2014
Problèmes de compatibilité résolus.
Effacement des champs d'édition corrigé. - 3.3 - Décembre 2013
Révisé le code pour compatibilité avec les versions récentes de PHP. - 3.2 - Octobre 2011
Le programme a été modernisé pour s'adapter aux dernière versions de PHP. Des problèmes de login ont été résolus.
Une commande de logout a été ajoutée. - 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.
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.
Réalisé par Denis Sureau.
Comment se loguer ?
pfouchier
Bonjour, Sans doute tout bête mais je ne trouve pas où me loguer à nouveau pour modifier mes pages RSS. Merci
pfouchier
j'ai installé Ara RSS avec [url]https://www.scriptol.fr/ara/install.php[/url]. Au début de la procédure, j'ai entré un login et un MP puis effacé le fichier install.ph. Ensuite j'ai créé mes flux en allant jusqu'au bout de la procédure. Une fois terminé, je me suis aperçu qu'aucun fichier n'avait été généré à la racine de mon site. Mais j'avais déjà fermé le logiciel Ara... Comment faire pour se loguer à nouveau sur Ara et refaire la procédure ? Cordialement
webmaster
Tapez "install.php" dans la barre d'URL avec le nom du sous-répertoire. Il vous demande le login et le mot de passe au démarrage. Si le fichier a été effacé, mettez-le en ligne de nouveau.
Problème pour effectuer l'installation d'ARA
alberto
webmaster
alberto
Suite du forum...