django-rss-plugin 0.1.0

A Django CMS plugin to show a list of feeds.

Simple plugin to show a a rss feed in your django cms site.

Features

• 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

Usage

Installation:

$ pip install django-rss-plugin

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

INSTALLED_APPS=(
      'rssplugin',
)

Run south migrate to install plugin database:

$ python manage.py migrate rssplugin

If no south, just run:

$ python manage.py 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 ‘http：//example.com/rss’ and internal link like ‘/blog/rss’ are supported.

Using custom template

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

Feed timeout

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

Online Resources

• Code repository.

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.