Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Fixed #8145 - Documented the codenames of the default auth permissions

git-svn-id: http://code.djangoproject.com/svn/django/trunk@11909 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
commit a2ef46316c492cc2c4b2e28bbbf73db3ebc29e1e 1 parent ebb8ca1
@jezdez jezdez authored
Showing with 13 additions and 2 deletions.
  1. +13 −2 docs/topics/auth.txt
View
15 docs/topics/auth.txt
@@ -225,8 +225,9 @@ Methods
.. method:: models.User.has_perm(perm, obj=None)
Returns ``True`` if the user has the specified permission, where perm is
- in the format ``"<app label>.<permission codename>"``.
- If the user is inactive, this method will always return ``False``.
+ in the format ``"<app label>.<permission codename>"``. (see
+ `permissions`_ section below). If the user is inactive, this method will
+ always return ``False``.
.. versionadded:: 1.2
@@ -1122,6 +1123,8 @@ generic view itself. For example::
def limited_object_detail(*args, **kwargs):
return object_detail(*args, **kwargs)
+.. _permissions:
+
Permissions
===========
@@ -1164,6 +1167,14 @@ models being installed at that time. Afterward, it will create default
permissions for new models each time you run :djadmin:`manage.py syncdb
<syncdb>`.
+Assuming you have an application with an
+:attr:`~django.db.models.Options.app_label` ``foo`` and a model named ``Bar``,
+to test for basic permissions you should use:
+
+ * add: ``user.has_perm('foo.add_bar')``
+ * change: ``user.has_perm('foo.change_bar')``
+ * delete: ``user.has_perm('foo.delete_bar')``
+
.. _custom-permissions:
Custom permissions
Please sign in to comment.
Something went wrong with that request. Please try again.