1.1 --- a/README.txt Sat Apr 04 23:49:49 2009 +0200
1.2 +++ b/README.txt Sun Apr 05 00:08:07 2009 +0200
1.3 @@ -8,11 +8,11 @@
1.4 the details of each event, colouring each event period in a specially
1.5 generated colour.
1.6
1.7 -The EventAggregatorSummary action can be used to provide an iCalendar summary
1.8 -of event data based on pages belonging to specific categories, as described
1.9 -above. The category, start and end parameters are read directly from the
1.10 -request as URL or form parameters: these restrict the extent of each generated
1.11 -summary.
1.12 +The EventAggregatorSummary action can be used to provide iCalendar and RSS
1.13 +summaries of event data based on pages belonging to specific categories, as
1.14 +described above. The category, start and end parameters are read directly from
1.15 +the request as URL or form parameters: these restrict the extent of each
1.16 +generated summary.
1.17
1.18 Installation
1.19 ------------
2.1 --- a/pages/HelpOnEventAggregatorSummary Sat Apr 04 23:49:49 2009 +0200
2.2 +++ b/pages/HelpOnEventAggregatorSummary Sun Apr 05 00:08:07 2009 +0200
2.3 @@ -36,6 +36,19 @@
2.4
2.5 This restricts the initial query to only retrieve events occurring in the months of June 2009 (`2009-06`) and July 2009 (`2009-07`).
2.6
2.7 +=== RSS 2.0 Feeds ===
2.8 +
2.9 +By adding the `format` parameter, an RSS feed resource can be produced:
2.10 +
2.11 +{{{
2.12 +http://example.com/moin/FrontPage?action=EventAggregatorSummary&category=CategoryEvents&doit=1&
2.13 +format=RSS
2.14 +}}}
2.15 +
2.16 +This resource produces a description of all events within the stated criteria. Updated events should be detected by feed readers and each subscriber notified of such updates, with the comment made when the affected event was edited being provided as the event description in the feed.
2.17 +
2.18 +A technical note: feed readers will typically detect updated events by consulting the content of each event description's `guid` element, notifying the user of changes if the content of that element has itself changed.
2.19 +
2.20 == See Also ==
2.21
2.22 * HelpOnEventAggregator - a macro producing event calendars and listings