django-custom-user 1.1

Quick start

1. Install django-custom-user with your favorite Python package manager:

pip install django-custom-user

2. Add 'custom_user' to your INSTALLED_APPS setting:

INSTALLED_APPS = (
    # other apps
    'custom_user',
)

3. Set your AUTH_USER_MODEL setting to use EmailUser:

AUTH_USER_MODEL = 'custom_user.EmailUser'

4. Create the database tables:

python manage.py migrate

Usage

Instead of referring to EmailUser directly, you should reference the user model using get_user_model() as explained in the Django documentation. For example:

from django.contrib.auth import get_user_model

user = get_user_model().objects.get(email="user@example.com")

When you define a foreign key or many-to-many relations to the EmailUser model, you should specify the custom model using the AUTH_USER_MODEL setting. For example:

from django.conf import settings
from django.db import models

class Article(models.Model):
    author = models.ForeignKey(settings.AUTH_USER_MODEL)

Extending EmailUser model

You can easily extend EmailUser by inheriting from AbstractEmailUser. For example:

from custom_user.models import AbstractEmailUser

class MyCustomEmailUser(AbstractEmailUser):
    """
    Example of an EmailUser with a new field date_of_birth
    """
    date_of_birth = models.DateField()

Remember to change the AUTH_USER_MODEL setting to your new class:

AUTH_USER_MODEL = 'my_app.MyCustomEmailUser'

If you use the AdminSite, add the following code to your my_app/admin.py file:

from django.contrib import admin
from custom_user.admin import EmailUserAdmin
from .models import MyCustomEmailUser


class MyCustomEmailUserAdmin(EmailUserAdmin):
    """
    You can customize the interface of your model here.
    """
    pass

# Register your models here.
admin.site.register(MyCustomEmailUser, MyCustomEmailUserAdmin)

Supported versions

Django:

• 3.2 LTS

• 4.0

Python:

• 3.7

• 3.8

• 3.9

• 3.10

Changelog

python manage.py migrate custom_user 0001_initial_django17 --fake
python manage.py migrate custom_user

python -c "import os; import custom_user; print(os.path.dirname(custom_user.__file__))"

python manage.py migrate --list

python manage.py migrate custom_user 0002_initial_django18 --fake