## Enrolment: Enrol by user profile fields

enrol_attributes
Maintained by Nicolas Dunand
This plugin allows users to be enrolled according to any value stored in their user profile.
866 sites
76 fans
Current versions available: 5

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.

### Contributors

RISET Université de Lausanne: Supporting institution

### Awards

• 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.
• 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
• 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
Don,

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
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

),
array(
'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
• Sat, Nov 9, 2019, 4:24 AM
Hi, Nicolas

I'm using the latest build of your plugin (2018092300) with the latest build of Moodle 3.7 "Enrol users immediately at login" is checked. "Force enrolments" is not working well but "Purge enrolments" is working well, but executing the scheduled task "processenrolments_task" failed because of database write error! This process has never run since i installed the plug The other task "invalidatecache_task" is working smoothly.

I have tried changing the faildelay value of the process through database table, but it keeps adjusting to 60seconds after each failed run. cron runs well. Any tips you can give me?
Kind regards,
Leslie
• Mon, Nov 25, 2019, 4:33 PM
Hi Leslie,

Sorry about the late reply. What I can suspect is that there is a timeout on the scheduled task. This can happen because the "Force" and "Purge" act on one enrollment (course), but the scheduled task acts on all defined rules in all courses.

Do you run the cron by Web (page call) or CLI (command-line) ? I would recommend to try and run the cron by command line and see whether there still is a timeout and if so whether any more specific error is displayed.

Cheers,
Nicolas