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://rss.slashdot.org/Slashdot/slashdotMain}}
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://rss.slashdot.org/Slashdot/slashdotMain 5 author date 1h}}
To access feeds via HTTPS/SSL the openssl extension must enabled in the PHP configuration.