No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Django CMS RSS Plugin

Simple plugin to show an RSS feed in your django cms site.


  • Show specified number of feeds in the page.
  • You can choose to open the feed in current window or new window.
  • Show any RSS feed you specified, it can be your external RSS url, or your internal RSS relative url like '/myblog/rss'.
  • The feed list would be cached for specified time long.
  • You can choose the template of your RSS feed or use the default



$ pip install django-rss-plugin

Add rssplugin to your INSTALLED_APPS in Django file, Like following:


Django >= 1.7:

Run django migrate to install plugin database:

$ python migrate rssplugin

Django and South:

In your file, set the south migration module:

  'rssplugin': 'rssplugin.south_migrations',

Run south migrate to install plugin database:

$ python migrate rssplugin

Django < 1.7 without South:

$ python syncdb

template filter

  1. parsed_to_date:

    {% load rss_tags %}
    {{ entry.published_parsed|parsed_to_date|timesince }}

see rss.html for usage examples.

Notice, both external link like '' and internal link like '/blog/rss' are supported.

Using custom templates

Use CMS_RSS_PLUGIN_TEMPLATE = "path_to_your_template.html" in to set a custom template, default is rss/rss.html.

If you specify CMS_RSS_PLUGIN_TEMPLATES instead, rssplugin offers authors an optional choice of custom templates.


    ('short.html', gettext('Short')),
    ('long.html', gettext('Long')),
    ('mailing_list.html', gettext('List Server')),

For a reference of the feed and entry attributes you can use in your templates, have a look at the feedparser dokumentation:

Feed timeout

Use CMS_RSS_PLUGIN_FEEDPARSER_TIMEOUT = seconds in to set a custom socket timeout, default is 60

Online Resources