Install

pip install django-planet

Required settings

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

In INSTALLED_APPS:

'pagination',
'tagging',
'planet',

Be sure to set the site id:

SITE_ID = 1

Include the context processor:

TEMPLATE_CONTEXT_PROCESSORS = (
    #...
    'planet.context_processors.context',
)

Add the pagination middleware:

MIDDLEWARE_CLASSES = (
    # ...
    'pagination.middleware.PaginationMiddleware',
)

Urls

In urls.py:

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

Optional settings

# To modify cookie names so you don’t have login conflicts with other projects
LANGUAGE_COOKIE_NAME = "myplanetlng"
SESSION_COOKIE_NAME = "myplanetid"
# user agent
PLANET_USER_AGENT = "Django Planet"
# limit the number of posts to be retrieved by feed (default is 30)
PLANET_MAX_POSTS = 20
# base template to be used (base.html is the default)
PLANET_BASE_TEMPLATE ="my_base.html"

Select the async backend:

ASYNC_BACKEND = "huey"

This will be detailed in the next section.