Django : add email field to user creation form

add-email-field-to-user-creation-form.py

# context:
# You are using the basic User in your Django application
# and would like to add the "email" field to the user creation form.

# version: tested with Django 5.1.7

# instructions: update admin.py with the following lines

from django.contrib.auth.forms import UserCreationForm
from django.contrib.auth.models import User
from django.contrib import admin
from django.contrib.auth.admin import UserAdmin
from django import forms

# create a new form, adding the email field to the list of fields
class CustomUserCreationForm(UserCreationForm):
    # add this line to make the email field required
    email = forms.EmailField(required=True)

    class Meta():
        model = User
        fields = ("username", "email", "password1", "password2")

# update the UserAdmin, overriding the "add form"
UserAdmin.add_form = CustomUserCreationForm
UserAdmin.add_fieldsets = (
        (None, {
            'classes': ('wide',),
            'fields': ('username', 'email', 'password1', 'password2'),
        }),
    )

# unregister & re-registger the User, but works fine without doing it
#admin.site.unregister(User)
#admin.site.register(User, UserAdmin)