Une API RSS en PHP
Ara est une classe PHP pour générer un flux RSS au format RSS 2.0.
Son utilisation est très simple: quelques appels de méthodes pour générer le flux RSS, ajouter un channel, ajouter des articles...
Utilisation
On crée une instance de classe:
$myfeed = new ara();
et l'on associe les propriétés et méthodes à cette instance.
Propriétés de la classe RSS
Elle permettent de contrôler les paramètres du flux RSS. On accède à une propriété par le nom de l'instance.
Par exemple
$myfeed->DESC_SIZE = 500;
DESC_SIZE
Taille de la description. Elle peut varier car la classe essaie de couper la description après un point.
FEED_MAX
Nombre maximal d'items dans le flux.
DESCENDING
Ajouter les articles les derniers au début de façon à ce qu'on puisse voir les plus récents en premier.
Méthodes de ARA
Elles permettent de créer un fichier RSS à partir de données brutes. L'affichage du flux peut être fait avec des scripts comme RSS Reader ou Common Reader.
Constructeur ara()
N'a aucun argument.
ARAFeed(titre, lien, description, date)
Crée un flux et ajoute un channel selon les paramètres passés en argument.
build(url)
Extrait les données du canal dans le fichier donné en argument, normalement la page d'accueil du site, et appelle la méthode ARAFeed.
ARAItem(titre, lien, description, date)
Ajoute un item construit à partir des arguments.
compress(taille = -1)
Réduit le nombre d'item au nombre donnée en paramètre. Si aucun paramètre n'est donné, utilise FEED_MAX.
remove(item)
Supprime un item au format DOMNode utilisé par PHP.
load(nom-fichier)
Charge un fichier RSS et contruit l'arborescence en mémoire sous de DOMDocument.
save(nom-fichier)
Sauve le flux RSS dans un fichier.
saveXML()
Retourne le flux sous forme de chaîne.
getData(url)
Extrait le titre, la description d'une page HTML dont on donne l'URL. Retourne un tableau simple contenant le titre, la description, la date du jour.
La méthode est capable de trouver les informations soit dans les balises métas, soit dans le corps de la page.
Télécharger
Toutes les fonctions de l'API sont accessibles dans le fichier ara-class.php.
Ce fichier est inclu avec l'éditeur RSS ARA ainsi que dans l'outil en ligne Bioloide.
|
|
|