View source

Creating a role of '''Keyholder''' allows a user with potentially very limited rights in a course to have access to the [[Enrolment key|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:

#From the site home page, access ''Administration > Users > Permissions > Define roles''
#Click the button "Add a new role". Alternatively, [[Manage_roles#Creating_a_duplicate_role|copy an existing role]] - perhaps a non-editing teacher role
#Give the role a name e.g. Keyholder, short name and description
#Change the capability [[Capabilities/moodle/course:update|moodle/course:update]] to allow
#Click the button "Add a new role"
#Use the up arrows in the edit column to move the Keyholder role above the Teacher role in the list
#Edit Keyholder role to tighten or loosen [[Manage_roles#Permissions|permissions]].  The Keyholder must be allowed to "update course settings"

==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:
#From the site home page, access ''Administration > Users > Permissions > Define roles''
#Click the 'Allow Role Assignments' tab
#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
#Check the appropriate boxes and click Save Changes

==To assign the Keyholder role in a course area==

# Log in, go to the area whose roles you want to (and have permission to) edit
# In your Administration Block, click on Assign Roles
# Click on Keyholder (or similar)
# 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).
# Click on Search.
# From the results, click on the appropriate name, and then click the Add button to send them into the Existing column
# Repeat as necessary.
# Click on the Assign Roles In Course ... button towards the bottom of the page to return to your course area's front page

[[Category:Roles]]

[[fr:Rôle gardien de clé]]
[[ja:キー保持者ロール]]
[[de:Kursschlüsselverwalter-Rolle]]