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.
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 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
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
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',
)
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.