RSS Parser

The RSS Parser plugin provides RSS parsing tags for your templates. It uses SimplePie to parse and render any RSS or Atom feed you throw at it.

Example

Here’s a simple example where we’re pulling the ExpressionEngine blog feed and showing the five most recent posts:

{exp:rss_parser url="https://expressionengine.com/blog/rss-feed" limit="5"}
<h1>{feed_title}</h1>
<ul>
    {feed_items}
        <li>
            <h2><a href="{item_link}">{item_title}</a></h2>
            <ul class="metadata">
                <li class="byline">by {item_authors backspace="2"}{author_name}, {/item_authors}</li>
                <li class="date">{item_date format="%F %d %Y"}</li>
            </ul>
            {item_content}
        </li>
    {/feed_items}
</ul>
{/exp:rss_parser}

Parameters

There are four available parameters:

url

The URL of the RSS or Atom feed

limit

Number of items to display from the feed

offset

Number of items to skip from the feed

refresh

How long you want the feed to be cached (default cache length is three hours)

Single Variables

Most of the variables are fairly self explanatory:

• {feed_title}
• {feed_link}
• {feed_copyright}
• {feed_description}
• {feed_language}

Both RSS 2.0 and Atom 1.0 feeds can have a “feed logo”. The following variables can be used to display the logo:

• {logo_title}
• {logo_url}
• {logo_link}
• {logo_width}
• {logo_height}

Also, if there’s an error in retrieving the feed, you can use the following variable to display the error:

• {feed_error}

Pair Variables

There are three pair variables available. Both {item_categories} and {item_authors}, are only available within {feed_items}.

{feed_items}

The {feed_items} variable contains all of the items found within the feed:

• {item_title}
• {item_link}
• {item_date}: uses standard ExpressionEngine date formatting (e.g. {date format="%F %d %Y"})
• {item_description}: tends to be a short excerpt of the full {item_content}, but varies
• {item_content}: tends to be full content, but varies

{item_authors}

The {item_authors} variable contains information about all of the authors of a particular item. Each author has three single variables associated with it:

• {author_email}
• {author_link}
• {author_name}

{item_categories}

The {item_categories} variable contains all of the categories that a feed item has been assigned. Each category has one useful variable:

• {category_name}

Conditionals

There are only two conditionals:

• {if feed_error}: In case of a feed error the parser will only display content inside of this conditional, if the conditional does not exist, nothing is shown.
• {if no_results}: Just like the Channel module, if there are no results only show the contents of this conditional.

ExpressionEngine 6 Docs
©2002–2024 Packet Tide,LLC. Edit this page