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
#. 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: https://github.com/zgwmike/django-rss-plugin
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:
#. Can specify both external link and internal path.
-
2/11/2013, Version 0.0.5
New features:
#. If no entries found, show "no entries found".
-
2/8/2013, Version 0.0.4
First stable release published to Pypi.