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

Participants: Difference between revisions

From MoodleDocs
 
(3 intermediate revisions by 2 users not shown)
Line 4: Line 4:


The Participants page can be accessed from the navigation drawer in the [[Boost theme]] or the Administration block in other themes. It can also be accessed from the More link in the gear menu, by clicking Enrolled users in the Users tab.
The Participants page can be accessed from the navigation drawer in the [[Boost theme]] or the Administration block in other themes. It can also be accessed from the More link in the gear menu, by clicking Enrolled users in the Users tab.
{{MediaPlayer | url = https://youtu.be/EoUqSxYLO4Q | desc = Participants filtering}}
==Enrolling users==
Users may be enrolled from the Enrol users button at the top right and bottom right of the screen.


{{MediaPlayer | url = https://youtu.be/EoUqSxYLO4Q | desc = Participants filtering}}
[[File:UsersEnrol.png]]
==Filtering and searching for users==


==Enrolling users==
Users may be enrolled from the Enrol users button at the top right and bottom right of the screen.


[[File:NewEnrolUsers.png]]
The filter at the top left of the screen allows for filtering by period of activity, enrolment method, group, roles, status and keyword. More than one may be selected, with the option to filter 'Any' or 'All'


==Filtering and searching for users==
'''New in 3.11:''' If country is selected as a user identity field form  Site administration > User policies, participants may be filtered by country.


Note that this section currently describes how filtering worked in Moodle up to 3.8. To see how filtering works since Moodle 3.9, please watch the video above.


The filter at the top left of the screen allows for filtering by period of activity, enrolment method, group, role and status:


[[File:ParticipantsFilter.png]]
[[File:Filters39+.png]]


You can also search users by any of the fields defined in the "Show user identity" setting. Some of the searchable fields, such as username, first name and last name, allow you to use wildcards to represent one or more characters. There are two wildcards:
You can also search users by any of the fields defined in the "Show user identity" setting. Some of the searchable fields, such as username, first name and last name, allow you to use wildcards to represent one or more characters. There are two wildcards:
* % The percent sign represents zero, one, or multiple characters
* % The percent sign represents zero, one, or multiple characters
* _ The underscore represents a single character (Note: MS Access uses a question mark '?' instead of the underscore '_').
* _ The underscore represents a single character (Note: MS Access uses a question mark '?' instead of the underscore '_').
These wildcards can be escaped, if needed, to search users containing them, using a backslash '\':
These wildcards can be escaped, if needed, to search users containing them, using a backslash '\':
* A_B will find all the users starting with an A, followed by any character and then B (i.e. AxB or A2B, but not AxxB).
* A_B will find all the users starting with an A, followed by any character and then B (i.e. AxB or A2B, but not AxxB).
* A\_B will find users starting exactly with 'A_B'.
* A\_B will find users starting exactly with 'A_B'.
It is possible to bulk select, edit and delete users who have self enrolled, in a similar way to users who have been enrolled manually.
It is possible to bulk select, edit and delete users who have self enrolled, in a similar way to users who have been enrolled manually.


Line 35: Line 33:
*Only roles which can be assigned in the course context type are available to select. The course context type may be set by an admin by editing the role via Site administration > Users > Permissions > Define roles.
*Only roles which can be assigned in the course context type are available to select. The course context type may be set by an admin by editing the role via Site administration > Users > Permissions > Define roles.
*Only roles which a user is allowed to assign are available to select.
*Only roles which a user is allowed to assign are available to select.
==Groups==
==Groups==
To add a user to a group (requires at least one group to have been created previously), click the pencil icon in the Groups column, select the group and then click the save icon to confirm the change.
To add a user to a group (requires at least one group to have been created previously), click the pencil icon in the Groups column, select the group and then click the save icon to confirm the change.


[[File:NewGroupSelect.png]]
[[File:NewGroupSelect.png]]
==Status==
==Status==
The status column shows the current status of a user's enrolments, for example Active or Suspended. Where a user has two different enrolment types (eg manual/cohort sync) both are displayed in the status column:
The status column shows the current status of a user's enrolments, for example Active or Suspended. Where a user has two different enrolment types (eg manual/cohort sync) both are displayed in the status column:


[[File:Statuscolumn.png]]
[[File:Statuscolumn.png]]
==City/town or country==
==City/town or country==
Users' city/town or country may be displayed for users with the capability moodle/site:viewuseridentity (by default manager, teacher and non-editing teacher) by selecting these fields in 'Show user identity' in [[User policies]] in the Site administration.
Users' city/town or country may be displayed for users with the capability moodle/site:viewuseridentity (by default manager, teacher and non-editing teacher) by selecting these fields in 'Show user identity' in [[User policies]] in the Site administration.
 
==Sending a message, adding a note, downloading or editing enrolments==
==Sending a message, adding a note, or editing manual or self enrolments==
You can send a message, add a note, download the data or edit or delete selected manual user enrolments via the dropdown menu below the list of course participants.
 
You can send a message, add a note, or edit or delete selected manual user enrolments via the dropdown menu below the list of course participants.


Note that only users who were previously manually or self enrolled can have their enrolment edited or deleted in bulk. The enrolment for users who enrolled using a different enrolment method, may be edited or deleted for a user via the edit enrolment link (cog icon) in the status column.
Note that only users who were previously manually or self enrolled can have their enrolment edited or deleted in bulk. The enrolment for users who enrolled using a different enrolment method, may be edited or deleted for a user via the edit enrolment link (cog icon) in the status column.


[[File:BulkEditDeleteUsers.png]]
[[File:Participants dropdown options.png|alt=]]
 
==Hiding the list of participants==
==Hiding the list of participants==
If required, you can use the capability [[Capabilities/moodle/course:viewparticipants|View participants]] to prevent students from viewing the list of participants.
If required, you can use the capability [[Capabilities/moodle/course:viewparticipants|View participants]] to prevent students from viewing the list of participants.


At the course level:
At the course level:
# On the Participants page from the actions menu (cog icon) select Permissions
# On the Participants page from the actions menu (cog icon) select Permissions
# Filter by viewparticipants  
# Filter by viewparticipants  
# For the capability 'View participants' remove the student role and confirm.
# For the capability 'View participants' remove the student role and confirm.
At site level, the 'View participants' capability can be unset for the role of student.
At site level, the 'View participants' capability can be unset for the role of student.
[[fr:Participants]]
[[fr:Participants]]
[[es:Participantes]]
[[es:Participantes]]
[[de:Teilnehmer/innen]]
[[de:Teilnehmer/innen]]
[[it:Partecipanti]]
[[it:Partecipanti]]

Latest revision as of 19:34, 28 August 2023

About

The Participants page enables teachers to easily enrol, view, search for, filter, edit and delete course participants.

The Participants page can be accessed from the navigation drawer in the Boost theme or the Administration block in other themes. It can also be accessed from the More link in the gear menu, by clicking Enrolled users in the Users tab.

Participants filtering

Enrolling users

Users may be enrolled from the Enrol users button at the top right and bottom right of the screen.

UsersEnrol.png

Filtering and searching for users

The filter at the top left of the screen allows for filtering by period of activity, enrolment method, group, roles, status and keyword. More than one may be selected, with the option to filter 'Any' or 'All'

New in 3.11: If country is selected as a user identity field form Site administration > User policies, participants may be filtered by country.


Filters39+.png

You can also search users by any of the fields defined in the "Show user identity" setting. Some of the searchable fields, such as username, first name and last name, allow you to use wildcards to represent one or more characters. There are two wildcards:

  • % The percent sign represents zero, one, or multiple characters
  • _ The underscore represents a single character (Note: MS Access uses a question mark '?' instead of the underscore '_').

These wildcards can be escaped, if needed, to search users containing them, using a backslash '\':

  • A_B will find all the users starting with an A, followed by any character and then B (i.e. AxB or A2B, but not AxxB).
  • A\_B will find users starting exactly with 'A_B'.

It is possible to bulk select, edit and delete users who have self enrolled, in a similar way to users who have been enrolled manually.

Roles

  • To assign an enrolled user a role, click the pencil icon in the Roles column then select the desired role and click the save icon to confirm the change.
  • To remove a role assignment, click the delete icon (a cross) next to the role name.
  • Only roles which can be assigned in the course context type are available to select. The course context type may be set by an admin by editing the role via Site administration > Users > Permissions > Define roles.
  • Only roles which a user is allowed to assign are available to select.

Groups

To add a user to a group (requires at least one group to have been created previously), click the pencil icon in the Groups column, select the group and then click the save icon to confirm the change.

NewGroupSelect.png

Status

The status column shows the current status of a user's enrolments, for example Active or Suspended. Where a user has two different enrolment types (eg manual/cohort sync) both are displayed in the status column:

Statuscolumn.png

City/town or country

Users' city/town or country may be displayed for users with the capability moodle/site:viewuseridentity (by default manager, teacher and non-editing teacher) by selecting these fields in 'Show user identity' in User policies in the Site administration.

Sending a message, adding a note, downloading or editing enrolments

You can send a message, add a note, download the data or edit or delete selected manual user enrolments via the dropdown menu below the list of course participants.

Note that only users who were previously manually or self enrolled can have their enrolment edited or deleted in bulk. The enrolment for users who enrolled using a different enrolment method, may be edited or deleted for a user via the edit enrolment link (cog icon) in the status column.

Hiding the list of participants

If required, you can use the capability View participants to prevent students from viewing the list of participants.

At the course level:

  1. On the Participants page from the actions menu (cog icon) select Permissions
  2. Filter by viewparticipants
  3. For the capability 'View participants' remove the student role and confirm.

At site level, the 'View participants' capability can be unset for the role of student.