Skip to content
Browse files

Fixed #13503 -- Corrected misleading custom permission example in the…

… docs.

Thanks Daniel Moisset for the report.

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
1 parent fa8f0cb commit 429473a5229e18980541458ff85d148163dd8a07 @ramiro ramiro committed
Showing with 11 additions and 7 deletions.
  1. +11 −7 docs/topics/auth.txt
18 docs/topics/auth.txt
@@ -1197,19 +1197,23 @@ Custom permissions
To create custom permissions for a given model object, use the ``permissions``
: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:
permissions = (
- ("can_drive", "Can drive"),
- ("can_vote", "Can vote in elections"),
- ("can_drink", "Can drink alcohol"),
+ ("can_view", "Can see available tasks"),
+ ("can_change_status", "Can change the status of tasks"),
+ ("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
-:djadmin:` syncdb <syncdb>`.
+:djadmin:` 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

0 comments on commit 429473a

Please sign in to comment.
Something went wrong with that request. Please try again.