Participants: Difference between revisions

From MoodleDocs
({{Course enrolment}})
 
(27 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Course enrolment}}
{{Course enrolment}}
{{New features}}The Participants page enables teachers to easily enrol, view, search for, filter, edit and delete course participants.
==About==
The Participants link 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.
The Participants link can be accessed from Course navigation in the [[Boost theme]] or the Administration block in other themes.
 
{{MediaPlayer | url = https://youtu.be/jj_ynDPpHBk | desc = 3.4 Participants and Enrolments Page}}


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


[[File:NewEnrolUsers.png]]
[[File:UsersEnrol.png]]
==Filtering and searching for users==
 


==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'. If country is selected as a user identity field form  Site administration > User policies, participants may be filtered by country.
The filter at the top left of the screen allows for filtering by period of activity, enrolment method, group, role and status:
 
[[File:Filters39+.png]]


[[File:ParticipantsFilter.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==
==Roles==
Line 21: Line 29:
*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==
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 (e.g. manual/cohort sync) both are displayed in the status column:
[[File: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.


==Bulk editing and deleting users==
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.
Course participants may be selected in the boxes on the left and then, from the menu at the bottom, edited or deleted in bulk:


[[File:BulkEditDeleteUsers.png]]
[[File:Participants dropdown options.png|alt=]]
==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.


At the course level:
# From Course navigation, click Participants and from the dropdown, select Permissions
# Filter by viewparticipants
# 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.
[[fr:Participants]]
[[es:Participantes]]
[[es:Participantes]]
[[de:Teilnehmer/innen]]
[[de:Teilnehmer/innen]]
[[it:Partecipanti]]

Latest revision as of 19:33, 28 August 2023

About

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

The Participants link can be accessed from Course navigation in the Boost theme or the Administration block in other themes.

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'. 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 (e.g. 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. From Course navigation, click Participants and from the dropdown, 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.