Enrol by user profile fields

Enrolment ::: enrol_attributes
Maintained by Nicolas Dunand
This plugin allows users to be enrolled according to any value stored in their user profile.
Latest release:
1345 sites
110 fans
Current versions available: 4

This plugin allows users to be enrolled according to any value stored in their user profile. If you use an external authentication scheme (LDAP, Shibboleth), you can store values in hidden user fields of the users' Moodle profile, and then use these values to automatically enrol users if some courses.


Screenshot #0


Nicolas Dunand (Lead maintainer)
RISET Université de Lausanne: Supporting institution
Please login to view contributors details and/or to contact them

Comments RSS


  • Mon, Jun 3, 2019, 4:58 PM
    Hi German,
    There are some mandatory settings in the Moodle administration, under Plugins > Enrolments > Enrol by user profile fields. In particular, even if you leave all other fields to their default values, you have to set the "Profile fields to be used in the selector" field for the plugin to work.
  • Fri, Jun 28, 2019, 11:33 PM
    Hi Nicolas! This sounds like a great plugin, but the zip seems to contain the wrong version.. I'm installing a version with the zip file called "enrol_attributes_moodle37_2018092300", i.e. 2.8 for Moodle 3.5-3.7 (I currently have Moodle 3.6), but when it gets installed and I go to plugin overview, it shows "2.8 for Moodle 2.7-3.5 (build 2018092300)" installed. It is disabled with no possibility of enabling. I opened version.php and it indeed has $plugin->release = '2.8 for Moodle 2.7-3.5 (build 2018092300)';. Could you advice on where I could download the correct version? Thanks!
  • Mon, Jul 1, 2019, 3:54 PM
    Hi Marta,

    You are right about mismatching versions strings, sorry about that. The fact is that the 2018092300 build was previously rated for up to Moodle 3.5 has been checked against Moodle 3.6 and 3.7 and is now tagged as compatible with these versions. This has no impact as to whether the plugin will activate or not on your Moodle version (as long as your Moodle version is higher that version 2.7).

    To activate the plugin, go to your Moodle's administration, then to Plugins > Enrolments > Enrol by user profile fields, and there make sure to set the plugin according to your needs.
  • Mon, Jul 1, 2019, 4:21 PM
    Nicolas, thank you very much for the response! You are right, I didn't check Enrolments page! It works now.
  • Don
    Wed, Jul 17, 2019, 11:52 PM
    My install was not working, not appearing in Enrolment methods. Solved by removing special characters I had put into the field name. Yes, " / " does mess things up.

    I removed the slashes and everything works as hoped. Love this plugin and than you Nicolas
  • Don
    Thu, Jul 18, 2019, 2:55 AM
    Nicolas, I need to add the exact same enrollment by profile field(s) to a huge list of courses. Any of 3 profile choices using the "or" variable. Is there a cli script or SQL query I could use to populate multiple courses? Wishing I could use it at the Category Enrollment level but I don't see that working
  • Mon, Jul 22, 2019, 5:43 PM

    Thanks for your feedback.

    1. I could not reproduce the problem you mention in your first post.

    2. Using SQL, you could use `SELECT * FROM mdl_enrol WHERE enrol = 'attributes' AND courseid = ` to get the values, and then use `INSERT` to insert similar rows for other courses – but there is no easy way to do this. The rule itself is a JSON string contained in the `customtext1` field.
  • Wed, Aug 14, 2019, 3:15 AM
    I have installed this plugin on our Moodle 3.7 install. I am not sure I am seeing all the options correctly. I can only set the following settings from Dashboard - Site Administration - Plugins - Enrolments - Enrol by user profile fields: Default User, Default behaviour after attributes expiration, and Enrol users immediately at login. I have enabled the plugin, but am not able to choose it as an enrolment method in a quiz.
  • Wed, Aug 14, 2019, 12:26 PM
    Hi Chad,
    You probably have to set at least one custom user profile field (see https://docs.moodle.org/37/en/User_profile_fields), then a new setting would appear in the plugin setting.
  • Wed, Aug 14, 2019, 8:11 PM
    Thank you. That was what I needed. Is there a how-to guide available that I'm missing as well?
  • Mon, Sep 2, 2019, 7:12 PM
    Hi Nicholas - your plugin is working well on our Moodle 3.6. In our case we allow certain users to update their own custom profile field(s) and enrolments take effect on next login. We would like that such changes take immediate effect. I thought that adding an additional array to $observers in db/events.php like

    'eventname' => '\core\event\user_info_field_updated',
    'callback' => 'enrol_attributes_plugin::process_enrolments',
    'includefile' => '/enrol/attributes/lib.php',
    'internal' => true,
    'priority' => 9999,

    but I suspect that is the wrong approach ! Can you offer any suggestions please ?
  • Mon, Sep 2, 2019, 7:39 PM
    Hi Gary,

    Thanks for your feedback. Yes this would be possible, but please note that this could have a performance impact, as then all rules would have to be evaluated each time a user updates such a field.

    I had to add a feature to optionally disable the processing of all rules at login (see https://github.com/ndunand/moodle-enrol_attributes/commit/f395ff5eebbd), as this had a serious performance impact on our installation. This is due to the fact that we have almost 100k users and some complex enrolment rules – this results in a 100k^n join SQL query (where n is the number of rule components).

    Therefore we now rely on the scheduled task, which does process all enrolments every full hour, but you could also change the delay in the Moodle administration setup to make it run more often.
  • Mon, Nov 4, 2019, 12:00 AM
    Hi Nicolas

    I want to restrict my course to users with a gov.uk email address

    1. In User profile fields, do I define the extra profile field in text input field or text area ?
    2. Can you help with how I should be defining what I want , i.e. users with a gov.uk address ? Is it a case of simply adding free text or do I have to define an algorthim, such as " if email address ends in gov.uk " in the text area ? I am not a code writer so I would need advice on how to do the latter

  • Wed, Nov 6, 2019, 6:41 PM
    Hi Altan,

    1. The extra profile field should be a text input.
    2. As of now the plugin only allows to check for exact values, not intervals or "value ending in", so changes should be made in the code to allow for this.
  • Wed, Nov 6, 2019, 11:14 PM
    Thanks Nicolas
Please login to post comments