Enrolment key

Jump to: navigation, search

Note: You are currently viewing documentation for Moodle 3.1. Up-to-date documentation for the latest stable version of Moodle is probably available here: Enrolment key.

Why use an enrolment key?

Self enrolment with keyholder role set
A course enrolment (or enrollment) key is one method of restricting Self enrolment to a smaller group. The default setting is not to set a key and allow anyone to enrol themselves into the course.

An enrolment key is often used as a simple method of having someone else beside the teacher determine if a particular student can self enrol in the course. The idea is that one or more people will supply the course key to authorized people. Sometimes this distribution is private email, snail mail, on the phone or even verbally in a face to face meetings such as a class or counselor's office. Alternatively, a Keyholder role may be created and assigned, then the text 'You should have received this enrolment key from...' will be displayed when a student attempts to enrol.

Setting an enrolment key within a course

Editing the self enrolment method
  1. In the course administration block, click Users > Enrolment methods
  2. Make sure self enrolment is enabled (has its eye open) and then click the edit icon on the right.
  3. Add your enrolment key in the box provided. (Click Unmask to see what you are typing.)
  4. Click the 'Save changes' button.
Adding an enrolment key

Setting a group enrolment key

  • It is possible also to enrol students into the course and also directly into groups by use of a group enrolment key.
  • To do this, you first need to add the course enrolment key as in the section above.
    • If you do not set a master course enrolment key for the course, then anyone can enrol without a key and users will not be put into groups.
    • Users in groups do not need to know the master course enrolment key, only their own group enrolment key.
    • Users not in a group can use the master course enrolment key as usual
  • Change the setting Use group enrolment keys to Yes
  • Save the changes and then in the Course administration settings, click Groups>Create groups
  • Add an enrolment key to the group. This will be the key they type in to access the course. (The course enrolment key is simply there to keep others out)

Note: Be careful not to use the same enrolment key for more than one group! A warning message will appear 'This enrolment key is already used for another group.'

Admin settings

Making an enrolment key required in every course

  • By default, enrolment keys are not set. However, if the administrator wants to ensure all teachers set enrolment keys then this can be forced in Administration>Site Administration>Plugins>Enrolments>Self enrolment This means that self enrolment settings will not "stick" until the teacher adds an enrolment key. NOTE: It does NOT provide a site wide enrolment key.

Using the password policy for enrolment keys

  • To ensure that teachers use secure keys that follow your Moodle's password policy, check the box in Administration>Site Administration>Plugins>Enrolments>Self enrolment

Giving users a hint of the enrolment key

  • By default, for security reasons, Moodle will not give any clues as to what the enrolment key is. Checking the box in Administration>Site Administration>Plugins>Enrolments>Self enrolment will provide the first letter of the enrolment key if needed.

Tips and Tricks

  • If the enrolment key for a course "gets out" and unwanted people self enrol:
    • Change the key. Currently enrolled students will not need the key again.
    • Unenrol the unwanted users via Enrolled_users in the course administration block.
  • Changing or placing a key does not impact currently enrolled students, nor does it impact students who may also be enrolled by an enrolment plugin.
  • Guests may (optionally) be required to supply the enrolment key (as specified on the Course Settings page). They will be required to supply the code every time they enter the course.
  • The "No" or "Date range" options in the "Course available" setting effectively disables the enrolment key feature, even if it is set.

See also