-
Notifications
You must be signed in to change notification settings - Fork 5
Home
Welcome to the moodle-mod_groupformation wiki!
-
To build groups with the plugin you will need the GroupAL algorithm. Go to https://github.com/jkonert/moodle-lib_groupal to download it. Unzip the file and place it in the lib folder of the Moodle directory. Rename it to “groupal” if necessary.
-
Make sure the Moodles cron job is running. You need it to run the GroupAL. Further information about the cron can be found on moodle.org
-
E-Mail function..
Unzip the zip file in the “mod” folder of the Moodle directory and, if necessary, rename the folder to "groupformation". Then visit your Moodle server's Site Administration -> Notifications page and Upgrade Moodles database, -- OR -- Go to Administration > Site Administration > Install add-ons to install the Groupformation module directly from your Moodle installation.
In Moodle start the edit mode and create the Groupformation activity.
(pic)
Choose one of the three scenarios and enter the maximum size or number of groups.
You can include preknowledges which may be important for the activity. Depending on the szenario you have choosen, preknowledges will help to improve the matching of the groups.
After you done all the settings a questionnaire will be created.
When the students completed their questionnaire you can end the activity and start the groupformation algorithm.
(pic) In the "Overview" you can observe how many students:
- assigned to the course
- started to fill out the questionnaire
- completed or submitted the questionnaire
You also can see how long the questionnaire is available to the students and end or start it at any time.
(pic) In the "Group formation" tab you can start the algorithm to forming groups. In the settings you can choose to exclude the student who not answered the questionnaire. Tutors, teachers or other not relevant roles in Moodle assigned to the course are excluded from the group formation.
When you start the algorithm to forming groups, it can take a while till it finishes(depending on server and the number of students it could take up to 30 min). If you wish to, you will be notified by email when the group formation is done.
After the group formation succeeded you can see the preview of the groups and their quality, which is the performance index(GPI). You can edit the groups by moving the students from group to group. If you satisfied with the result you can adopt the groups to Moodle. If not, you can discard the results and start the algorithm again.
(pic)
Here you have a preview of the questionnaire. Your answers will not be saved. Because of your role as a tutor(or similar) you not taking participation in the group formation.
(pic)
In the navigation side bar, which is usually to your right, you can adjust the settings. Some settings will be disabled, as soon as students started to complete the questionnaire. All settings which have no effect to the questionnaire would be still available. Those are for example the group size or number and the time period in which the questionnaire is available to the students.
As a developer you might want to edit the questionnaire content or configure the GroupAL implementation.
For manipulation of the properties and configuration of the questionnaire and GroupAL algorithm, take a look at the define_file.php (https://github.com/jkonert/moodle-mod_groupformation/blob/master/classes/util/define_file.php). You can edit the categories of the questionnaire and the criteria that are used for the GroupAL algorithm.
For manipulation of the questions of each category, take a look at the directory xml_question (https://github.com/jkonert/moodle-mod_groupformation/tree/master/xml_question). You can edit the xml files and add additional categories and languages.
The Groupformation plugin relies on the custom library groupal (https://github.com/jkonert/moodle-lib_groupal) and uses the algorithm in the job_manager.php (https://github.com/jkonert/moodle-mod_groupformation/blob/master/classes/moodle_interface/job_manager.php) file. You can edit the used matcher and implement further algorithm types.