innov
/
django1
1
0
Fork 0
Code Issues Pull Requests 1 Projects Releases Wiki Activity

[1.2.X] Fixed #13503 -- Corrected misleading custom permission example in the docs. 

Thanks Daniel Moisset for the report.

Backport of [14403] from trunk

git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.2.X@14404 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Ramiro Morales 2010-10-31 02:35:18 +00:00
parent 29ea1bef21
commit 20c6f3f3d1
1 changed files with 11 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
docs/topics/auth.txt
View File

@ -1181,19 +1181,23 @@ Custom permissions
To create custom permissions for a given model object, use the ``permissions`` To create custom permissions for a given model object, use the ``permissions``
:ref:`model Meta attribute <meta-options>`. :ref:`model Meta attribute <meta-options>`.
This example model creates three custom permissions:: This example Task model creates three custom permissions, i.e., actions users
can or cannot do with Task instances, specific to your appication::
class USCitizen(models.Model): class Task(models.Model):
# ... ...
class Meta: class Meta:
permissions = ( permissions = (
("can_drive", "Can drive"), ("can_view", "Can see available tasks"),
("can_vote", "Can vote in elections"), ("can_change_status", "Can change the status of tasks"),
("can_drink", "Can drink alcohol"), ("can_close", "Can remove a task by setting its status as closed"),
) )
The only thing this does is create those extra permissions when you run The only thing this does is create those extra permissions when you run
:djadmin:`manage.py syncdb <syncdb>`. :djadmin:`manage.py syncdb <syncdb>`. Your code is in charge of checking the
value of these permissions when an user is trying to access the functionality
provided by the application (viewing tasks, changing the status of tasks,
closing tasks.)
API reference API reference
------------- -------------