Keyholder role

Jump to: navigation, search

Note: You are currently viewing documentation for Moodle 1.9. Up-to-date documentation for the latest stable version is available here: Keyholder role.

Creating a role of Keyholder allows a user with potentially very limited rights in a course to have access to the enrolment key settings.

  • Note that from Moodle 1.8.3 you can specify the role of the keyholder in the Internal enrolment settings, making this tip effectively redundant (although it will still work as described if the keyholder is not set).

Role set-up

If you have permissions within your Moodle installation to set up new roles:

  1. From the site home page, access Administration > Users > Permissions > Define roles
  2. Click the button "Add a new role". Alternatively, copy an existing role - perhaps a non-editing teacher role
  3. Give the role a name e.g. Keyholder, short name and description
  4. Change the capability moodle/course:update to allow
  5. Click the button "Add a new role"
  6. Use the up arrows in the edit column to move the Keyholder role above the Teacher role in the list
  7. Edit Keyholder role to tighten or loosen permissions. The Keyholder must be allowed to "update course settings"
  8. In Course > Enrolments > Internal edit and set enrol_manual_keyholderrole to the keyholder role you just created selecting it from the dropdown list

Giving users in other roles permission to assign the Keyholder role

If there are other roles within your Moodle installation (e.g. Teacher, Course Creator) who are expected to be able to assign the newly-created Keyholder role, the person creating the Keyholder role should (at the same time as creating the Keyholder role) give them permission to make role assignments.

To do this:

  1. From the site home page, access Administration > Users > Permissions > Define roles
  2. Click the 'Allow Role Assignments' tab
  3. A matrix displays in which the Moodle admin can allow people who have the roles on the left side to assign some of the column roles to other people
  4. Check the appropriate boxes and click Save Changes

To assign the Keyholder role in a course area

  1. Log in, go to the area whose roles you want to (and have permission to) edit
  2. In your Administration Block, click on Assign Roles
  3. Click on Keyholder (or similar)
  4. In the search box under the Potential column, enter the most distinctive part of the name of the person you want to be Keyholder (it can be anybody).
  5. Click on Search.
  6. From the results, click on the appropriate name, and then click the Add button to send them into the Existing column
  7. Repeat as necessary.
  8. Click on the Assign Roles In Course ... button towards the bottom of the page to return to your course area's front page