====== Feed Plugin ======
---- plugin ----
description: The Feed Plugin is a helper plugin that generates RSS and Atom feeds for other plugins. (previous authors: Esther Brunner)
author     : Gina Häußge, Michael Klier
email      : dokuwiki@chimeric.de
type       : syntax
lastupdate : 2008-04-19
compatible : >2007-11-06
depends    : blog, editor, tag, tasks
conflicts  : 
similar    : 
tags       : feed, rss, atom, syndicate
----

^  Download | [[http://www.chimeric.de/_src/plugin-feed.tgz|plugin-feed.tgz]] |

==== Syntax ====

  {{[component]feed>[namespace]?[option]}}

^ [component] | plugin component for which the feed is destined | required |
^ [namespace] | the namespace for which you want a discussion thread list; '':'' is the top namespace, ''.'' is the same namespace as the page lies in, ''*'' the whole wiki | required |
^ [option] | depends on plugin / component, see [[#supported feeds]] | mostly optional |

==== Supported Feeds ====

^ Plugin ^ Component ^ Option ^^
| [[Blog]] | ''blog'' | number of blog entries to include in feed \\ \\ :!: **as of DokuWiki 2008-04-11 DokuWiki has it's own full html feed and we recommend to use it instead of this plugin to generate the blog feed. This component will be removed from the plugin a in couple of month from now** :!: \\  --- //[[chi@chimeric.de|Michael Klier]] 2008/04/20 21:20// | optional; default is ''%%$conf['recent']%%'' |
| [[Discussion]] | ''comments'' | number of comments to include in feed | optional; default is ''%%$conf['recent']%%'' |
| [[Discussion]] | ''threads'' | number of discussion thread pages to include in feed | optional; default is ''%%$conf['recent']%%'' |
| [[Editor]] | ''editor'' | user ID, user group or IP address as in Editor Plugin | required |
| [[Tag]] | ''topic'' | tag as in topic component of Tag Plugin | required |
| [[Task]] | ''tasks'' | view filter as in tasks component of Task Plugin | optional; default is ''open'' |


===== Examples =====
<code>{{blogfeed>blog|Blog Entries}}
{{commentsfeed>mynamespace|Individual Comments}}
{{topicfeed>*?cloud|Tagged «Cloud»}}</code>

===== Demo =====

Try this plugin on the [[http://www.wikidesign.ch/playground/feed|playground at Wikidesign]].
FIXME : demo link is broken

===== Bugs =====
Please report bugs at the [[http://bugs.chimeric.de/index.php?project=9&switch=1&do=index|Bug tracker]].

===== Further Resources =====
  * [[http://darcs.chimeric.de/darcsweb.cgi?r=feed|Darcs Repository]]
  * [[http://bugs.chimeric.de/index.php?project=9&switch=1&do=index|Bug tracker]]
  * [[http://dev.chimeric.de/codereference/nav.html?plugins/feed/index.html|Source code]]

===== Discussion =====

Please don't remove the blogging feed just yet. It works better for blog articles that are nested in many namespaces  --- //[[primoz.verdnik@gmail.com|Drye Kindrew]] 2008/11/13 08:00//