Refs #27807 -- Removed docs for User.username_validator.
The new override functionality claimed in refs #21379 doesn't work.
Forwardport of 714fdbaa70
from stable/1.10.x.
This commit is contained in:
parent
d0315584b5
commit
c84b91b760
|
@ -38,8 +38,7 @@ Fields
|
||||||
usernames. Although it wasn't a deliberate choice, Unicode
|
usernames. Although it wasn't a deliberate choice, Unicode
|
||||||
characters have always been accepted when using Python 3. Django
|
characters have always been accepted when using Python 3. Django
|
||||||
1.10 officially added Unicode support in usernames, keeping the
|
1.10 officially added Unicode support in usernames, keeping the
|
||||||
ASCII-only behavior on Python 2, with the option to customize the
|
ASCII-only behavior on Python 2.
|
||||||
behavior using :attr:`.User.username_validator`.
|
|
||||||
|
|
||||||
.. attribute:: first_name
|
.. attribute:: first_name
|
||||||
|
|
||||||
|
@ -137,24 +136,6 @@ Attributes
|
||||||
:attr:`~django.contrib.auth.models.User.is_authenticated` to this
|
:attr:`~django.contrib.auth.models.User.is_authenticated` to this
|
||||||
attribute.
|
attribute.
|
||||||
|
|
||||||
.. attribute:: username_validator
|
|
||||||
|
|
||||||
Points to a validator instance used to validate usernames. Defaults to
|
|
||||||
:class:`validators.UnicodeUsernameValidator`.
|
|
||||||
|
|
||||||
To change the default username validator, you can subclass the ``User``
|
|
||||||
model and set this attribute to a different validator instance. For
|
|
||||||
example, to use ASCII usernames::
|
|
||||||
|
|
||||||
from django.contrib.auth.models import User
|
|
||||||
from django.contrib.auth.validators import ASCIIUsernameValidator
|
|
||||||
|
|
||||||
class CustomUser(User):
|
|
||||||
username_validator = ASCIIUsernameValidator()
|
|
||||||
|
|
||||||
class Meta:
|
|
||||||
proxy = True # If no new field is added.
|
|
||||||
|
|
||||||
Methods
|
Methods
|
||||||
-------
|
-------
|
||||||
|
|
||||||
|
|
|
@ -60,12 +60,11 @@ wasn't a deliberate choice, Unicode characters have always been accepted when
|
||||||
using Python 3.
|
using Python 3.
|
||||||
|
|
||||||
The username validator now explicitly accepts Unicode characters by
|
The username validator now explicitly accepts Unicode characters by
|
||||||
default on Python 3 only. This default behavior can be overridden by changing
|
default on Python 3 only.
|
||||||
the :attr:`~django.contrib.auth.models.User.username_validator` attribute of
|
|
||||||
the ``User`` model, or to any proxy of that model, using either
|
Custom user models may use the new
|
||||||
:class:`~django.contrib.auth.validators.ASCIIUsernameValidator` or
|
:class:`~django.contrib.auth.validators.ASCIIUsernameValidator` or
|
||||||
:class:`~django.contrib.auth.validators.UnicodeUsernameValidator`. Custom user
|
:class:`~django.contrib.auth.validators.UnicodeUsernameValidator`.
|
||||||
models may also use those validators.
|
|
||||||
|
|
||||||
Minor features
|
Minor features
|
||||||
--------------
|
--------------
|
||||||
|
|
Loading…
Reference in New Issue