Installation.

Before install django-userena, you’ll need to have a copy of Django 1.2 or newer installed.

For further information, consult the Django download page, which offers convenient packaged downloads and installation instructions.

Installing django-userena.

You can install django-userena automagicly with easy_install or pip. Or manually placing it on on your PYTHON_PATH.

I’m using virtualenv to have an isolated python environment. This way it’s possible to create a tailored environment for each project.

Automatic installation with easy_install.

Automatic install with easy_install. You’ll first have to clone the Git repository from Github. Then you can direct easy_install to the setup.py file. For ex.:

git clone git://github.com/bread-and-pepper/django-userena.git
cd django-userena
easy_install setup.py

Automatic installation with pip.

You can tell pip to install django-userena by supplying it with the git repository on Github. Do this by typing the following in your terminal:

pip install -e git+git://github.com/bread-and-pepper/django-userena.git#egg=userena

Manual installation with git.

Required settings

Begin by adding userena to the INSTALLED_APPS setting of your project and adding UserenaAuthenticationBackend at the top of AUTHENTICATION_BACKENDS. If you only want Django’s default backend and that of userena you will get the following:

AUTHENTICATION_BACKENDS = (
    'userena.UserenaAuthenticationBackend',
    'django.contrib.auth.backends.ModelBackend',
)

The URI’s

Userena has a URLconf which set’s all the url’s and views for you. This should be included in your projects root URLconf.

For example, to place the URIs under the prefix /accounts/, you could add the following to your project’s root URLconf:

(r'^accounts/', include('userena.urls')),

This should have you a working accounts application for your project. See the settings and templates for further configuration options.