Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Import RSS and Atom feeds and save in the database.

Project description

===================
django-feed-imports
===================

Import RSS and Atom feeds and save in the Django database.

Requirements
============

* Django >= 1.4
* Feedparser
* `django.core.context_processors.request` context processor (for the template
tag usage)

Installation
============

Install from pypi::

pip install django-feed-imports

Install from source with pip::

pip install -e https://github/modlinltd/django-feed-imports/archive/master.zip#egg=feed_imports

Or install from source:

git clone https://github.com/modlinltd/django-feed-imports.git
cd django_feed_imports
python setup.py install

Add it the application to your ``INSTALLED_APPS`` setting::

INSTALLED_APPS = (
...
'feed_imports',
)

Run `syncdb` and `migrate`::

python manage.py syncdb
python manage.py migrate

Usage
=====

#. Configure the feeds sources in the Admin.
#. Run the management command::

python manage.py refresh_feeds

*The management command should run as a cron job.*
#. Using the template tag::

{% load feed_items %}
{% get_feed_items "news" 5 as items %}
{# Get the last 5 items from the feed "news" in the current language #}
{% for item in items %} {# do stuff ... #} {% endfor %}

The `get_feed_items` returns the last `n` items from the provided feed in
the language as set in the request, with a fallback to the default language.

If settings.DEFAULT_LANGUAGE is not defined, English will be assumed.
<<<<<<< HEAD

#. To use `feed_item.get_absolute_url()` you must the define a url with the
name `feed_item` in you `urls.py`. For Example::

url(r'^feed_item/(?P<pk>.+)$',
login_required(DetailView.as_view(model=FeedItem)),
name='feed_item'),


Changelog
=========

0.1.7
#####

* Clean up README and prepare for sharing

0.1.6
#####

* add Python 3 support
=======
>>>>>>> parent of 68cd327... updated readme

Project details


Release history Release notifications

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page