Fixed #19394 --Added note about auth forms and custom user models.

This commit is contained in:
Ben Konrath 2013-02-24 15:43:56 +01:00 committed by Preston Holmes
parent 8503120c10
commit d546259647
2 changed files with 10 additions and 0 deletions

View File

@ -674,6 +674,8 @@ custom profile fields. This class provides the full implementation of the
default :class:`~django.contrib.auth.models.User` as an :ref:`abstract model default :class:`~django.contrib.auth.models.User` as an :ref:`abstract model
<abstract-base-classes>`. <abstract-base-classes>`.
.. _custom-users-and-the-built-in-auth-forms:
Custom users and the built-in auth forms Custom users and the built-in auth forms
---------------------------------------- ----------------------------------------

View File

@ -926,6 +926,14 @@ If you don't want to use the built-in views, but want the convenience of not
having to write forms for this functionality, the authentication system having to write forms for this functionality, the authentication system
provides several built-in forms located in :mod:`django.contrib.auth.forms`: provides several built-in forms located in :mod:`django.contrib.auth.forms`:
.. note::
The built-in authentication forms make certain assumptions about the user
model that they are working with. If you're using a :ref:`custom User model
<auth-custom-user>`, it may be necessary to define your own forms for the
authentication system. For more information, refer to the documentation
about :ref:`using the built-in authentication forms with custom user models
<custom-users-and-the-built-in-auth-forms>`.
.. class:: AdminPasswordChangeForm .. class:: AdminPasswordChangeForm
A form used in the admin interface to change a user's password. A form used in the admin interface to change a user's password.