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:
1415 sites
518 downloads
132 fans
Current versions available: 6

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.

Screenshots

Screenshot #0

Contributors

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

Comments RSS

Comments

  • Marta Semeniuk
    Fri, 28 Jun 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!
  • Nicolas Dunand
    Mon, 1 Jul 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.
  • Marta Semeniuk
    Mon, 1 Jul 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, 17 Jul 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, 18 Jul 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
  • Nicolas Dunand
    Mon, 22 Jul 2019, 5:43 PM
    Don,

    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.
  • Chad Jemison
    Wed, 14 Aug 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.
  • Nicolas Dunand
    Wed, 14 Aug 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.
  • Chad Jemison
    Wed, 14 Aug 2019, 8:11 PM
    Thank you. That was what I needed. Is there a how-to guide available that I'm missing as well?
  • Gary Prosser
    Mon, 2 Sep 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 ?
  • Nicolas Dunand
    Mon, 2 Sep 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.
  • altan ahmet
    Mon, 4 Nov 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


  • Nicolas Dunand
    Wed, 6 Nov 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.
  • altan ahmet
    Wed, 6 Nov 2019, 11:14 PM
    Thanks Nicolas
  • Leslie Chukwunweike
    Sat, 9 Nov 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
Please login to post comments