From 18f25efc9ec18e6d5c0ceada2b0349b7117beb77 Mon Sep 17 00:00:00 2001 From: Tim Graham Date: Tue, 19 Aug 2014 07:23:17 -0400 Subject: [PATCH] [1.6.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 8f78c2b4a78..b205f5fda0e 100644 --- a/docs/topics/auth/customizing.txt +++ b/docs/topics/auth/customizing.txt @@ -451,6 +451,8 @@ different User model. class Article(models.Model): author = models.ForeignKey(settings.AUTH_USER_MODEL) +.. _specifying-custom-user-model: + Specifying a custom User model ------------------------------ @@ -691,10 +693,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: