This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

django-external-feed

Show content from an XML feed on your own site. This allows you to use a commercial weblog service, yet you can still integrate the news articles within your site.

Quick start

  1. Add “externalfeed” to your INSTALLED_APPS setting like this:

    INSTALLED_APPS = (
        ...
        'externalfeed',
    )
    
  2. Configure the feeds in your settings:

    FEED_SOURCES = (
        # (key, source, prefix to strip from the url)
        ('bbc',
         'http://feeds.bbci.co.uk/news/rss.xml',
         'http://www.bbc.co.uk/news'),
    )
    

    Note: not all external sources may allow you to embed their content like this. You should check their terms of service.

    • The key is a text of your choosing that will end up in the url on your website.
    • The source is the url to an rss, atom or other syndication feed. We use feedparser to parse this.
    • The feed will have a url for each item. The prefix is the part that we strip from this url. The remainder of the url will end up in the url that makes this item available on your website. If the url does not match the prefix, we take the part after the domain name.
  3. Include the externalfeed URLconf in your project urls.py like this, or optionally roll your own:

    url(r'^externalnews/', include('externalfeed.urls')),
    

With the above settings, say the bbc rss feed has an item with this url:

http://www.bbc.co.uk/news/uk-england-cumbria-23341015

This item will then be visible on your site at:

<your-domain>/externalnews/bbc/uk-england-cumbria-23341015

When the item is no longer in the rss feed, the item is no longer visible on your site.

Template tags

The url config will make some views with templates available, but you can also roll your own. In that case, the template tags will be useful. To make the template tags available, add this line in your template:

{% load feeder %}

These template tags are then available:

  • single_feed: show single feed
  • feeds: show all feeds. Internally, this iterates over the feeds and uses the single_feed tag for each of them, passing its own arguments to that tag.
  • feed_entry: show single entry
  • feed_entry_title: show title of single entry

feeds and single_feed take these optional arguments: format_string (default: empty string, options: full and/or list) and limit (default: 0, which means no limit). single_feed requires a key as first argument.

Show all feeds, with per entry only the title as a header:

{% feeds %}

Show all feeds, with per entry also the contents:

{% feeds "full" %}

Show all feeds, with entries in a simple list per feed:

{% feeds "list" %}

Specifying full list is accepted, but the list wins then and full is ignored. Note that at the moment the code simply checks for the presence of the string full or list and not if the words are separated by spaces. A silly string like no fullist ignored will match both full and list without complaining.

Show all feeds, with the default formatting, but limit to 2 entries per feed:

{% feeds "" 2 %}

Show only the bbc feed:

{% single_feed "bbc" %}

Show only the bbc feed in a simple list of the most recent 4 entries:

{% single_feed "bbc" "list" 4 %}

The feed_entry and feed_entry_title tags both require a key and a path:

{% feed_entry "bbc" "uk-england-cumbria-23341015" %}
{% feed_entry_title "bbc" "uk-england-cumbria-23341015" %}

Compatibility

Tested with Django 1.4.3. It is expected to work fine on Django 1.3 or higher.

Changelog

0.1 (2013-07-18)

  • Initial release. [maurits]
Release History

Release History

0.1

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django-external-feed-0.1.zip (27.3 kB) Copy SHA256 Checksum SHA256 Source Jul 18, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting