Skip to main content

Django app to build a planet, RSS/Atom feeds aggregator.

Project description

Changing your settings.py

Modifiy your projects settings.py file following the next steps:

  1. Check your INSTALLED_APPS in your to have installed:

INSTALLED_APPS = (
  # django required contrib apps
  'django.contrib.sites',
  'django.contrib.admin',
  'django.contrib.auth',
  'django.contrib.contenttypes',
  'django.contrib.sessions',
  'django.contrib.messages',
  'django.contrib.staticfiles',
  'django.contrib.sitemaps',
  # 3rd-party required apps:
  'pagination',
  'tagging',
  'pinax_theme_bootstrap',
  # and finally:
  'planet',
)
  1. Configure your database. Here goes an example using mysql:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql', # Add 'postgresql_psycopg2', 'postgresql', 'mysql', 'sqlite3' or 'oracle'.
        'NAME': 'planet',                      # Or path to database file if using sqlite3.
        'USER': '<myuser>',                      # Not used with sqlite3.
        'PASSWORD': '<mypass>',                  # Not used with sqlite3.
        'HOST': '',                      # Set to empty string for localhost. Not used with sqlite3.
        'PORT': '',                      # Set to empty string for default. Not used with sqlite3.
    }
}
  1. Choose a site id:

SITE_ID = 1
  1. Include the following context processors:

TEMPLATE_CONTEXT_PROCESSORS = (
    'django.contrib.auth.context_processors.auth',
    'django.core.context_processors.debug',
    'django.core.context_processors.i18n',
    'django.core.context_processors.media',
    'django.core.context_processors.static',
    'django.core.context_processors.tz',
    'django.core.context_processors.request',
    'django.contrib.messages.context_processors.messages',
    'planet.context_processors.context',
)

Please do not forget planet.context_processors.context!

  1. Check your middlewares to include:

MIDDLEWARE_CLASSES = (
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
    'pagination.middleware.PaginationMiddleware',
)

Please do not forget pagination.middleware.PaginationMiddleware middleware!

  1. Add planet configuration variables:

PLANET = {
    "USER_AGENT": "My Planet/1.0",
}
  1. Configure properly your static files root directory:

STATIC_URL = '/static/'
  1. Also your projects templates root directory:

TEMPLATE_DIRS = (
    '/path/to/planet/porject/templates',
    # other paths...
)
  1. And your template loaders must look like these:

TEMPLATE_LOADERS = (
    'django.template.loaders.filesystem.Loader',
    'django.template.loaders.app_directories.Loader',
    # some other template loaders here...
)
  1. Finally in your project’s templates directory create a site_base.html template if you don’t already have one:

{% extends "base.html" %}
  1. Optionally, modify cookie names so you don’t have login conflicts with other projects:

LANGUAGE_COOKIE_NAME = "myplanetlng"
SESSION_COOKIE_NAME = "myplanetid"

Congratulations! Your settings are complete. Now you’ll need to chenge other files in order to get a running project.

Enable planet urls

  1. Add the planet urls include to your porjects urls.py (remember to also include admin urls so you can use the admin to manage your planet!):

from django.conf.urls import patterns, include, url

from django.contrib import admin
admin.autodiscover()

urlpatterns = patterns('',
    url(r'^', include('planet.urls')),
    url(r'^admin/', include(admin.site.urls)),
    # ... other url bits...
)

Syncdb and add some feeds!

  1. Then create the database structure:

    ./manage.py syncdb
  2. Add some feeds:

    python manage.py planet_add_feed http://www.economonitor.com/feed/rss/
    python manage.py planet_add_feed http://www.ft.com/rss/home/us
  3. And surely you’ll want to add a cron entry to periodically update them all:

    30 * * * * python manage.py planet_update_all_feeds

This attempts to pull for new posts every 30 minutes.

  1. Now you’re done. Just run:

    ./manage.py runserver

and browse your planet at http://localhost:8000/ in your favorite browser!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-planet-0.5.2.tar.gz (36.8 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page