====== Syndication XML ======
[[DokuWiki]] met en forme les données sous forme de flux XML à l’aide du fichier [[this>feed.php]].
===== Paramètres =====
La façon dont le flux est généré peut être influencée par divers paramètres dans l’URL.
^ Paramètre ^ Valeurs valides ^ Défaut ^ Description ^
| type | rss, rss1, rss2, atom | rss1 | Type de flux utilisé par le Document Type |
| mode | recent, list | recent | Que faut-il exporter? Les modifications récentes ou une liste de documents. |
| num | //un nombre// | [[config:recent]] option | Combien d’éléments doivent être inclus (ignoré en mode liste)|
| ns | //un [[namespace|espace de noms]]// | * | Quel espace de noms doit être exporté |
| linkto | page, rev, diff | diff | Là où les liens doivent pointer |
Exemples
le code : [[this>feed.php?type=rss2&num=5]]
* donne : [[this>feed.php?type=rss2&num=5]] qui retourne un flux [[http://backend.userland.com/rss|RSS 2.0]] des 5 modifications les plus récentes.
le code : [[this>feed.php?mode=list&type=atom&linkto=page&ns=wiki]]
* donne : [[this>feed.php?mode=list&type=atom&linkto=page&ns=wiki]] qui liste toutes les pages dans l’espace des noms "''wiki''" en flux [[http://intertwingly.net/wiki/pie/FrontPage|ATOM 0.3]] avec les liens qui pointent directement sur les pages.
===== Utilisateur/Mot de Passe =====
En activant [[fr:acl|ACL]] l’accès aux pages à visualiser se limite uniquement à l’utilisateur autorisé, n’oubliez pas qu’il est nécessaire de passer au lecteur de flux RSS les arguments utilisateur et mot de passe, comme ceci :
%%''http://example.com/dokuwiki/feed.php?u=username&p=password''%% sinon le lecteur de flux RSS sera incapable d’afficher les modifications récentes ou les documents qui appartiennent à un espace de noms restreint.
===== Générateur de flux =====
La syndication XML est implémentée grâce à l’excellente [[http://www.bitfolge.de/rsscreator-en.html|classe "Feed Creator"]] (anglais) de Kai Blankenhorn.
===== Credits =====
//If you create, translate or modify whole or part of this page, add your name and your email here.//
--- //[[philippe@bdsemin.com|Philippe LAPEYRIE]] 2006-05-22 18:28//