[[PageOutline(2-5,Contents,pullout)]]
= Embed RSS feed into wiki page
== Description
This is a macro to embed a RSS feed into a Trac wiki page. This is useful for embedding the output or a ticket query from other Trac instances into a wiki page.
To display the RSS feed, the existing HTML is stripped out. A parameter controls the display of a preview of the first 512 characters of each item. See the examples below.
Parameters are given as key-value pairs, such as in `param=value`. See below for a list of accepted parameters.
== Bugs/Feature Requests
Existing bugs and feature requests for RssEmbedMacro are
[report:9?COMPONENT=RssEmbedMacro here].
If you have any issues, create a
[/newticket?component=RssEmbedMacro new ticket].
[[TicketQuery(component=RssEmbedMacro&group=type,format=progress)]]
== Download
Download the zipped source from [export:rssembedmacro here].
== Source
You can check out RssEmbedMacro from [/svn/rssembedmacro here] using Subversion, or [source:rssembedmacro browse the source] with Trac.
== Installation
Make sure you install feedparser, or this macro won't work.
== Example
Embeding the RSS feed from local ticket query:
{{{[[RssEmbed(url=http://127.0.0.1:8000/test/query?status=!closed&format=rss&order=priority)]]}}}
Adding the options parameter to display the first 512 characters of each item:
{{{[[RssEmbed(url=http://127.0.0.1:8000/test/query?status=!closed&format=rss&order=priority,details=true)]]}}}
Adding a proxy server:
{{{[[RssEmbed(url=http://127.0.0.1:8000/test/query?status=!closed&format=rss&order=priority,details=true,proxy=http://trac-hacks.org:3128)]]}}}
== Screenshots
[[Image(rssEmbedDetail.png)]]
[[Image(rssEmbedNoDetail.png)]]
== Recent Changes
[[ChangeLog(rssembedmacro, 3)]]
== Author/Contributors
'''Author:''' [wiki:smithsos] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''