Changelog

All notable changes to this project will be documented in this file.

5.1.1 (2026062400)

• Fix: restore require_once($CFG->libdir/formslib.php) in the manage form, resolving the Class "moodleform" not found exception on the manage auto group enrol page

5.1.0 (2026032100)

• Tested and verified on Moodle 5.1


• Updated supported version range to Moodle 4.5 - 5.1


• Updated README to uniform LdesignMedia format


• Added SECURITY.md and CHANGELOG.md

5.0.0 (2025072900)

• Added support for Moodle 5.0

4.5.0 (2024091000)

• Moodle 4.5 and PHP 8.1 stable release


• GDPR implementation


• Per-course enable/disable option


• Choice to auto-enrol in all existing groups or specific ones

4.4.0

• Moodle 4.4 version

4.3.0

• Moodle 4.3 version

4.2.1

• Fix issue #2 - Increased size of groupslist column

4.2.0

• Moodle 4.2 and PHP 8.0/8.1 version

3.9.0

• Moodle 3.9 and PHP 7.2 support


• Moodle 4.0 and PHP 7.4 support


• Moodle 4.1 and PHP 8.0 support

1.1.2

• Stable version as admin tool plugin for Moodle 3.x

1.1.1

• Stable version as local plugin for Moodle 2.x

1.1

• Initial stable version

Changelog

All notable changes to this project will be documented in this file.

5.1.0 (2026032100)

• Tested and verified on Moodle 5.1


• Updated supported version range to Moodle 4.5 - 5.1


• Updated README to uniform LdesignMedia format


• Added SECURITY.md and CHANGELOG.md

5.0.0 (2025072900)

• Added support for Moodle 5.0

4.5.0 (2024091000)

• Moodle 4.5 and PHP 8.1 stable release


• GDPR implementation


• Per-course enable/disable option


• Choice to auto-enrol in all existing groups or specific ones

4.4.0

• Moodle 4.4 version

4.3.0

• Moodle 4.3 version

4.2.1

• Fix issue #2 - Increased size of groupslist column

4.2.0

• Moodle 4.2 and PHP 8.0/8.1 version

3.9.0

• Moodle 3.9 and PHP 7.2 support


• Moodle 4.0 and PHP 7.4 support


• Moodle 4.1 and PHP 8.0 support

1.1.2

• Stable version as admin tool plugin for Moodle 3.x

1.1.1

• Stable version as local plugin for Moodle 2.x

1.1

• Initial stable version

Moodle tool for automatically enrolling students into course groups

In brief, groupautoenrol randomly assigns students to course groups when they are
enrolled in a course (via any enrollment method: auto-enrol by key, cohort sync, or manual enrolment).

• Author: Pascal M, https://github.com/pascal-my


• Author: Luuk Verhoeven LdesignMedia


• Author: Gemma Lesterhuis LTNC B.V.


• Min. required: Moodle 3.9


• Supports PHP: 7.4

Features

Core Functionality

• Automatically enrolls students into groups when they join a course


• Works with all enrollment methods (manual, self-enrollment, cohort sync)


• Random assignment to ensure balanced group distribution


• Per-course configuration

Technical Details

• Uses \core\event\user_enrolment_created (user_enrolled) Moodle event


• Safely handles deleted groups (ignores them during assignment)


• GDPR compliant implementation


• Admin tool plugin architecture for better integration

Configuration Options

• Enable/disable plugin per course


• Choose to auto-enrol in all existing groups or specific ones


• Course-level management through "Course administration > Users > Auto-enrol in groups"

Installation

1. Copy this plugin to the admin/tool/groupautoenrol folder on the server


2. Login as administrator


3. Go to Site Administrator > Notification


4. Install the plugin


5. Create groups in your course(s)


6. Enable the plugin for specific courses via "Course administration > Users > Auto-enrol in groups"

Note: The "Auto-enrol in groups" link appears even if the plugin is not enabled for the course.

Testing the Plugin

1. Create test groups: Navigate to a course and create multiple groups via Course administration > Participants >
   Groups


2. Enable auto-enrollment: Go to Course administration > Users > Auto-enrol in groups and enable the feature


3. Test enrollment methods:
   
   
   
   • Manual enrollment: Add users manually and verify group assignment
   
   
   • Self-enrollment: Have users self-enroll using an enrollment key
   
   
   • Cohort sync: Add users via cohort synchronization
   
   
   
   


4. Verify results: Check Course administration > Participants > Groups to confirm users were randomly assigned

Compatibility

