This is an old revision of the document!
Table of Contents
RSS/ATOM Feed Aggregation
DokuWiki can integrate data from external XML feeds. See also syndication on how DokuWiki exports data as XML feeds.
Syntax
Including an RSS or ATOM feed is simple. Here is an example of including the latest Headlines from Slashdot:
{{rss>http://slashdot.org/index.rss}}
For parsing the XML feeds, SimplePie is used. All formats understood by SimplePie can be used in DokuWiki as well. You can influence the rendering by multiple additional space separated parameters:
| Parameter | Description |
|---|---|
| any number | will be used as maximum number items to show, defaults to 8 |
| reverse | display the last items in the feed first |
| author | show item authors names |
| date | show item dates |
| description | show the item description. If HTML is disabled all tags will be stripped |
| n[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). |
The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. DokuWiki will generally try to supply a cached version of a page, obviously this is inappropriate when the page contains dynamic external content. The parameter tells DokuWiki to re-render the page if it is more than refresh period since the page was last rendered.
Example:
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
Problems
Display of HTML entities
Two of the example Slashdot headlines when I visited this page today showed this problem
Building a Successful "Open" Game World MediaSentry & RIAA Expert Under Attack
How should it be solved? — Fernando 2009/03/04 10:51
I am also having this problem with several news feeds that I'm now featuring on our dokuwiki site and I am searching for a solution. Any help would be awesome. — Russ 2009/03/21 7:20
Bug reported & confirmed, see http://bugs.splitbrain.org/index.php?do=details&task_id=1705 — Håkan Sandell 2009/06/10 16:56