Group self-selection module: Difference between revisions

Latest revision as of 14:50, 20 March 2018

The Group selection activity module allows students to select a group in the course that they want to be members of. Groupless students can create new groups (optional feature). Supervisors may be randomly assigned to groups. Group data is exportable as a CSV-file.

Background

The first versions of such functionality appeared already for Moodle 1.4. Versions up to 2.1 have been written by Petr Škoda and Helen Foster with the help of other developers. For version 3.0 Pirkka Pyykkönen did also alot of development.

Settings

The activity has a number of options available when adding to a course

General

Open from (default disabled) - Selections can only be made after this time
Open until (default disabled) - Selections can only be made before this time
Select groups from grouping (default all groups) - Restrict the groups that are shown to students to a certain grouping, also specifies the grouping of student created groups
Min members per group (default 0) - Minimum number of members per group, adds notifications for members of groups which are under this limit
Max members per group (default 0) - Maximum number of members per group, 0 for unlimited
Maximum number of groups to participate in (default 1) - Maximum number of groups to participate in. 0 means that no participation is possible

General permissions

Participants can join groups (default enabled) - The role capabilities can be set further over permissions
Participants can leave groups (default enabled) - The role capabilities can be set further over permissions
Participants can create groups (default enabled) - Participants without a group (in the selected grouping) can create groups. The role capabilities can be set further over permissions
Participants can set the name of new groups (default enabled)
Participants can set and edit group description (default enabled) - Participants can set a group description when creating a group and group members can edit the description
Participants can set and edit group description (default disabled)

Miscellaneous settings

Assign supervisors to groups (default disabled) - Enables a button which assigns non-editing teachers to groups (if course has non-editing teachers)
Supervisor role (default non-editing teacher) - Set the role for the supervisors, which will be assigned
Show assigned supervisors (default disabled) - Show assigned supervisors in group member listings (so students know who their assigned teacher is)
Hide full groups from the main view (default disabled) - Hide all groups, which have reached max member count, from the main list view
Show message, if the open until date is reached - Displays a message when the due date has been reached
Delete group when last student leaves (default enabled) - Automatically delete a group if last student leaves from it

Common module setting

Group mode - No groups, Visible groups means that group members are visible to everyone on the course, Separate groups means that students only see their own groups members (recommended)

Capabilities

Capability	Description	Default enabled roles
mod/groupselect:addinstance	Allow adding a new group self-selection	editingteacher, manager
mod/groupselect:assign	Allow to assign supervisors to groups	editingteacher, manager
mod/groupselect:create	Allow creating of groups	student, editingteacher, manager
mod/groupselect:export	Allow export of group members	editingteacher, manager
mod/groupselect:select	Allow to join groups	student, teacher, editingteacher, manager
mod/groupselect:unselect	Allow leaving of groups	student, teacher, editingteacher, manager

Usage as a student

As default, student may have access to four actions in the main view: (s)he may create a group, become a member of a group, leave a group, or edit groups description

Selecting and leaving of a group is done by pressing the corresponding button in Action column for the desired group
Creating/selecting is only possible if the student is not a member of a group (in the selected grouping). When creating a group, student can set a password for the group to prevent unwanted members from joining. Password protected groups have a lock icon displayed in the main view

Clicking own groups description text sets it editable (if Students can set and edit group description is enabled), OK saves changes and clicking elsewhere discards changes

If the activity has Min members per group setting enabled, red warning icons are displayed for every group not satisfying this limit, also the members of such a group have a text notification displayed at notifications area

Usage as a teacher

Teacher has a couple of possible actions: CSV-export and assigning supervisors. Per default he also got the possibility to see the buttons to join, leave or create groups if enabled.
Exporting group data as a CSV-file is done by clicking corresponging button on the main view. This creates a download link, which can then be clicked to initiate download. A row represents one group in the CSV-file and the values are comma separated. Latest Excel and Libreoffice software should manage to open the file directly, if not, try different separator and character set options
Assigning supervisors to groups is possible if corresponding setting is enabled and the course has participants with the corresponding role for supervisors. Pressing the assignment button divides the groups randomly and evenly to supervisors. Assignment is reversible and can be redone. If students should know their assigned person, it is recommended to enable setting "Show assigned supervisors", otherwise the assignments show up only in the export file

Addional Features