• Tested with Moodle 3.9 - 5.0


• PHP 7.4, 8.0, 8.1 support


• Previous versions available for older Moodle releases

Version History

• 5.0.0: Added support for Moodle 5.0


• 4.5.0: Moodle 4.5 & PHP 8.1 version (stable release, June 2024)


• 4.4.0: Moodle 4.4 version


• 4.3.0: Moodle 4.3 version


• 4.2.1: Fix issue #2 - Increased size of groupslist column


• 4.2.0: Moodle 4.2 & PHP 8.0/8.1 version


• 3.9.0: Moodle 3.9 & PHP 7.2 | Moodle 4.0 & PHP 7.4 | Moodle 4.1 & PHP 8.0


• 1.1.2: Stable version as admin tool plugin for Moodle 3.x


• 1.1.1: Stable version as local plugin for Moodle 2.x (
  see moodle-local_groupautoenrol)


• 1.1: Initial stable version (had bugs)

Key Features in 4.5.0

• GDPR implementation


• Per-course enable/disable option


• Choice to auto-enrol in all existing groups or specific ones

Bug and Problem Support

This plugin is carefully developed and thoroughly tested, but bugs and problems can always appear.
If you discover any security related issues, please email support@ldesignmedia.nl instead of using the
issue tracker.

Please bear in mind that bug and problem support is not free of charge. This is with the exception of developers that
report and suggest a solution by creating a pull request.

Feature Proposals

We are aware that members of the community will have other needs and would love to see them solved by this plugin. We
are always interested to read about your feature proposals or even get a pull request from you, but please understand
that we handle these as feature proposals and not as feature requests that we commit to implementing.

License

Group Auto Enrol code is provided freely as open source software, under version 3 of the GNU General Public License.

Contributing

Contributions are welcome and will be fully credited. We accept contributions via Pull Requests on GitHub.

Credits

• @copyright 2016 Pascal


• @author Pascal M - https://github.com/pascal-my


• @author LTNC - https://ltnc.nl


• @author Luuk Verhoeven - https://github.com/luukverhoeven

Moodle-admin_tool_groupautoenrol

Version 4.5.0 (stable version) for Moodle 4.5

Plugin to randomly auto enrol students in Moodle courses groups when they are enrolled into the course (whatever the enrol methods : auto-enrol by key, cohorts sync or manual enrol)

Things to know :

• The plugin uses \core\event\user_enrolment_created (user_enrolled) Moodle event


• If a selected group is deleted, the plugin will ignore it.

In this stable version (4.5.0) :

• GDPR implementation


• you can choose to enable the plugin in each course


• you can choose to auto-enrol students in all existing course or specific ones

Compatibility :

• Tested with Moodle 4.5 and PHP 8.1


• Another version of the plugin exist and works with Moodle 2.5 and 2.7 (I did not test it with the others versions but should work with all 2.x).
  It's a local plugin because adding link into "Course administration" menu was not possible for admin tool before Moodle 3.0
  You can get it here : https://github.com/pascal-my/moodle-local_groupautoenrol/tree/STABLE

Installation

• Copy the directory 'groupautoenrol' into the moodledir/admin/tool directory.


• Connect to moodle as an administrator and install the plugin.


• Go to a course, create at least one group


• Enable the plugin for the course with the new link "Course administration > Users > Auto-enrol in groups"
  Note : this link appears even if the plugin is not enabled for the course

Credits

• @copyright 2016 Pascal


• @author Pascal M - https://github.com/pascal-my


• @author Luuk Verhoeven - https://github.com/luukverhoeven

From Moodle 3.9 onwards this plugin will be maintained by Gemma Lesterhuis, Lesterhuis Training & Consultancy - https://ltnc.nl/
Donations for continuous support are welcome.
https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=Y5DQB9F8AJBKJ&source=url

Version history :

• 1.1 : stable version not working (bug)


