django-authtools

A custom user model app for Django 1.8+ that features email as username and other things. It tries to stay true to the built-in user model for the most part.

The main differences between authtools's User and django.contrib.auth's are email as username and class-based auth views.

Read the django-authtools documentation.

Quickstart

Before you use this, you should probably read the documentation about custom User models.

1. Install the package:

   $ pip install django-authtools

2. Add authtools to your INSTALLED_APPS.

3. Add the following to your settings.py:

   AUTH_USER_MODEL = 'authtools.User'

4. Add authtools.urls to your URL patterns:

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

5. Enjoy.