News RSS syntax
The Sitekit RSS feed supports several arguments to allow filtering of content. They are explained below:
By default, every time you create a news module in Sitekit the news items you add to that module are available as an RSS feed. Access to this feed is via the following syntax:
http:<your domain>/rss.aspx?ID=<your news module ID>
The above URL will create an RSS feed showing all the non-archived news items from the specified news module order by most recent first. It's possible to add additional argument to the RSS URL above to enable more flexible filtering of news content. These additional arguments are defined below and each one should be separated with an &:
|
Argument |
Values/Examples |
Notes |
|---|---|---|
ID |
ID=123 |
Mandatory - defines the ID of the news module from which the RSS will syndicate the news items. |
quantity |
qty=4 |
Optional - defines the number of news results to be returned in the feed. Most recent first. |
show from |
showfromyear=2006&showfrommonth=11 &showfromday=12&showtoyear=2006& showtomonth=11&showtoday=24 |
Optional - 6 arguments used to define a date range for displaying news feed items. |
showLastDays |
showLastDays=7 |
Optional - news items from the last X days will be displayed. Ignored if there are values for showfrom. |
archive option |
archiveoption=archive or archiveoption=archivepluslive |
Optional - by default the RSS feed doesn't display archived news items. These arguments allow that to be extended to include only archived news or archive plus live. archiveoption is ignored if 'show from' dates are specified. |
podcast |
n/a |
Optional - the podcast element is tagged on at the end of the querystring e.g. RSS.aspx?ID=729&podcast it returns an extended RSS feed with specific podcast related tags in order to make it acceptables to iTunes etc. |
| nohtml | nohtml=1 | Optional - when enabled (=1), HTML will be stripped from article summaries. Default state is off (=0). |
category |
category=dog or category=dog&category=cat |
Optional - Allows for filtering the RSS via the category field on each news article. Where more than one category is specified then value from both categories will be returned (Logical OR). |
Examples:
-
/rss.aspx?id=234 - basic URL displaying all non archived news items
-
/rss.aspx?id=234&qty=4&random - 4 random non archived news items
-
rss.aspx?id=234&qty=4&archiveoption=archivepluslive&random - 4 random news items including archived ones
-
rss.aspx?id=234&qty=4&category=sheep&category=goats - 4 most recent non archived news items categorised as either 'sheep' or 'goats'
- /rss.aspx?id=234&reflocid=0fi6gh&qty=6 - 6 most recent non archived news items. On click through the news details pages will adopt the styling of the 0fi6gh page.