Browse files

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

  • Loading branch information...
1 parent 8503120 commit d5462596478992075fd04705fedd6a3cca49fae8 @benkonrath benkonrath committed with ptone Feb 24, 2013
Showing with 10 additions and 0 deletions.
  1. +2 −0 docs/topics/auth/customizing.txt
  2. +8 −0 docs/topics/auth/default.txt
@@ -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
+.. _custom-users-and-the-built-in-auth-forms:
Custom users and the built-in auth forms
@@ -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
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
A form used in the admin interface to change a user's password.

0 comments on commit d546259

Please sign in to comment.