p31829507
/
django
mirror of https://github.com/django/django.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Fixed #24429 -- Doc'ed that Django 1.8 doesn't require an integer PK for custom user models.

This commit is contained in:
Tim Graham 2015-04-07 10:45:31 -04:00
parent e37d52bd5e
commit 981e3b9394
1 changed files with 7 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
docs/topics/auth/customizing.txt
View File

@ -477,19 +477,22 @@ Specifying a custom User model
Django expects your custom User model to meet some minimum requirements. Django expects your custom User model to meet some minimum requirements.
1. Your model must have an integer primary key. #. Your model must have a single unique field that can be used for
2. Your model must have a single unique field that can be used for
identification purposes. This can be a username, an email address, identification purposes. This can be a username, an email address,
or any other unique attribute. or any other unique attribute.
3. Your model must provide a way to address the user in a "short" and #. Your model must provide a way to address the user in a "short" and
"long" form. The most common interpretation of this would be to use "long" form. The most common interpretation of this would be to use
the user's given name as the "short" identifier, and the user's full the user's given name as the "short" identifier, and the user's full
name as the "long" identifier. However, there are no constraints on name as the "long" identifier. However, there are no constraints on
what these two methods return - if you want, they can return exactly what these two methods return - if you want, they can return exactly
the same value. the same value.
.. versionchanged:: 1.8
Older versions of Django required your model to have an integer primary
key as well.
The easiest way to construct a compliant custom User model is to inherit from The easiest way to construct a compliant custom User model is to inherit from
:class:`~django.contrib.auth.models.AbstractBaseUser`. :class:`~django.contrib.auth.models.AbstractBaseUser`.
:class:`~django.contrib.auth.models.AbstractBaseUser` provides the core :class:`~django.contrib.auth.models.AbstractBaseUser` provides the core