Moodle authentication method which provides all functionality of auth_ldap, but supports advanced features for the LDAP synchronization script:
- It adds the possibility to the LDAP synchronization script to suspend users which have disappeared in LDAP for a configurable amount of days and delete them only after this grace period (the Moodle core LDAP synchronization script only provides you the option to suspend _or_ delete users which have disappeared in LDAP - MDL-47018).
- You can prevent the LDAP synchronization script from creating Moodle accounts for all LDAP users if they have never logged into Moodle before (the Moodle core LDAP synchronization script always creates Moodle accounts for all LDAP users - MDL-29249).
- You can fetch user details from LDAP on manual user creation (MDL-47029).
- It adds several line breaks to the output of the LDAP synchronization script to improve readability (MDL-30589).
* It adds the possibility to the LDAP synchronization script to suspend users which have disappeared in LDAP for a configurable amount of days and delete them only after this grace period (the Moodle core LDAP synchronization script only provides you the option to suspend _or_ delete users which have disappeared in LDAP - MDL-47018).
* You can prevent the LDAP synchronization script from creating Moodle accounts for all LDAP users if they have never logged into Moodle before (the Moodle core LDAP synchronization script always creates Moodle accounts for all LDAP users - MDL-29249).
* You can fetch user details from LDAP on manual user creation (MDL-47029).
* It adds several line breaks to the output of the LDAP synchronization script to improve readability (MDL-30589).
Requirements
============
------------
This plugin requires Moodle 2.7+
Changes
=======
2014-08-29 - Update version.php
2014-08-29 - Update README file
2014-08-27 - Change line breaks to mtrace() (MDL-30589)
2014-08-25 - Support new event API, remove legacy event handling
2014-07-31 - Add event handler for "user_created" event (see "Fetching user details from LDAP on manual user creation" below for details - MDL-47029)
2014-06-30 - Check compatibility for Moodle 2.7, no functionality change
2014-03-12 - Initial version
-------
*2014-08-29 - Update version.php
*2014-08-29 - Update README file
*2014-08-27 - Change line breaks to mtrace() (MDL-30589)
*2014-08-25 - Support new event API, remove legacy event handling
*2014-07-31 - Add event handler for "user_created" event (see "Fetching user details from LDAP on manual user creation" below for details - MDL-47029)
*2014-06-30 - Check compatibility for Moodle 2.7, no functionality change
*2014-03-12 - Initial version
Installation
============
------------
Install the plugin like any other plugin to folder
/auth/ldap_syncplus
...
...
@@ -32,7 +33,7 @@ See http://docs.moodle.org/en/Installing_plugins for details on installing Moodl
Usage & Settings
================
----------------
auth_ldap_syncplus is a plugin which inherits and reuses most of the code from the Moodle core auth_ldap plugin. All functions from auth_ldap are still working.
After installing auth_ldap_syncplus, you will find a new authentification method on the admin page /admin/settings.php?section=manageauths.
...
...
@@ -54,14 +55,14 @@ UPDATE mdl_user SET auth='ldap_syncplus' WHERE auth='ldap'
Running LDAP synchronization script
===================================
-----------------------------------
To leverage the additional LDAP synchronization features of auth_ldap_syncplus, you have to change your synchronization cronjob from /auth/ldap/cli/sync_users.php to /auth/ldap_syncplus/cli/sync_users.php.
If you don't know how to setup your synchronization cronjob, see http://docs.moodle.org/en/LDAP_authentication#Setting_up_regular_automatic_synchronisation_using_cron and the comments in /auth/ldap/cli/sync_users.php for details.
Fetching user details from LDAP on manual user creation
Normally, when a new user logs into Moodle for the first time and a Moodle account is automatically created, Moodle pulls the user's details from LDAP and stores them in the Moodle user profile according to the LDAP plugin's settings.
auth_ldap_syncplus extends this behaviour of pulling user details from LDAP:
...
...
@@ -71,38 +72,38 @@ This feature is enabled automatically and can be used as soon as you are using a
Themes
======
------
The auth_ldap_syncplus plugin acts behind the scenes, therefore it works with all moodle themes.
Further information
===================
-------------------
Report a bug or suggest an improvement: https://github.com/moodleuulm/moodle-auth_ldap_syncplus/issues
Moodle release support
======================
----------------------
Due to limited ressources, auth_ldap_syncplus is only maintained for the most recent major release of Moodle. However, previous versions of this plugin which work in legacy major releases of Moodle are still available as-is without any further updates in the Moodle Plugins repository.
There may be several weeks after a new major release of Moodle has been published until we can do a compatibility check and fix problems if necessary. If you encounter problems with a new major release of Moodle - or can confirm that auth_ldap_syncplus still works with a new major relase - please let us know on https://github.com/moodleuulm/moodle-auth_ldap_syncplus/issues
Right-to-left support
=====================
---------------------
This plugin has not been tested with Moodle's support for right-to-left (RTL) languages.
If you want to use this plugin with a RTL language and it doesn't work as-is, you are free to send me a pull request on
github with modifications.
Contribution to Moodle Core
===========================
---------------------------
There is a Moodle tracker ticket on https://tracker.moodle.org/browse/MDL-47030 which proposes to add the improved features of this plugin to Moodle core auth_ldap plugin.
Please vote for this ticket if you want to have this realized.
