Capabilities/moodle/category:manage: Difference between revisions

From MoodleDocs
(New page: This capability was introduced in Moodle 1.9.4 to replace the separate capabilities moodle/category:create, moodle/category:update and moodle/category:delete. *This allows a user to creat...)
 
m (typo fix)
 
(8 intermediate revisions by 6 users not shown)
Line 1: Line 1:
This capability was introduced in Moodle 1.9.4 to replace the separate capabilities moodle/category:create, moodle/category:update and moodle/category:delete.
{{Capabilities}}
 
*This allows a user to create, update and delete [[Course categories|course categories]].
*This allows a user to create, update and delete course categories.
*The default role of [[Manager]] has this capability set to allow.
*This capability may only be applied in the system context, or in category context, to allow management of subcategories.
*This capability may only be applied in the system context, or in category context, to allow management of subcategories


The exact rules enforced for various actions are: (Remember that the parent of a given category may be either the system context, or another category.)
The exact rules enforced for various actions are: (Remember that the parent of a given category may be either the system context, or another category.)
Line 10: Line 10:
#* to view hidden courses, you need [[Capabilities/moodle/course:viewhiddencourses|moodle/course:viewhiddencourses]], and
#* to view hidden courses, you need [[Capabilities/moodle/course:viewhiddencourses|moodle/course:viewhiddencourses]], and
#* to see hidden categories you need [[Capabilities/moodle/category:viewhiddencategories|moodle/category:viewhiddencategories]]
#* to see hidden categories you need [[Capabilities/moodle/category:viewhiddencategories|moodle/category:viewhiddencategories]]
# To update a category's name, description, and/or visiblility, you need moodle/category:manage in the category itself.
# To update a category's name, description, and/or visibility, you need moodle/category:manage in the category itself.
# To move a category from one place in the tree to another, you need moodle/category:manage in both the old and new parent categories (and you are not allowed to move a category to be a descendant of itself!)
# To move a category from one place in the tree to another, you need moodle/category:manage in both the old and new parent categories (and you are not allowed to move a category to be a descendant of itself!)
# To delete a category, you need moodle/category:manage in the parent category and the category itself. In addition, if the category or any of its subcategories contains any courses you need either:
# To delete a category, you need moodle/category:manage in the parent category and the category itself. In addition, if the category or any of its subcategories contains any courses you need either:
#* moodle/course:delete in all of those courses, and moodle/category:manage in all of the child categories, or
#* [[Capabilities/moodle/course:delete|moodle/course:delete]] in all of those courses, and moodle/category:manage in all of the child categories, or
#* moodle/course:create and moodle/category:manage in some other category that is not a child of this one. (Except that, if this category contains no sub-categories, we don't check moodle/category:manage in the other category.)
#* [[Capabilities/moodle/course:create|moodle/course:create]] and moodle/category:manage in some other category that is not a child of this one. (Except that, if this category contains no sub-categories, we don't check moodle/category:manage in the other category.)
 
====Legacy Role Default Settings====
 
{| border="1" cellspacing="0" cellpadding="2"
|-
! Legacy Role !! Inherit !! Allow !! Prevent !! Prohibit
|-
| Administrator || - || X || - || -
|-
| Course Creator || X || - || - || -
|-
| Teacher || X || - || - || -
|-
| Non-editing Teacher || X || - || - || -
|-
| Student || X || - || - || -
|-
| Guest || X || - || - || -
|-
| Authenticated User || X || - || - || -
|}
 
==See also==
 
*[[Add/edit course categories]]


[[Category:Capabilities|Category]]
[[Category:Capabilities|Category]]
[[Category:Course]]
[[Category:Course]]


 
[[fr:Capabilities/moodle/category:manage]]
[[eu:Capabilities/moodle/category:create]]

Latest revision as of 15:15, 9 August 2012

  • This allows a user to create, update and delete course categories.
  • The default role of Manager has this capability set to allow.
  • This capability may only be applied in the system context, or in category context, to allow management of subcategories

The exact rules enforced for various actions are: (Remember that the parent of a given category may be either the system context, or another category.)

  1. To add a new category, you need moodle/category:manage in the parent of the category you are adding to.
  2. To browse a category and the courses it contains, you don't normally need any special capabilities, except that
  3. To update a category's name, description, and/or visibility, you need moodle/category:manage in the category itself.
  4. To move a category from one place in the tree to another, you need moodle/category:manage in both the old and new parent categories (and you are not allowed to move a category to be a descendant of itself!)
  5. To delete a category, you need moodle/category:manage in the parent category and the category itself. In addition, if the category or any of its subcategories contains any courses you need either:
    • moodle/course:delete in all of those courses, and moodle/category:manage in all of the child categories, or
    • moodle/course:create and moodle/category:manage in some other category that is not a child of this one. (Except that, if this category contains no sub-categories, we don't check moodle/category:manage in the other category.)