====RSS Feeds====
>>**See Wikka in action:**
~-""<a href="http://docs.wikkawiki.org/WikkaInAction#hn_5._Embedding_an_RSS_feed">Embedding an RSS feed</a>"" {{image url="images/action/qt.gif" alt="quicktime icon" title="Wikka clips"}}
**See also:**
~-[[Rss | What is an RSS]]
~-[[ThirdPartyInfo | Third-party software bundled with Wikka]]
>>
[[RSS]] | feeds have recently gained much popularity. Subscribing to a feed allows one to retrieve a list of what is changed on a page or site without having to visit the site.

Pages that make this possible often have a small button like "rss" or similar on their page(s). For example, Wikka's page revision feeds are available at the bottom of the page under the {{image url="images/xml.png"}} icon.::c::

===Including RSS Feeds to wikka-pages===
Wikka allows you to embed external RSS feeds within a page body. To include a RSS-feed, use the following action:

""{{rss url="http://www.example.com" cachetime="30"}} ""

==Parameters==
""<table cellspacing="0" cellpadding="2" border="1">
<thead>
<tr><th scope="col">name</th><th scope="col">type</th><th scope="col">required?</th><th scope="col">default</th><th scope="col">description</th></tr>
</thead>
<tbody>
<tr><td>url</td><td>string</td><td>optional</td><td>see usage!</td><td>the url of the feed to be included</td></tr>
<tr><td>cachetime</td><td>integer</td><td>optional</td><td>30</td><td>Time (in minutes) for which the feed is cached. Can't be below 5 minutes. This is useful for pages which aren't changed very often, reducing the traffic produced.</td></tr>
</tbody>
</table>""

The following parameters are configured in ##actions/rss.php## and can be changed only by page-admins:

%%(php)
$max_items = 30; // set this to the maximum items the RSS action should ever display
$caching = true; // change this to false to disable caching
$rss_cache_path = "/tmp"; // set this to a writable directory to store the cache files in
$lowest_cache_time_allowed = "5"; // set this to the lowest caching time allowed
%%

Usage:
%%{{rss url="http://www.example.com" cachetime="30"}}%%

The following usage is deprecated and probably will not be supported in future versions. It is listed here for informational purpose only:
%%{{rss http://www.example.com}}%%

Example:

{{rss http://docs.wikkawiki.org/RecentChanges/recentchanges.xml}}

----
CategoryEN