Tag Definitions %RSS%
Renders a list of RSS items from an external RSS feed
Displays a list of links imported from an RSS feed.
| Parameter | Type | Description |
|---|---|---|
| type | ul ol dl | The list type that is rendered. Any type of valid XHTML list can be used here. |
| caption | String | The caption to label the input field, default is 'List of links' |
| class | String | The 'class' attribute to add to the rendered HTML tags as determined by type. |
| id | String | The 'id' attribute to add to the rendered HTML. |
| startitem | Integer | The first item to be displayed from the list of items found, default is '1' |
| maxitems | Integer | The maximum number of items to be rendered from the list. Default value is 100. |
| modulo | Integer | Displays only the nth element from a list, for example when creating multi-column lists. |
| itemtemplate | String | The snippet that is used to render each item in the list. |
| firstitemtemplate | String | The snippet that is used to render the first item in the list. |
| lastitemtemplate | String | The snippet that is used to render the last item in the list. |
| noitemstemplate | String | The snippet that is used whenever the RSS feed contains no items. |
| httperrortemplate | String | The snippet that is used whenever the RSS feed can not be reached. |
| pageparamfield | String | The
name of the parameter in the URL that contains the value of the current
page number. Default is 'pagenr'. Change this parameter in the event that there are multiple lists with paginators on the template. |
| usepaginator | yes no | Set this parameter to 'yes' whenever this list has a Paginator tag attached. Default is 'no'. |
| sortorder | asc desc | Sets the default sort order for the list of links. This setting can be overruled by the editor. |
| sorttype | manual type | Determines what field is used to sort the items by default. This setting can be overruled by the editor. manual: The items are sorted using the sequence of the items in the editor. |
| contentcache | Integer | A number in seconds that determines how long the RSS items are cached since the last feed retrieval. A minimal value of 3600 is mandatory. |
Example
In this example the latest five rss items are shown. Content is refreshed every 20000 seconds:
%RSS(class=rssclass, maxitems=5, itemtemplate=rss_item, type=ul, firstitemtemplate=rss_item, lastitemtemplate=rss_item, noitemstemplate=rss_listempty, httperrortemplate=rss_listerror, sortorder=asc,sorttype=manual, contentcache=20000)%