The Groupselect can also be used to show the participants in which groups they are in. For this the permissions in the setting of the groupselect to join, leave or create groups can be removed.

Installation

Download and unpack the activity folder. Place the folder (eg "groupselect") in the "mod" subdirectory. Visit http://yoursite.com/admin to complete the installation Turn editing on in any home or course page. Add the activity to the page

Group self-selection module
Type	Activity
Set	N/A
Downloads	https://moodle.org/plugins/mod_groupselect
Issues	https://github.com/BLC-HTWChur/moodle-mod_groupselect/issues
Discussion	https://moodle.org/plugins/mod_groupselect
Maintainer(s)	Roger Barras

@@ Line 1: / Line 1: @@
-The Group selection activity module allows students to select a group in the course that they want to be members of. Groupless students can create new groups (optional feature). Non-editing teachers may be randomly assigned to groups. Group data is exportable as a CSV-file.
+{{Infobox plugin
+|type = Activity
+|entry = https://moodle.org/plugins/mod_groupselect
+|tracker = https://github.com/BLC-HTWChur/moodle-mod_groupselect/issues
+|discussion = https://moodle.org/plugins/mod_groupselect
+|maintainer = [[User:Roger Barras|Roger Barras]]
+|float = right
+}}
+The Group selection activity module allows students to select a group in the course that they want to be members of. Groupless students can create new groups (optional feature). Supervisors may be randomly assigned to groups. Group data is exportable as a CSV-file.
-( Maximum and minimum limits for the number of students in a group may be set. The activity can also be set to open and close at specific times.)
+==Background==
+The first versions of such functionality appeared already for Moodle 1.4. Versions up to 2.1 have been written by Petr Škoda and Helen Foster with the help of other developers. For version 3.0 Pirkka Pyykkönen did also alot of development.
-==Background==
+==Settings==
-The first versions of such functionality appeared already for Moodle 1.4. Versions up to 2.1 have been written by Petr Škoda and Helen Foster with the help of other developers. The most recent 3.0 version is developed by Pirkka Pyykkönen.
+The activity has a number of options available when adding to a course
+===General===
+* Open from (default disabled) - Selections can only be made after this time
+* Open until (default disabled) - Selections can only be made before this time
+* Select groups from grouping (default all groups) - Restrict the groups that are shown to students to a certain grouping, also specifies the grouping of student created groups
+* Min members per group (default 0) - Minimum number of members per group, adds notifications for members of groups which are under this limit
+* Max members per group (default 0) - Maximum number of members per group, 0 for unlimited
+* Maximum number of groups to participate in (default 1) - Maximum number of groups to participate in. 0 means that no participation is possible
+===General permissions===
+* Participants can join groups (default enabled) - The role capabilities can be set further over permissions
+* Participants can leave groups (default enabled) - The role capabilities can be set further over permissions
+* Participants can create groups (default enabled) - Participants without a group (in the selected grouping) can create groups. The role capabilities can be set further over permissions
+* Participants can set the name of new groups (default enabled)
+* Participants can set and edit group description (default enabled) - Participants can set a group description when creating a group and group members can edit the description
+* Participants can set and edit group description (default disabled)
+===Miscellaneous settings===
+* Assign supervisors to groups (default disabled) - Enables a button which assigns non-editing teachers to groups (if course has non-editing teachers)
+* Supervisor role (default non-editing teacher) - Set the role for the supervisors, which will be assigned
+* Show assigned supervisors (default disabled) - Show assigned supervisors in group member listings (so students know who their assigned teacher is)
+* Hide full groups from the main view (default disabled) - Hide all groups, which have reached max member count, from the main list view
+* Show message, if the open until date is reached - Displays a message when the due date has been reached
+* Delete group when last student leaves (default enabled) - Automatically delete a group if last student leaves from it
+===Common module setting===
+* Group mode - No groups, Visible groups means that group members are visible to everyone on the course, Separate groups means that students only see their own groups members (recommended)
+<br>
+[[Image:groupselect_setting_small_new.png|Activity Settings]]
+<br>
-==Features==
+==Capabilities==
-There are two global settings:
+{| cellpadding="3" cellspacing="0" border="1"
-* Require activity description (default Yes) - if disabled users do not need to enter a description for each activity<br>
+!Capability
-* Max members per group (default 0) - if enabled this sets a numeric limit for group sizes, 0 being unlimited
+!Description
+!Default enabled roles
+|-
+|mod/groupselect:addinstance
+|Allow adding a new group self-selection
+|editingteacher, manager
+|-
+|-
+|mod/groupselect:assign
+|Allow to assign supervisors to groups
+|editingteacher, manager
+|-
+|mod/groupselect:create
+|Allow creating of groups
+|student, editingteacher, manager
+|-
+|mod/groupselect:export
+|Allow export of group members
+|editingteacher, manager
+|-
+|mod/groupselect:select
+|Allow to join groups
+|student, teacher, editingteacher, manager
+|-
+|mod/groupselect:unselect
+|Allow leaving of groups
+|student, teacher, editingteacher, manager
+|}
-[[Image:Activity-group-self-selection-global-settings.png|Global Settings]]
+==Usage as a student==
-The activity has a number of options available when adding to a course
+* As default, student may have access to four actions in the main view: (s)he may create a group, become a member of a group, leave a group, or edit groups description
-* Select group from grouping (Default all groups) - you can restrict the groups that are shown to students if you have them in a certain grouping
+<br>
-* Require password (default none) - you can set a password that is required to confirm a group selection
+[[Image:groupselect_studentview_new.png|Groupless students view]]
-* Max members per group (default 0) - if enabled this sets a numeric limit for group sizes, 0 being unlimited
+<br>
-* Open from (default disabled) - if enabled selections can only be made after this time
+* Selecting and leaving of a group is done by pressing the corresponding button in Action column for the desired group
-* Open until (default disabled) - if enabled selections can only be made before this time
+* Creating/selecting is only possible if the student is not a member of a group (in the selected grouping). When creating a group, student can set a password for the group to prevent unwanted members from joining. Password protected groups have a lock icon displayed in the main view
+<br>
+[[Image:groupselect_create_new.png|Group creation]]
+<br>
+* Clicking own groups description text sets it editable (if Students can set and edit group description is enabled), OK saves changes and clicking elsewhere discards changes
 <br>
