Note: You are currently viewing documentation for Moodle 1.9. Up-to-date documentation for the latest stable version is available here: Capabilities/moodle/category:manage.

Capabilities/moodle/category:manage

From MoodleDocs
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Moodle1.9

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 create, update and delete course categories.
  • 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 visiblility, 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.)

05012012 In order to get Category:Manage to work I needed to give the user "Manage Blocks on Page" (this was Moodle 2.0 and 2.1) as well. If I did not, the user was unable to "Category:Manage".

Legacy Role Default Settings

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