Step By Step Guide To Configure miniOrange Directory Sync Add-On For WordPress


  • You must need to install and configure Advanced Role Mapping or Multiple LDAP directories version premium plugin.

Step 1: Install miniOrange Directory Sync Add-on

From your WordPress dashboard

  • Go to PluginsAdd New.
  • Unable to load image
  • Click on Upload Plugin and choose the downloaded plugin zip.
  • Unable to load image

    Unable to load image

  • After installing the Directory Sync Add-on, Activate the Add-on from your Plugins page.
  • Unable

Step 2: Setup miniOrange Directory Sync Add-on

  • Once the add-on is activated, follow the steps mentioned below to configure Directory Sync Add-on:

  • Sync Options: In Directory Sync Add-on go to Sync options tab  to configure following Synchronization Options.

    • RDN: Relative Distinguished Names(RDN) refers to the top-level component of an entry's Distinguished Name(DN).
      e.g. “uid=joy,ou=People,dc=example,dc=com”, the component “uid=joy” is often referred to as the RDN for that entry.

    • Value of RDN: You can specify the value for Relative Distinguished Names(RDN) among Username, Email, First Name, Last Name, Full Name.

    • Select Timezone: Select the timezone to run the sync according to your timezone.

    • User Base: This is the LDAP Tree under which Directory Sync Add-on will search for the users. Provide the distinguished name(DN) of the User Base object.
      eg. cn=Users,dc=domain,dc=com.

    • Object Class: Specify "user" as the type of the object present in directory system schema.

    • Username Attribute: Specify which attribute will be mapped to wordpress username.
      e.g. samaccountname, mail, cn

    • Delete User in LDAP when deleted in WordPess: This option is disabled by default. When you enable this option, if you delete any user from WordPress it will also get deleted from the LDAP.

    • Unsync Wordpress Users not present in LDAP: By enabling this option, users which do not exist in LDAP, will be deleted from WordPress. It is recommended to keep this option disable unless the users in WordPress and LDAP are in perfect sync. Also when you click on save button, you will see the following options:

      1. Delete user from wordpress

      2. Change the role of the user

    • LDAP to WP Sync Frequency: The LDAP to WP sync can be scheduled on Hourly, Daily or Twice Daily basis.

    • Sync Interval: Delay between sync of two users. This is in milliseconds and the minimum value should be 10ms.

    • Password Hash Algorithm: Algorithm used by directory system to hash the plaintext password.

    • Unable to load image

    WP to LDAP Sync: Sync the existing WordPress users to LDAP.

    • In WP to LDAP Sync tab enter the range of id's of WordPress users and click on Sync Users.

    • Unable to load image
    • A list of users within selected range will be displayed where you can select the users you want to Sync from WordPress to LDAP and click on Sync Users. The Selected users will be synced to the configured Search Base.

    • Unable to load image

    LDAP to WP Scheduled Sync: The users present in LDAP Search Base will be Synced from LDAP to WordPress and the existing users will be updated.

    • To enable Scheduled Sync, go to LDAP to WP Scheduled Sync tab and Enable Enable Scheduled sync and click on save setting after that click on Sync. To stop sync click on Stop Sync button.

    • Unable to load image

    WP to LDAP Sync Reports: This report shows the status of the last sync from WordPress to LDAP.

If you dont find what you are looking for, Please contact us at or call us at +1 978 658 9387 to find an answer to your question about Directory Sync Add-on.