Browse files

[1.5.x] Fixed #19394 --Added note about auth forms and custom user mo…

  • Loading branch information...
1 parent f60dd6f commit 1845c53081ecf3800e9fdc261bae7904d859592f @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
@@ -668,6 +668,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
@@ -919,6 +919,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 1845c53

Please sign in to comment.