mirror of https://github.com/django/django.git
[2.0.x] Fixed #28131 -- Corrected examples of using attribute lookups on the "perms" template variable.
Backport of 51d7feff87
from master
This commit is contained in:
parent
6e2ace8c4e
commit
41009788a0
|
@ -1655,21 +1655,20 @@ The currently logged-in user's permissions are stored in the template variable
|
||||||
``django.contrib.auth.context_processors.PermWrapper``, which is a
|
``django.contrib.auth.context_processors.PermWrapper``, which is a
|
||||||
template-friendly proxy of permissions.
|
template-friendly proxy of permissions.
|
||||||
|
|
||||||
In the ``{{ perms }}`` object, single-attribute lookup is a proxy to
|
Evaluating a single-attribute lookup of ``{{ perms }}`` as a boolean is a proxy
|
||||||
:meth:`User.has_module_perms <django.contrib.auth.models.User.has_module_perms>`.
|
to :meth:`User.has_module_perms()
|
||||||
This example would display ``True`` if the logged-in user had any permissions
|
<django.contrib.auth.models.User.has_module_perms>`. For example, to check if
|
||||||
in the ``foo`` app::
|
the logged-in user has any permissions in the ``foo`` app::
|
||||||
|
|
||||||
{{ perms.foo }}
|
{% if perms.foo %}
|
||||||
|
|
||||||
Two-level-attribute lookup is a proxy to
|
Evaluating a two-level-attribute lookup as a boolean is a proxy to
|
||||||
:meth:`User.has_perm <django.contrib.auth.models.User.has_perm>`. This example
|
:meth:`User.has_perm() <django.contrib.auth.models.User.has_perm>`. For example,
|
||||||
would display ``True`` if the logged-in user had the permission
|
to check if the logged-in user has the permission ``foo.can_vote``::
|
||||||
``foo.can_vote``::
|
|
||||||
|
|
||||||
{{ perms.foo.can_vote }}
|
{% if perms.foo.can_vote %}
|
||||||
|
|
||||||
Thus, you can check permissions in template ``{% if %}`` statements:
|
Here's a more complete example of checking permissions in a template:
|
||||||
|
|
||||||
.. code-block:: html+django
|
.. code-block:: html+django
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue