From b3f6a0f5a1b88a9a96080531b7391f6a3a0ce5aa Mon Sep 17 00:00:00 2001 From: Tim Graham Date: Tue, 19 Aug 2014 07:23:17 -0400 Subject: [PATCH] [1.7.x] Fixed #23314 -- Tempered recommendation of storing profile data on custom user. Thanks gavinwahl for the report. Backport of 3569536491 from master --- docs/topics/auth/customizing.txt | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/topics/auth/customizing.txt b/docs/topics/auth/customizing.txt index 0248d8048f..1e9d0ed5c9 100644 --- a/docs/topics/auth/customizing.txt +++ b/docs/topics/auth/customizing.txt @@ -447,6 +447,8 @@ different User model. :setting:`AUTH_USER_MODEL` setting in code that is executed at import time. ``get_user_model()`` only works once Django has imported all models. +.. _specifying-custom-user-model: + Specifying a custom User model ------------------------------ @@ -694,10 +696,12 @@ Extending Django's default User ------------------------------- If you're entirely happy with Django's :class:`~django.contrib.auth.models.User` -model and you just want to add some additional profile information, you can +model and you just want to add some additional profile information, you could simply subclass ``django.contrib.auth.models.AbstractUser`` and add your -custom profile fields. This class provides the full implementation of the -default :class:`~django.contrib.auth.models.User` as an :ref:`abstract model +custom profile fields, although we'd recommend a separate model as described in +the "Model design considerations" note of :ref:`specifying-custom-user-model`. +``AbstractUser`` 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: