Documentation for extending UserCreationForm doesn't work with UserAdmin

[Nathanael Gordon]

In the docs for customising the Auth User model it does not fully outline the link between the UserCreationForm and the UserAdmin - specifically the fact that the UserAdmin's add_fieldsets will be used rather than the fields attribute in the Meta for the custom UserCreationForm.

At the end of this section (​https://docs.djangoproject.com/en/1.11/topics/auth/customizing/#custom-users-and-the-built-in-auth-forms) it specifies that one can simply override the fields in the Meta of one's UserCreationForm. However, as the UserAdmin uses a custom get_fieldsets method which uses its add_fieldsets attribute instead, overriding fields does nothing.

[Hampus Dunström]

I plan to be done with this at the end of October.

[Hampus Dunström]

I'm having a hard time creating a test app with a UserCreationForm for a model based on the django.contrib.auth.admin.UserAdmin class. Is this not the class. Is there any example code anyone can show me?

At the end of this section (​​https://docs.djangoproject.com/en/1.11/topics/auth/customizing/#custom-users-and-the-built-in-auth-forms) it specifies that one can simply override the fields in the Meta of one's UserCreationForm.

Above this example it is stated that it only works if the model is a simple subclass of AbstractUser. Do we want another example for UserAdmin or what are we looking for? Maybe I'm not the right person for this issue, I don't know. If any of you guys know anything or can clarify please let me know.

[Carlton Gibson]

Given the lack of updates I'm going to de-assign this issue so someone else looking can pick it up.

[Mariusz Felisiak]

​PR

[Mariusz Felisiak <felisiak.mariusz@…>]

In c13e3715:

Fixed #28667 -- Clarified how to override list of forms fields for custom UserAdmin with a custom user model.

[Mariusz Felisiak <felisiak.mariusz@…>]

In 7d52d056:

[2.2.x] Fixed #28667 -- Clarified how to override list of forms fields for custom UserAdmin with a custom user model.

Backport of c13e3715f5f46f2ee4ddba357e2589a45e831813 from master