From cf49f62be369996c845e7229d1801739473acc00 Mon Sep 17 00:00:00 2001 From: Jannis Leidel Date: Tue, 22 Dec 2009 14:37:24 +0000 Subject: [PATCH] [1.1.X] Fixed #8145 - Documented the codenames of the default auth permissions git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.1.X@11948 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/topics/auth.txt | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/docs/topics/auth.txt b/docs/topics/auth.txt index 6a62be8c32..29d8f161be 100644 --- a/docs/topics/auth.txt +++ b/docs/topics/auth.txt @@ -212,8 +212,9 @@ Methods .. method:: models.User.has_perm(perm) Returns ``True`` if the user has the specified permission, where perm is - in the format ``"."``. - If the user is inactive, this method will always return ``False``. + in the format ``"."``. (see + `permissions`_ section below). If the user is inactive, this method will + always return ``False``. .. method:: models.User.has_perms(perm_list) @@ -1091,6 +1092,8 @@ generic view itself. For example:: def limited_object_detail(*args, **kwargs): return object_detail(*args, **kwargs) +.. _permissions: + Permissions =========== @@ -1133,6 +1136,14 @@ models being installed at that time. Afterward, it will create default permissions for new models each time you run :djadmin:`manage.py 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