django-feed-imports 0.1.7

===================
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