Note: You are currently viewing documentation for Moodle 3.0. Up-to-date documentation for the latest stable version of Moodle may be available here: Enrolment key.

Enrolment key: Difference between revisions

From MoodleDocs
(reformat, some edits, more links)
(changes copied from 31 docs)
 
(23 intermediate revisions by 10 users not shown)
Line 1: Line 1:
A course enrolment (or enrollment) key is one method to restrict [[Internal enrolment]] (student self enrolments) to a smaller group. The default setting is not to set a key.
{{Course enrolment}}
==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.


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 distrubution 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.
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 ==
==Setting an enrolment key within a course==
The enrolment key is a Moodle setting that any teacher or admin user can set on a course by course basis.  
[[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]]


To locate and use this setting:
==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)


# Login to Moodle as an admin or teacher
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.'
# Navigate to the desired course
# Locate the Course Administration block
# Click on Settings in that block
# Scroll down and locate the Enrolment key field
# Enter the key in the adjacent text field ("bratwurst" in the example)
# Scroll to the bottom of the page and click "Save changes"


[[Image:Enrollmentkey.png|frame|center|The enrolment key area in course settings]]
==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==
==Tips and Tricks==


*If the enrolment key for a course "gets out" and unwanted people self enrol,
*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
**Change the key. Currently enrolled students will not need the key again.
**[[Unenrolment |Unenrol]] the users via Assign roles or via the student's profile.(see their user profile page) and change this key
**[[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]]
*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
* 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
* The "No" or "Date range" options in the "Course available" setting effectively disables the enrolment key feature, even if it is set.


==See also==
==See also==


*[[Internal enrolment]] - to set the role of the people who hold the course enrolment key
* [[Keyholder role]]
*[[Create group]] - for information on setting group enrolment keys
* [http://www.youtube.com/user/UsingMoodle?feature=mhum#p/u/0/4xzF7xerle0 Group enrolment keys in Moodle 2.0 video]
*[[Keyholder role]] - for an administrator to set the person named as holding the course enrolment key
 
 
[[Category:Teacher]]
[[Category:Enrolment]]


[[de:Einschreibeschlüssel]]
[[fr:Clef d'inscription]]
[[fr:Clef d'inscription]]
[[pl:Klucz rekrutacyjny]]
[[pl:Klucz rekrutacyjny]]
[[ja:登録キー]]
[[ja:登録キー]]
[[es:Clave de inscripción]]

Latest revision as of 08:49, 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