Enrolment key: Difference between revisions

From MoodleDocs
(enrollment key overview and step-by-step editing)
 
(Why use an enrolment key? keyholder role, image positioning)
 
(37 intermediate revisions by 15 users not shown)
Line 1: Line 1:
== About ==
{{Course enrolment}}
A course enrollment key is what keeps unwanted people out of your course.
==Why use an enrolment key?==
[[File:keyholder2.png|thumb|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.


If you leave this blank, then anyone who has created a Moodle username on this site will be able to enroll in your course simply by going in to it.
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.


If you put something here, then students who are trying to get in for the FIRST TIME ONLY will be asked to supply this word or phrase.
==Setting an enrolment key within a course==
[[File:enrolmentkeyupdated.png|thumb|Editing the self enrolment method]]
# In the course administration block, click ''Users > Enrolment methods''
# Make sure self enrolment is enabled (has its eye open) and then click the edit icon on the right.
# Add your enrolment key in the box provided. (Click ''Unmask'' to see what you are typing.)
# Click the 'Save changes' button.
[[File:selfenrolkey.png|thumb|Adding an enrolment key]]


The idea is that you will supply the key to authorized people using another means like private email, snail mail, on the phone or even verbally in a face to face class.
==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)


If this password "gets out" and you have unwanted people enrolling, you can unenroll them (see their user profile page) and change this key. Any legitimate students who have already enrolled will not be affected, but the unwanted people won't be able to get back in.
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==


== Function ==
===Making an enrolment key required in every course===
The enrol(l)ment key is a Moodle setting that any teacher or admin user can set on a course by course basis. It is an integral security function that can control which Moodle site users are able to enrol(l) themselves as students in the course. To locate and use this setting:
*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.


1. '''Login''' to Moodle as an admin or teacher user.
===Using the password policy for enrolment keys===
2. '''Navigate''' to the desired course.
*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''
3. Locate the '''Administration''' block and click on '''Settings'''.
 
4. Scroll down and locate the '''Enrollment key''' form field.
===Giving users a hint of the enrolment key===
5. Enter your desired key in the adjacent text field.
 
6. Scroll to the bottom of the page and click '''Save changes'''.
*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.
**[[Unenrolment |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 plugins|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==
 
* [[Keyholder role]]
* [http://www.youtube.com/user/UsingMoodle?feature=mhum#p/u/0/4xzF7xerle0 Group enrolment keys in Moodle 2.0 video]
 
[[de:Einschreibeschlüssel]]
[[fr:Clef d'inscription]]
[[pl:Klucz rekrutacyjny]]
[[ja:登録キー]]
[[es:Clave de inscripción]]

Latest revision as of 08:48, 26 September 2016

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