=====================
Django CMS RSS Plugin
=====================
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`_.
.. _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.
Raw data
{
"_id": null,
"home_page": "http://github.com/zgwmike/django-rss-plugin",
"name": "django-rss-plugin",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "django cms plugin django-rss-plugin",
"author": "Guangwen Zhou",
"author_email": "zgwmike@hotmail.com",
"download_url": "https://files.pythonhosted.org/packages/41/99/52494ad31f6234ceaf2a1c0c2942ce661f81193b5388cd140c7a7a076396/django-rss-plugin-0.1.0.tar.gz",
"platform": "UNKNOWN",
"description": "=====================\nDjango CMS RSS Plugin\n=====================\n\nSimple plugin to show a a rss feed in your django cms site.\n\nFeatures\n========\n* Show specified number of feeds in the page.\n* You can choose to open the feed in current window or new window.\n* Show any rss feed you specified, it can be your external rss url, or your internal rss relative url like '/myblog/rss'.\n* The feed list would be cached for specified time long.\n* You can choose the template of your RSS feed or use the default\n\nUsage\n=====\n\n**Installation**::\n\n $ pip install django-rss-plugin\n\nAdd rssplugin to your INSTALLED_APPS in Django settings.py file, Like following::\n\n INSTALLED_APPS=(\n \t'rssplugin',\n )\n\nRun south migrate to install plugin database::\n\n $ python manage.py migrate rssplugin\n\nIf no south, just run::\n\n $ python manage.py syncdb\n\n**template filter**\n\n#. parsed_to_date::\n\n {% load rss_tags %}\n {{ entry.published_parsed|parsed_to_date|timesince }}\n\nsee rss.html for usage examples.\n\n**Notice**, both external link like 'http\uff1a//example.com/rss' and internal link like '/blog/rss' are supported.\n\n\n**Using custom template**\n\nUse `CMS_RSS_PLUGIN_TEMPLATE = \"path_to_your_template.html\"` in settings.py to set a custom template, default is rss/rss.html.\n\n\n**Feed timeout**\n\nUse `CMS_RSS_PLUGIN_FEEDPARSER_TIMEOUT = seconds` in settings.py to set a custom socket timeout, default is 60\n\nOnline Resources\n----------------\n\n* `Code repository`_.\n\n.. _Code repository: https://github.com/zgwmike/django-rss-plugin\n\nChange History\n--------------\n- 03/04/2015, Version 0.0.9\n\n Added socket timeout settings when fetching feed.\n \n- 01/01/2015, Version 0.0.8\n\n\tAdded customized template support, thanks to Felix-neko contribution.\n\n- 2/13/2013, Version 0.0.7\n\n Fix a template bug.\n\n- 2/12/2013, Version 0.0.6\n\n New feature:\n\n #. Can specify both external link and internal path.\n\n- 2/11/2013, Version 0.0.5\n\n New features:\n\n #. If no entries found, show \"no entries found\".\n\n- 2/8/2013, Version 0.0.4\n\n First stable release published to Pypi.",
"bugtrack_url": null,
"license": "BSD",
"summary": "A Django CMS plugin to show a list of feeds.",
"version": "0.1.0",
"split_keywords": [
"django",
"cms",
"plugin",
"django-rss-plugin"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "419952494ad31f6234ceaf2a1c0c2942ce661f81193b5388cd140c7a7a076396",
"md5": "7d0d415341235ed567647cc1be885fe2",
"sha256": "2195524ce27d6f89d596729a8efb06e805baf5affaad832c60a176753ea80489"
},
"downloads": -1,
"filename": "django-rss-plugin-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "7d0d415341235ed567647cc1be885fe2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 6458,
"upload_time": "2015-10-06T04:09:33",
"upload_time_iso_8601": "2015-10-06T04:09:33.872861Z",
"url": "https://files.pythonhosted.org/packages/41/99/52494ad31f6234ceaf2a1c0c2942ce661f81193b5388cd140c7a7a076396/django-rss-plugin-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2015-10-06 04:09:33",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "zgwmike",
"github_project": "django-rss-plugin",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "django-rss-plugin"
}
JSON
