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

[1.5.x] Fixed #19588 - Added create_superuser to UserManager docs. 

Thanks minddust for the report.

Backport of 4da5947a87 from master
This commit is contained in:
Tim Graham 2013-01-10 15:16:25 -05:00
parent b4544dbd5b
commit 72ef63bf86
1 changed files with 11 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
docs/ref/contrib/auth.txt
View File

@ -218,9 +218,10 @@ Manager methods
.. class:: models.UserManager .. class:: models.UserManager
The :class:`~django.contrib.auth.models.User` model has a custom manager The :class:`~django.contrib.auth.models.User` model has a custom manager
that has the following helper methods: that has the following helper methods (in addition to the methods provided
by :class:`~django.contrib.auth.models.BaseUserManager`):
.. method:: create_user(username, email=None, password=None) .. method:: create_user(username, email=None, password=None, **extra_fields)
.. versionchanged:: 1.4 .. versionchanged:: 1.4
The ``email`` parameter was made optional. The username The ``email`` parameter was made optional. The username
@ -240,18 +241,17 @@ Manager methods
:meth:`~django.contrib.auth.models.User.set_unusable_password()` will :meth:`~django.contrib.auth.models.User.set_unusable_password()` will
be called. be called.
The ``extra_fields`` keyword arguments are passed through to the
:class:`~django.contrib.auth.models.User`'s ``__init__`` method to
allow setting arbitrary fields on a :ref:`custom User model
<auth-custom-user>`.
See :ref:`Creating users <topics-auth-creating-users>` for example usage. See :ref:`Creating users <topics-auth-creating-users>` for example usage.
.. method:: make_random_password(length=10, allowed_chars='abcdefghjkmnpqrstuvwxyzABCDEFGHJKLMNPQRSTUVWXYZ23456789') .. method:: create_superuser(self, username, email, password, **extra_fields)
Returns a random password with the given length and given string of Same as :meth:`create_user`, but sets :attr:`~models.User.is_staff` and
allowed characters. (Note that the default value of ``allowed_chars`` :attr:`~models.User.is_superuser` to ``True``.
doesn't contain letters that can cause user confusion, including:
* ``i``, ``l``, ``I``, and ``1`` (lowercase letter i, lowercase
letter L, uppercase letter i, and the number one)
* ``o``, ``O``, and ``0`` (uppercase letter o, lowercase letter o,
and zero)
Anonymous users Anonymous users