-[[Image:groupselect_setting_small.png|Activity Settings2]]
+[[Image:groupselect_edit_new.png|Editing description]]
-[[Image:Activity-group-self-selection-add.png|Activity Settings]]
 <br>
-==Usage==
+* If the activity has Min members per group setting enabled, red warning icons are displayed for every group not satisfying this limit, also the members of such a group have a text notification displayed at notifications area
-* When a student is faced with the activity they just need to click on the correct button to select a group
 <br>
-[[Image:Activity-group-self-selection-student-select.png|Activity Settings]]
+[[Image:groupselect_mainview_new.png|Main view]]
 <br>
-* If a password has been set they will be faced with a password page to confirm before the selection is complete
+==Usage as a teacher==
+* Teacher has a couple of possible actions: CSV-export and assigning supervisors. Per default he also got the possibility to see the buttons to join, leave or create groups if enabled.
+* Exporting group data as a CSV-file is done by clicking corresponging button on the main view. This creates a download link, which can then be clicked to initiate download. A row represents one group in the CSV-file and the values are comma separated. Latest Excel and Libreoffice software should manage to open the file directly, if not, try different separator and character set options
+* Assigning supervisors to groups is possible if corresponding setting is enabled and the course has participants with the corresponding role for supervisors. Pressing the assignment button divides the groups randomly and evenly to supervisors. Assignment is reversible and can be redone. If students should know their assigned person, it is recommended to enable setting "Show assigned supervisors", otherwise the assignments show up only in the export file
 <br>
-[[Image:Activity-group-self-selection-password.png|Password prompt]]
+[[Image:groupselect_teachersview_small_new.png|Teachers view with assigned supervisors visible]]
 <br>
+=== Addional Features ===
+The Groupselect can also be used to show the participants in which groups they are in. For this the permissions in the setting of the groupselect to join, leave or create groups can be removed.
 ==Installation==
@@ Line 42: / Line 116: @@
 ==See also==
-*[http://moodle.org/plugins/view.php?plugin=mod_groupselect  Group Self-selection] is a Modules and plugins database page that has download
+*[https://moodle.org/plugins/mod_groupselect  Group Self-selection] Module home page
 [[Category:Contributed code]]
+[[de:PlugIn Freie Gruppeneinteilung]]
+[[es:Módulo de auto-selección de grupo]]
 [[fr:self selection]]

Documentation