====== 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 : 2010-01-07
compatible : 2009-12-25
depends    : blog, editor, tag, tasks
conflicts  : 
similar    : 
tags       : feed

downloadurl: http://cloud.github.com/downloads/dokufreaks/plugin-feed/plugin-feed.tgz
----

^  Download | [[http://cloud.github.com/downloads/dokufreaks/plugin-feed/plugin-feed.tgz|plugin-feed.tgz]] |

==== Syntax ====

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

^ [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 |
^ [title] | Title shown in the RSS-Link on the wiki page | optional | 

==== Supported Feeds ====

^ Plugin ^ Component ^ Option ^^
| [[Blog]] | ''blog'' | number of blog entries to include in feed \\ \\ :!: **as of DokuWiki 2008-04-11 DokuWiki has its 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 loll like all demo for dokuwiki, no lucky...

===== Bugs / Feature Requests =====
Please report bugs or feature requests at the [[http://github.com/dokufreaks/plugin-feed/issues|Bug tracker]].

===== Further Resources =====
  * [[http://github.com/dokufreaks/plugin-feed/tree/master|Git Repository]]
  * [[http://github.com/dokufreaks/plugin-feed/issues|Bug Tracker]]

===== Changes =====

{{rss>http://github.com/feeds/dokufreaks/commits/plugin-feed/master date}}

===== 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//