Knowledgebase

Article number: 301417

XML RSS Events Feeds

Documentation on the creation of XML RSS event feeds for use as entire pages or data islands.

It is possible to have a feed for today’s events, one or more weeks events (starting from this week) or a month’s events (either this month or a specified month in a specified year). It is also possible to order the output by different fields, and filter by by town, venue and category.

There is one necessary parameter - event module id - all others are optional.

  • http://example.sitekit.net/rss_events.aspx?ID=21

Parameter: rssview

rssview = day: todays events
rssview = week: a weeks events starting from today
rssview = month: a calendar month's events for the selected month

  • http://example.sitekit.net/rss_events.aspx?ID=21&rssview=day
  • http://example.sitekit.net/rss_events.aspx?ID=21&rssview=week
  • http://example.sitekit.net/rss_events.aspx?ID=21&rssview=month

The default is today's events.

For "rssview=week" it is possible to specify a quantity of weeks using the qty parameter, e.g.:

  • http://example.sitekit.net/rss_events.aspx?ID=21&rssview=week&qty=2

For "rssview=month" the month and year can be specified. The default is the current month and year, e.g.:

  • http://example.sitekit.net/rss_events.aspx?ID=21&rssview=month&month=6
  • http://example.sitekit.net/rss_events.aspx?ID=21&rssview=month&month=6&year=2006

Parameters: venue, category, town

For either day, week or month, the category can be specified, venue and/or town (optional). All text fields. E.g.:

  • http://example.sitekit.net/RSS_events.aspx?ID=21&rssview=month&month=6&year=2005&venue=pavilion&category=music&town=leeds

Parameter: orderby

It is possible to order the data by several fields:-

ident, Startdate, Enddate, DaysOpen, Event, Category, Town, Venue, Description, picid

And an additional variable can be added to the parameter, to order the output as ascending or descending:-

asc, desc. For example:-

  • http://example.sitekit.net/RSS_events.aspx?ID=21&orderby=Startdate asc

Parameter: format

It is possible to vary the output. The default with no argument is XML (RSS). With an addition of format=ical the output can be extended to include the ical file type. This results in a file with the suffix .ics

For example

  • http://example.sitekit.net/RSS_events.aspx?ID=21&year=2012&month=3&rssview=month&format=ical

Related questions