mirror of
https://github.com/django/django.git
synced 2025-08-04 10:59:45 +00:00
Fixed #26124 -- Added missing code formatting to docs headers.
This commit is contained in:
parent
8bf8d0e0ec
commit
a6ef025dfb
93 changed files with 1658 additions and 1625 deletions
|
@ -289,8 +289,8 @@ example, the following checks if a user may view tasks::
|
|||
|
||||
.. _extending-user:
|
||||
|
||||
Extending the existing User model
|
||||
=================================
|
||||
Extending the existing ``User`` model
|
||||
=====================================
|
||||
|
||||
There are two ways to extend the default
|
||||
:class:`~django.contrib.auth.models.User` model without substituting your own
|
||||
|
@ -360,8 +360,8 @@ the extra database load.
|
|||
|
||||
.. _auth-custom-user:
|
||||
|
||||
Substituting a custom User model
|
||||
================================
|
||||
Substituting a custom ``User`` model
|
||||
====================================
|
||||
|
||||
Some kinds of projects may have authentication requirements for which Django's
|
||||
built-in :class:`~django.contrib.auth.models.User` model is not always
|
||||
|
@ -414,8 +414,8 @@ use as your User model.
|
|||
:class:`~django.db.models.OneToOneField` to ``settings.AUTH_USER_MODEL``
|
||||
as described below.
|
||||
|
||||
Referencing the User model
|
||||
--------------------------
|
||||
Referencing the ``User`` model
|
||||
------------------------------
|
||||
|
||||
.. currentmodule:: django.contrib.auth
|
||||
|
||||
|
@ -462,8 +462,8 @@ different User model.
|
|||
|
||||
.. _specifying-custom-user-model:
|
||||
|
||||
Specifying a custom User model
|
||||
------------------------------
|
||||
Specifying a custom ``User`` model
|
||||
----------------------------------
|
||||
|
||||
.. admonition:: Model design considerations
|
||||
|
||||
|
@ -716,8 +716,8 @@ utility methods:
|
|||
* ``o``, ``O``, and ``0`` (lowercase letter o, uppercase letter o,
|
||||
and zero)
|
||||
|
||||
Extending Django's default User
|
||||
-------------------------------
|
||||
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 could
|
||||
|
@ -875,16 +875,16 @@ methods and attributes:
|
|||
(the Django app label). If the user is inactive, this method will
|
||||
always return ``False``.
|
||||
|
||||
.. admonition:: ModelBackend
|
||||
.. admonition:: ``PermissionsMixin`` and ``ModelBackend``
|
||||
|
||||
If you don't include the
|
||||
:class:`~django.contrib.auth.models.PermissionsMixin`, you must ensure you
|
||||
don't invoke the permissions methods on ``ModelBackend``. ``ModelBackend``
|
||||
assumes that certain fields are available on your user model. If your User
|
||||
model doesn't provide those fields, you will receive database errors when
|
||||
you check permissions.
|
||||
assumes that certain fields are available on your user model. If your
|
||||
``User`` model doesn't provide those fields, you will receive database
|
||||
errors when you check permissions.
|
||||
|
||||
Custom users and Proxy models
|
||||
Custom users and proxy models
|
||||
-----------------------------
|
||||
|
||||
One limitation of custom User models is that installing a custom User model
|
||||
|
|
|
@ -17,8 +17,8 @@ are somewhat coupled.
|
|||
|
||||
.. _user-objects:
|
||||
|
||||
User objects
|
||||
============
|
||||
``User`` objects
|
||||
================
|
||||
|
||||
:class:`~django.contrib.auth.models.User` objects are the core of the
|
||||
authentication system. They typically represent the people interacting with
|
||||
|
@ -112,7 +112,7 @@ passwords.
|
|||
Changing a user's password will log out all their sessions. See
|
||||
:ref:`session-invalidation-on-password-change` for details.
|
||||
|
||||
Authenticating Users
|
||||
Authenticating users
|
||||
--------------------
|
||||
|
||||
.. function:: authenticate(\**credentials)
|
||||
|
@ -363,13 +363,14 @@ If you have an authenticated user you want to attach to the current session
|
|||
:func:`~django.contrib.auth.login()`. Now you can set the backend using
|
||||
the new ``backend`` argument.
|
||||
|
||||
Selecting the :ref:`authentication backend <authentication-backends>`
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
Selecting the authentication backend
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
When a user logs in, the user's ID and the backend that was used for
|
||||
authentication are saved in the user's session. This allows the same
|
||||
authentication backend to fetch the user's details on a future request. The
|
||||
authentication backend to save in the session is selected as follows:
|
||||
:ref:`authentication backend <authentication-backends>` to fetch the user's
|
||||
details on a future request. The authentication backend to save in the session
|
||||
is selected as follows:
|
||||
|
||||
#. Use the value of the optional ``backend`` argument, if provided.
|
||||
#. Use the value of the ``user.backend`` attribute, if present. This allows
|
||||
|
@ -1673,7 +1674,7 @@ model. Groups can be created, and permissions can be assigned to users or
|
|||
groups. A log of user edits to models made within the admin is also stored and
|
||||
displayed.
|
||||
|
||||
Creating Users
|
||||
Creating users
|
||||
--------------
|
||||
|
||||
You should see a link to "Users" in the "Auth"
|
||||
|
@ -1695,7 +1696,7 @@ non-superuser the ability to edit users, this is ultimately the same as giving
|
|||
them superuser status because they will be able to elevate permissions of
|
||||
users including themselves!
|
||||
|
||||
Changing Passwords
|
||||
Changing passwords
|
||||
------------------
|
||||
|
||||
User passwords are not displayed in the admin (nor stored in the database), but
|
||||
|
|
|
@ -74,8 +74,8 @@ setting.
|
|||
|
||||
.. _bcrypt_usage:
|
||||
|
||||
Using bcrypt with Django
|
||||
------------------------
|
||||
Using ``bcrypt`` with Django
|
||||
----------------------------
|
||||
|
||||
Bcrypt_ is a popular password storage algorithm that's specifically designed
|
||||
for long-term password storage. It's not the default used by Django since it
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue