Your Moodle version

General plugins (Local): Mass enrolments

Maintained by Picture of Rogier van Dongen Rogier van Dongen
A tool to all teachers to enrol existing users to their courses using CSV files (without bothering the admins)

One awkward thing about Moodle 1.x and the recent Moodle 2.x is that teachers are allowed to manually enroll known Moodle accounts to a course as teachers, non editing teachers, students... , but not using a 'flat file' produced by some CSV export.

They have to send a file to an admin user who will inject it into Moodle using the standard 'flatfile enrollment' method with the following limitations :

  • Teachers must provide account's and course idnumbers and admin user must reformat the file by adding the required extra columns 'add' and 'target role', before copying the file to the appropriate location in moodledata directory.
  • The report information is sent to admin, not to the course's teacher; so admin has to forward it to the teacher after the cron job has completed.
  • There is no way in flatfile enrollment method to specify in which groups these accounts should be added, so teacher has to go manually again across the list to assign accounts to groups.

This little extension, that adds itself to course administration menu will hopefully help teachers to do it themselves.

After installing it  a new item 'Bulk enrolments' will appear in the course administration menu for teachers (see screenshots).

It requires a CSV file, prepared by the teacher, with an unique Moodle id in the first column (idnumber, username or email) and optionally a group name in the second column. The first line of the CSV file must be present but its content is currently ignored.

Options are provided to force group (and grouping) autocreation if they do not yet exist in the target course.

Every line of the file may contain a different group name or even no group for some accounts


Screenshot #0


Picture of Rogier van Dongen
Rogier van Dongen (Lead maintainer)
Picture of Patrick Pollet
Patrick Pollet: Original author
Please login to view contributors details and/or to contact them

Comments RSS

Show comments
  • Picture of Patrick Pollet
    Wed, Jul 24, 2013, 12:25 AM

    In testing mode, ie by calling directly local/mass_enroll/mass_enroll.php the capabilty is also checked (see line 29 require_capability('local/mass_enroll:enrol', $context); thus
    if they are not set, you should get a fatal error .

    thus there is something else that prevents the two extra menus items to appear under Course admin/users ...
    but what ?
  • Picture of Monica Franz
    Wed, Jul 24, 2013, 4:25 PM
    Hi Patrick,

    I purged the cache and the menue items are back now!

    Thanks for migrating this great plugin/add on to Moodle 2.5!
  • Picture of Jo Matthews
    Fri, Jan 3, 2014, 12:29 AM
    Hi Patrick,
    I need to bulk unenrol students who have been enrolled via the ims enterprise plugin. It looks like I can just modify the code in lib.php in the function mass_unenroll and replace:
    $plugin = enrol_get_plugin('manual');
    $plugin = enrol_get_plugin('imsenterprise');
    $instance = $DB->get_record('enrol', array('courseid' => $course->id, 'enrol' => 'manual'));
    $instance = $DB->get_record('enrol', array('courseid' => $course->id, 'enrol' => 'imsenterprise'));

    This seemed to work but do you know of any issues this might cause?
    Many thanks

  • Picture of Patrick Pollet
    Fri, Jan 3, 2014, 7:17 PM

    It looks good to me if you do it in function mass_unenroll($cir, $course, $context, $data)

    But in that case I guess that you do not plan to use the 'mass enrol by CSV' feature since this is handled by imsenterprise ?

    Thus I would suggest to remove capability local/mass_enroll:enrol to teacher role and may be adjust some strings in local/mass_enroll/lang/en

    Season's greetings.
  • Picture of Joshua Holden
    Sun, Feb 9, 2014, 5:12 AM
    Hi, Patrick and everyone watching this!
    We've been very happy using the plug-in on Moodle 2.4, but now we're migrating to 2.6 and our sysadmins are balking at installing the plug-in since it isn't officially rated for 2.6. Has anyone tried it? Any problems?
  • Picture of Joshua Holden
    Sun, Feb 9, 2014, 5:13 AM
    P.S Thanks in advance!
  • Picture of Kai Yang Lim
    Thu, Mar 13, 2014, 11:00 AM
    Exactly what I need! Thank you. Using Moodle2.5.4.
  • Picture of Patrick Pollet
    Thu, Mar 13, 2014, 7:02 PM
    Still works under latest moodle 2.6. I must bave to figure out how to add 2.6 icon to download tab here.
  • Picture of Tom YC
    Mon, Jun 9, 2014, 8:52 PM

    I installed this on Moodle 2.7 today and I cannot get the links to appear under the Users menu. I have added the line to the config.php file. The plugin works if you manually put the URL in the address bar.
    Any ideas? Perhaps something has changed in 2.7. It works fine on 2.6
    Thanks in advance - a really good plugin by the way.

  • Picture of Ludovico Sassarini
    Tue, Sep 9, 2014, 6:08 PM
    Hi, just a quick info: does it work for moodle 2.7.1?
  • Picture of Rogier van Dongen
    Thu, Feb 4, 2016, 6:49 PM
    A new version is now available.
    It's Moodle 2.7 and onwards. I personally recommend uninstalling an older version of the plugin before installing the new one, although it shouldnt be necessary.
  • Picture of David Manning
    Fri, Feb 5, 2016, 7:37 AM
    Hmm seems like something's broken in the plugin - I'm able to see the plugin in my course, choose the CSV file, but when I click "enrol them to my course", I get a 404 not found error. It appears when I click the "enrol" button, the plugin's dropping the root folder. E.g. the plugin page is at , and when clicking "enrol" tries to load , which is invalid.
  • Picture of Rogier van Dongen
    Fri, Feb 5, 2016, 4:32 PM
    Sorry for the inconvenience, seems I had forgotten to process half the changes.
    All links should be fixed now. Cheers.
  • Picture of David Manning
    Sat, Feb 6, 2016, 1:54 AM
    Right on, Rogier! Thank you! This is now working great!
  • Picture of Abiramaraj JR
    Mon, Feb 8, 2016, 10:18 PM
    Hi Guys ,
    Any one can pls share the CSV format to upload bulk enroll
1 2
Please login to post comments