Servir des flux RSS pour tout ou partie du site

• Générer automatiquement un fichier RSS, du JdN?.
• La classe PhP easyRSS [fr], permettant de générer, mais aussi de lire simplement des flux RSS 0.91.
  • Cette bibliothèque est minimale et gère avec simplicité la production comme la lecture de flux RSS 0.91. Son parsage est effectué à l'aide des expressions rationnelles, aussi ne requière-t-elle aucune configuration spéciale et est susceptible de fonctionner sur toute installation de PhP. (Je l'ai testée avec succès avec Wikini sur EasyPhp -- CharlesNepote.). Le seul endroit où cette bibliothèque semble encore téléchargeable est ici.
• MagpieRSS [en] fournit un parseur RSS en PhP fondé sur expat (compatible 0.9x-1.0).
  • Cette bibliothèque est très riche, acceptant toute version de flux RSS (hors 2.0), gérant les erreurs, etc. Elle est en outre simple à employer et rapidemment opérationnelle, pour peu que la configuration de PhP intègre les prérequis (qui sont par ailleurs mal documentés). Cette bibliothèque ne fonctionne pas, par exemple, avec EasyPhp.
• Building a Generic RSS Class With PHP [en], par Mitchell Harper.
• Quelques classes php gérant RSS [en]. [Il est regrettable que l'inscription à www.phpclasses.org soit obligatoire pour accéder au source de ces classes -- DavidDelon?]
• Qu'est-ce que RSS ? [en] : description de RSS et de ses différentes versions.
• Spécification officielle de RSS 1.0 [en].
• RSS Validator [en].
• Un introduction simple en français [fr].
• RSS 1.0 disponible [fr].
• Flash RSS [fr].
• rss2email, rss to email aggregator [en]
• Ici même, voir les LecteursdeFilsRSS.

Générer un fil RSS

• est exploitable par tout lecteur sachant lire le format RSS version 0.91 (le plus répandu)
• est strictement respectueuse du standard RSS ; le fil est reconnu comme valide :

• peut être mise en oeuvre dans n'importe quelle page à l'aide de l'action "recentchangesrss"
• est paramétrable afin de référencer l'adresse de la page des derniers changements
• si la page des derniers changements en référence n'existe pas, un contenu vide est alors retourné
• masque les aspects techniques

Suggestion d'amélioration fonctionnelle

• Si la page des derniers changements en référence n'existe pas, un contenu vide est alors retourné : il faut peut etre décider de retourner quelquechose dans ce cas là -- DavidDelon?
• On peut peut-être ajouter une icône orange "XML" (comme dans WakkaWiki?) dans les DerniersChangements ? -- CharlesNepote [Pourquoi pas ? -- DavidDelon?]
• Il faut peut-être aussi jeter un coup d'oeil la technique de "l'auto-découverte RSS?" décrite ici et là -- CharlesNepote. [C'est interessant, facile à rajouter dans le footer par exemple -- DavidDelon?]
• Est-ce qu'on pourrait mettre l'adresse de la page DerniersChangements au lieu de la page PagePrincipale lors de la création de ce flux RSS ? A chaque fois que je m'abonne à un flux d'une installation de Wikini, je dois changé ce paramètre pour suivre rapidement les trucs qui ont changés.

Réalisation technique

• Par ailleurs, pourquoi avoir choisi un nouvel handler ?
  [ Bonne question : je pouvais créer une page speciale, gérée par le système, et renvoyant systématiquement le flux rss des derniers changements comme par exemple : WikiniRSS?, probleme : risque de conflit avec une page existante.; je ne pouvais pas utiliser le handler show (il retourne un header et footer) ni le handler raw (il ne formate pas le contenu d'une page, ce contenu est destiné à être interprété par un autre WikiNi), le plus logique : créer un nouvel handler spécifique au xml et ainsi garder la modularité de wikini : on peut créer autant d'action que l'on veut pour afficher le flux rss que l'on veut dans la page de son choix -- DavidDelon? ]

• Ce qui me gêne, dans cette solution, c'est que l'utilisateur novice, s'il clique par hasard sur DerniersChangementsRSS?, va se retrouver avec une page à laquelle il ne va rien comprendre... je ne trouve pas ça très "wiki"... En règle général, je pense qu'il faut masquer toute information technique à l'utilisateur (sans valeur ajoutée pour lui). L'idéal, d'un point de vu fonctionnel, serait qu'il visualise une page (DerniersChangementsRSS?/show) qui lui explique comment utiliser un fils RSS.
  D'un point de vu technique :
  

  • soit on supprime toute page contenant recentchangesrss des DerniersChangements ou PagesOrphelines ou autres (ça me paraît pas envisageable) ;
  • soit on fait en sorte que DerniersChangementsRSS?/show n'affiche que du texte en clair et DerniersChangementsRSS?/xml le fil RSS. -- CharlesNepote.

  [ Ca doit être possible, puisque c'est dans show et xml que l'on décide de la méthode d'affichage, show peut appeller le formatage standard, tandis que xml peut appeller un formatage simplifié, il faut donc trouver une notation qui cache une action dans le formatage standard et qui l'appelle dans le formatage simplifié, et qui ne considère que les actions. Une triple accolade { ? -- DavidDelon? ]
  [ Je viens de voir ton exemple dans le BacASable, bonne idée, j'ai donc crée un formatter : action.php, qui ne fait que traiter des actions, il est appellé par le handler xml , resultat ici http://www.wikini.net/wakka.php?wiki=DerniersChangementsRSS/xml et là : DerniersChangementsRSS? -- DavidDelon? ]
  

  Comme je l'ai dit ailleurs, ce fichier pourrait ne faire que trois lignes... oh et puis une seule ça devrait suffire ;-) J'ai testé, ça marche:
  

  echo $text = preg_replace('/(\{\{(.+)\}\})/eU', '$this->Action(\'\\2\')', trim(str_replace("\r", '', $text)) . "\n");
  

  J'ai viré l'option de recherche /m qui était totalement inutile (aucun détecteur de début ou de fin de chaine dans la regexp) et /s car il ne peut pas y avoir de retour à la ligne dans l'appel d'une action. L'option /e sert à évaluer la partie replacement comme du code PhP, après avoir substitué les références arrières dedans.
  J'imagine que maintenant on peut aussi virer le echo qu'il y a là... (s'il y a bien un truc que je n'aime pas du tout dans WikiNi, c'est l'utilisation intensive des fonctions ob...) -- LordFarquaad?

• Enfin, le rendu dans un navigateur n'est pas satisfaisant. Je sais que ça n'est pas le but, mais les flux RSS de WakaWikki?, par exemple, sont rendus comme des fichiers XML dans InternetExplorer? 5 ou dans MoZilla?. Dans MoZilla?, le "type", donné dans les informations relatives à la page, correspond à "text/xml". "recentchangesrss" produit quant à lui un type "text/html".
  [ Modifié en utilisant l'instruction PhP "header("Content-type: text/xml");" -- DavidDelon? ]
  OK. Ca marche pour MoZilla? et IE 5.0 ; mais du coup, Netscape 4.7 ne le lit plus et propose de le télécharger (ce qui est normal... est-ce génant ?
  [ Ce n'est pas génant à mon avis, vu la politique que nous avons retenu pour NN4.7 -- DavidDelon? ]).
  Pour ce genre de modification, touchant au type du contenu, je suggère de recetter sur un panel de clients le plus large possible : qu'est-ce que ça donne sur Lynx et autres ? -- CharlesNepote.
  [ Testé sur lynx : idem, il propose de le télécharger, à cause de l'encoding gzip qui ne fonctionne qu'avec du Content type text/html (par défaut ? à voir ...), du coup j'ai désactivé, pour le moment, la compression pour le handler xml ... Par contre sur Galeon/linux, Mozilla/linux : pas de problème -- DavidDelon? ]

• Le début du fichier RSS généré contient "<!-- RSS v0.91 generated by Wikini -->" comme dans les flux RSS d'OpenWiki, ce qui permet de visualiser quel outil a généré ce flux. En outre on visualise tout de suite dans MoZilla? la version RSS (0.91), sans passer par l'affichage de la source. -- CharlesNepote

<a href=<?php echo $this->GetConfigValue("base_url") ?>DerniersChangementsRSS"> <img src=
"<?php echo $this->GetConfigValue("image_url") ?>/xml.gif" title="Copiez ce lien et collez le dans votre lecteur de news."> </a> ::

Handler pour produire un fil rss pour l'historique de chaque page

• nom: revisionsrss.php
• exemple : http://www.x-arn.org/w/PagePrincipale/revisionsrss

• dans la fonction SavePage? de wakka.php , rajouter en fin de fonction (vers ligne 245) un : include("update_rss.php");