/django-authtools

A custom User model for everybody!

Primary LanguagePythonBSD 2-Clause "Simplified" LicenseBSD-2-Clause

django-authtools

Build Status

A custom user model app for Django 1.11+ 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.