Commit cf49f62b authored by Jannis Leidel's avatar Jannis Leidel
Browse files

[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
parent 7d6213e0

docs/topics/auth.txt

+13 −2
Original line number Diff line number Diff line
@@ -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 ``"<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``.



    .. 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

<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