RSS Module Tags

The main purpose of the RSS tag is to render the top portion of the feed containing the name of the author, the character encoding, etc., while the main weblog tag renders the actual rows.

The entire RSS feed is enclosed between the following tags:

{exp:rss:feed}

{/exp:rss:feed}

Parameters

If you use any of the following parameters, you will probably want to mirror the same settings for your {exp:weblog:entries} tag contained inside the RSS tag.

status=

status="open"

The weblog status to which you would like to restrict display. You can choose multiple statuses using a pipe:

status="draft|reviewed|published"

Or exclude statuses using "not"

status="not submitted|processing|closed"

username=

username="petunia"

This parameter limits the query by username. You can use the pipe character to query by multiple usernames:

username="tom|dick|harry"

Or you can add "not" to exclude usernames:

username="not tom|dick|harry|fred" You can also use the constant "CURRENT_USER" to show entries from only the currently logged in user.

username="CURRENT_USER"

This allow each logged-in user to get only their entries. Users who are not logged in won't see anything. Alternatively, you can use the constant "NOT_CURRENT_USER" to show entries except from the currently logged in user.

username="NOT_CURRENT_USER"

weblog=

weblog="which"

From which weblog to show the meta data information. You must specify a single weblog.

Variables

author

{author}

The name of the person who submitted the last entry.

email

{email}

The email of the person submitting the very last entry.

encoding

{encoding}

The XML character encoding for the weblog.

weblog_description

{weblog_description}

The description of the weblog.

weblog_id

{weblog_id}

ID number of the weblog (not the weblog entry, the actual blog).

weblog_language

{weblog_language}

The code for the language the weblog is in (en-us, etc.).

weblog_name

{weblog_name}

The name of the weblog.

weblog_url

{weblog_url}

The URL associated with the weblog as set in the "Weblog URL" preference under Weblog Management.

Single Variable Dates

Several date variables are available for use. As with other date variables, these require the "format" parameter in order to define how the date should be displayed. See the date variable formatting page for more information.

date

{date format="%Y %m %d"}

The date on which the last entry was submitted. Note: as with all dates, the formatting codes are necessary: {date format="%Y"}

edit_date

{edit_date format="%Y %m %d"}

The date on which the entry was last edited.

gmt_entry_date

{gmt_date format="%Y %m %d"}

The date the entry was submitted in GMT. This variable is not localized for each user's date settings.

gmt_edit_date

{gmt_edit_date format="%Y %m %d"}

The date on which the entry was last edited in GMT. This variable is not localized for each user's date settings.

In addition, the weblog entries tag is used as well {exp:weblog:entries}

We have provided templates for the most common RSS versions, so you generally won't need to construct your RSS feeds manually.