• 1.1.1 : stable version working as local plugin for Moodle 2.x (see https://github.com/pascal-my/moodle-local_groupautoenrol)


• 1.1.2 : stable version working as admin tool plugin for Moodle 3.x


• 3.9.0 : Moodle 3.9 & PHP7.2 version | Moodle 4.0 & PHP 7.4 version | Moodle 4.1 & PHP 8.0 version


• 4.2.0 : Moodle 4.2 & PHP 8.0 version


• 4.2.1 : Fix (https://github.com/Lesterhuis-Training-en-Consultancy/moodle-tool_groupautoenrol/issues/2) Increase size of groupslist col #2


• 4.2.0 : Moodle 4.2 & PHP 8.1 version


• 4.3.0 : Moodle


• 4.4.0 : Moodle


• 4.5.0 : Moodle 4.5 & PHP 8.1 version

Moodle-admin_tool_groupautoenrol

Version 4.4.0 (stable version) for Moodle 3.9.0 to 4.4

Plugin to randomly auto enrol students in Moodle courses groups when they are enrolled into the course (whatever the enrol methods : auto-enrol by key, cohorts sync or manual enrol)

Things to know :

• The plugin uses \core\event\user_enrolment_created (user_enrolled) Moodle event


• If a selected group is deleted, the plugin will ignore it.

In this stable version (4.4.0) :

• GDPR implementation


• you can choose to enable the plugin in each course


• you can choose to auto-enrol students in all existing course or specific ones

Compatibility :

• Tested with Moodle 3.9, Moodle 4.2, Moodle 4.3 and Moodle 4.4


• Another version of the plugin exist and works with Moodle 2.5 and 2.7 (I did not test it with the others versions but should work with all 2.x).
  It's a local plugin because adding link into "Course administration" menu was not possible for admin tool before Moodle 3.0
  You can get it here : https://github.com/pascal-my/moodle-local_groupautoenrol/tree/STABLE

Installation

• Copy the directory 'groupautoenrol' into the moodledir/admin/tool directory.


• Connect to moodle as an administrator and install the plugin.


• Go to a course, create at least one group


• Enable the plugin for the course with the new link "Course administration > Users > Auto-enrol in groups"
  Note : this link appears even if the plugin is not enabled for the course

Credits

• @copyright 2016 Pascal


• @author Pascal M - https://github.com/pascal-my


• @author Luuk Verhoeven - https://github.com/luukverhoeven

From Moodle 3.9 onwards this plugin will be maintained by Gemma Lesterhuis, Lesterhuis Training & Consultancy - https://ltnc.nl/
Donations for continuous support are welcome.
https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=Y5DQB9F8AJBKJ&source=url

Version history :

• 1.1 : stable version not working (bug)


• 1.1.1 : stable version working as local plugin for Moodle 2.x (see https://github.com/pascal-my/moodle-local_groupautoenrol)


• 1.1.2 : stable version working as admin tool plugin for Moodle 3.x


• 3.9.0 : Moodle 3.9 & PHP7.2 version | Moodle 4.0 & PHP 7.4 version | Moodle 4.1 & PHP 8.0 version


• 4.2.0 : Moodle 4.2 & PHP 8.0 version


• 4.2.1 : Fix (https://github.com/Lesterhuis-Training-en-Consultancy/moodle-tool_groupautoenrol/issues/2) Increase size of groupslist col #2


• 4.2.0 : Moodle 4.2 & PHP 8.1 version


• 4.3.0 : Moodle


• 4.4.0 : Moodle

Moodle-admin_tool_groupautoenrol

Version 4.2.0 (stable version) for Moodle 3.9.0 to 4.2

Plugin to randomly auto enrol students in Moodle courses groups when they are enrolled into the course (whatever the enrol methods : auto-enrol by key, cohorts sync or manual enrol)

Things to know :

• The plugin uses \core\event\user_enrolment_created (user_enrolled) Moodle event


• If a selected group is deleted, the plugin will ignore it.

In this stable version (3.9.0) :

• GDPR implementation


• you can choose to enable the plugin in each course


• you can choose to auto-enrol students in all existing course or specific ones

Compatibility :

• Tested with Moodle 3.9 and Moodle 4.2


• Another version of the plugin exist and works with Moodle 2.5 and 2.7 (I did not test it with the others versions but should work with all 2.x).
  It's a local plugin because adding link into "Course administration" menu was not possible for admin tool before Moodle 3.0
  You can get it here : https://github.com/pascal-my/moodle-local_groupautoenrol/tree/STABLE

Installation

• Copy the directory 'groupautoenrol' into the moodledir/admin/tool directory.


• Connect to moodle as an administrator and install the plugin.


• Go to a course, create at least one group


• Enable the plugin for the course with the new link "Course administration > Users > Auto-enrol in groups"
  Note : this link appears even if the plugin is not enabled for the course

Credits

• @copyright 2016 Pascal


• @author Pascal M - https://github.com/pascal-my


• @author Luuk Verhoeven - https://github.com/luukverhoeven

From Moodle 3.9 onwards this plugin will be maintained by Gemma Lesterhuis, Lesterhuis Training & Consultancy - https://ltnc.nl/
Donations for continuous support are welcome.
https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=Y5DQB9F8AJBKJ&source=url

Version history :

• 1.1 : stable version not working (bug)


• 1.1.1 : stable version working as local plugin for Moodle 2.x (see https://github.com/pascal-my/moodle-local_groupautoenrol)


• 1.1.2 : stable version working as admin tool plugin for Moodle 3.x


• 3.9.0 : Moodle 3.9 & PHP7.2 version | Moodle 4.0 & PHP 7.4 version | Moodle 4.1 & PHP 8.0 version


• 4.2.0 : Moodle 4.2 & PHP 8.0 version


• 4.2.1 : Fix (https://github.com/Lesterhuis-Training-en-Consultancy/moodle-tool_groupautoenrol/issues/2) Increase size of groupslist col #2

Moodle-admin_tool_groupautoenrol

Version 4.2.0 (stable version) for Moodle 3.9.0 to 4.2

Plugin to randomly auto enrol students in Moodle courses groups when they are enrolled into the course (whatever the enrol methods : auto-enrol by key, cohorts sync or manual enrol)

Things to know :

• The plugin uses \core\event\user_enrolment_created (user_enrolled) Moodle event


• If a selected group is deleted, the plugin will ignore it.

In this stable version (3.9.0) :

• GDPR implementation


• you can choose to enable the plugin in each course


• you can choose to auto-enrol students in all existing course or specific ones

Compatibility :

• Tested with Moodle 3.9 and Moodle 4.2


• Another version of the plugin exist and works with Moodle 2.5 and 2.7 (I did not test it with the others versions but should work with all 2.x).
  It's a local plugin because adding link into "Course administration" menu was not possible for admin tool before Moodle 3.0
  You can get it here : https://github.com/pascal-my/moodle-local_groupautoenrol/tree/STABLE

Installation

• Copy the directory 'groupautoenrol' into the moodledir/admin/tool directory.


• Connect to moodle as an administrator and install the plugin.


• Go to a course, create at least one group


• Enable the plugin for the course with the new link "Course administration > Users > Auto-enrol in groups"
  Note : this link appears even if the plugin is not enabled for the course

Credits

• @copyright 2016 Pascal


• @author Pascal M - https://github.com/pascal-my


• @author Luuk Verhoeven - https://github.com/luukverhoeven

From Moodle 3.9 onwards this plugin will be maintained by Gemma Lesterhuis, Lesterhuis Training & Consultancy - https://ltnc.nl/
Donations for continuous support are welcome.
https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=Y5DQB9F8AJBKJ&source=url

Version history :

• 1.1 : stable version not working (bug)


• 1.1.1 : stable version working as local plugin for Moodle 2.x (see https://github.com/pascal-my/moodle-local_groupautoenrol)


• 1.1.2 : stable version working as admin tool plugin for Moodle 3.x


• 3.9.0 : Moodle 3.9 & PHP7.2 version | Moodle 4.0 & PHP 7.4 version | Moodle 4.1 & PHP 8.0 version


• 4.2.0 : Moodle 4.2 & PHP 8.0 version

Moodle-admin_tool_groupautoenrol

Version 3.9.0 (stable version) for Moodle 3.9.0

Plugin to randomly auto enrol students in Moodle courses groups when they are enrolled into the course (whatever the enrol methods : auto-enrol by key, cohorts sync or manual enrol)

Things to know :

• The plugin uses \core\event\user_enrolment_created (user_enrolled) Moodle event


• If a selected group is deleted, the plugin will ignore it.

In this stable version (3.9.0) :

• GDPR implementation


• you can choose to enable the plugin in each course


• you can choose to auto-enrol students in all existing course or specific ones

Compatibility :

• Tested with Moodle 3.9 en 4.0


• Another version of the plugin exist and works with Moodle 2.5 and 2.7 (I did not test it with the others versions but should work with all 2.x).
  It's a local plugin because adding link into "Course administration" menu was not possible for admin tool before Moodle 3.0
  You can get it here : https://github.com/pascal-my/moodle-local_groupautoenrol/tree/STABLE

Installation

• Copy the directory 'groupautoenrol' into the moodledir/admin/tool directory.


• Connect to moodle as an administrator and install the plugin.


• Go to a course, create at least one group


• Enable the plugin for the course with the new link "Course administration > Users > Auto-enrol in groups"
  Note : this link appears even if the plugin is not enabled for the course

Credits

• @copyright 2016 Pascal


• @author Pascal M - https://github.com/pascal-my


• @author Luuk Verhoeven - https://github.com/luukverhoeven

Version history :

• 1.1 : stable version not working (bug)


• 1.1.1 : stable version working as local plugin for Moodle 2.x (see https://github.com/pascal-my/moodle-local_groupautoenrol)


• 1.1.2 : stable version working as admin tool plugin for Moodle 3.x


• 3.9.0 : Moodle 3.9 & PHP7.2 version + Moodle 4.0;PHP 7.4 version

Version history :

• 1.1 : stable version not working (bug)


• 1.1.1 : stable version working as local plugin for Moodle 2.x (see https://github.com/pascal-my/moodle-local_groupautoenrol)


• 1.1.2 : stable version working as admin tool plugin for Moodle 3.x

moodle-admin_tool_groupautoenrol

Version 1.1.2 (stable version)

ENGLISH

Plugin to randomly auto enrol students in Moodle courses groups when they are enrolled into the course (whatever the enrol methods : auto-enrol by key, cohorts sync or manual enrol)

Things to know :

• The plugin uses \core\event\user_enrolment_created (user_enrolled) Moodle event


• If a selected group is deleted, the plugin will ignore it.

In this stable version (1.1.2) :

• you can choose to enable the plugin in each course


• you can choose to auto-enrol students in all existing course or specific ones

Compatibility :

• Tested with Moodle 3.0


• Another version of the plugin exist and works with Moodle 2.5 and 2.7 (I did not test it with the others versions but should work with all 2.x).
  It's a local plugin because adding link into "Course administration" menu was not possible for admin tool before Moodle 3.0
  You can get it here : https://github.com/pascal-my/moodle-local_groupautoenrol/tree/STABLE

installation

• Copy the directory 'groupautoenrol' into the moodledir/admin/tool directory.


• Connect to moodle as an administrator and install the plugin.


• Go to a course, create at least one group


• Enable the plugin for the course with the new link "Course administration > Users > Auto-enrol in groups"
  Note : this link appears even if the plugin is not enabled for the course

FRENCH

Plugin permettant l'inscription automatique aléatoire des étudiants dans les groupes des cours lors de leur inscription au cours (qu'elle se fasse par la synchronisation des cohortes, par clé d'inscription ou manuellement).

Précisions :

• Ce plugin utilise l'évènement \core\event\user_enrolment_created (user_enrolled) pour détecter l'inscription d'un utilisateur dans un cours.


• Si un groupe sélectionné pour l'inscription auto est supprimé, il sera simplement ignoré par le plugin (cela ne pose pas de blocage)


• En cas d'inscription par clé de groupe, l'utilisateur est d'abord inscrit automatiquement (selon les paramètres définis) puis il est inscrit au groupe désigné par la clé.
  Selon les paramètres, il peut donc se retrouver inscrits à 1 ou 2 groupes (si le tirage aléatoire a désigné le même groupe que celui de la clé). Je n'ai pas eu de message d'erreur lorsque Moodle tente d'inscrire l'utilisateur dans le groupe de la clé même losque celui a déjà été inscrit par le plugin "inscription_auto" dans le même groupe.

Version stable (1.1.2) :

• plugin activable par cours


• l'inscription automatique se fait dans tous les groupes du cours ou uniquement dans des groupes sélectionnés.

Compatibilité

• Version testée avec Moodle 3.0


• Une version fonctionnant avec Moodle 2.5 et 2.7 existe (Non testé avec les autres versions mais il doit fonctionner avec toutes les versions de Moodle 2.x).
  Il s'agit d'un plugin "local" car avant Moodle 3.0, il n'était pas possible d'ajouter un lien dans le menu "Administration du cours" pour les plugin de type "admin tool".
  Il est téléchargeable ici : https://github.com/pascal-my/moodle-local_groupautoenrol/tree/STABLE

Installation

• Copier le dossier 'groupautoenrol' dans le répertoire moodledir/admin/tool.


• Se connecter en admin et installer le plugin.


• Aller dans un cours et créer au moins 1 groupe


• Activer l'inscription automatique dans le(s) groupe(s) pour le cours via le nouveau lien "Administration du cours > Utilisateurs > Groupes : Inscription auto"
  Note : le nouveau lien "Administration du cours > Utilisateurs > Groupes : Inscription auto" s'affiche tout le temps, même si le plugin n'est pas activé pour le cours

credits

• @copyright 2016 Pascal


• @author Pascal M - https://github.com/pascal-my

licence

This code is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

It is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this software. If not, see http://www.gnu.org/licenses/.