Skip to main content

A Django CMS plugin to show a list of feeds.

Project description

Simple plugin to show a a 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:


Run south migrate to install plugin database:

$ python migrate rssplugin

If no south, just run:

$ 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 template

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

Feed timeout

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

Online Resources

Change History

  • 03/04/2015, Version 0.0.9

    Added socket timeout settings when fetching feed.

  • 01/01/2015, Version 0.0.8

    Added customized template support, thanks to Felix-neko contribution.

  • 2/13/2013, Version 0.0.7

    Fix a template bug.

  • 2/12/2013, Version 0.0.6

    New feature:

    1. Can specify both external link and internal path.
  • 2/11/2013, Version 0.0.5

    New features:

    1. If no entries found, show “no entries found”.
  • 2/8/2013, Version 0.0.4

    First stable release published to Pypi.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-rss-plugin-0.1.0.tar.gz (6.5 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page