=== Staff/Employee Business Directory for Active Directory ===
Contributors: miniOrange
Donate link: https://miniorange.com
Tags: employee directory, active directory search, business directory, ldap search, search widget
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 5.6.0
Stable tag: 1.4.4
License: Expat
License URI: https://plugins.miniorange.com/mit-license

Search and Display Users / Staff / Employees present in your LDAP / Active Directory on your WordPress site using a shortcode. [24/7] Support Provided


== Description ==

[Showcase](https://plugins.miniorange.com/wordpress-ldap-directory-search?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory) | [Documentation](https://plugins.miniorange.com/setup-active-directory-ldap-users-search-plugin?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory) | [Features](https://plugins.miniorange.com/wordpress-ldap-directory-search?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory#Features) | [Contact Us](https://www.miniorange.com/contact?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory)

The [Staff/Employee Business Directory for Active Directory plugin](https://plugins.miniorange.com/wordpress-ldap-directory-search?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory) performs an LDAP search and displays the Staff / Employees present in your Active Directory on a WordPress site using a shortcode. The directory will display user details, including staff and employee information from the Active Directory which means the users will not be created in WordPress, nor will their information be stored. Our plugin will seamlessly allow you to perform a Staff / Employee search through your business directory, employee directory, staff directory, or any other Active Directory implementations from your WordPress site and display the information you would like to see.

= Free Version Features =

* Search LDAP / Active Directory users and Display them on your WordPress site.
* Fetch information from a business directory, employee directory, staff directory, or any other Active Directory implementations. 
* Display the LDAP / Active Directory users using the configured attributes such as name, email, phone, and custom attributes.
* LDAP custom attributes such as Department, Title, Birthday, etc., can also be used to perform LDAP search. 
* Display Profile Picture set in your LDAP / Active Directory as user profile picture in LDAP search results.
*  Search using different LDAP Search Bases that allow you to restrict employee / staff search to selected Search Bases (Organizational Units).
* Auto-fetching the list of LDAP Search Bases / Organization Units (OUs) in your LDAP / Active Directory.
* Support for LDAP Secure connection (LDAPS) and TLS Connection.


Support searching and fetching data dynamically from the following Active Directory implementations:

1. `Microsoft Active Directory`
2. `Azure Active Directory`
3. `Sun Active Directory`
4. `OpenLDAP Directory`
5. `JumpCloud`
6. `FreeIPA Directory`
7. `Synology`
8. `OpenDS`
`and several other LDAP directory systems.`

= Premium Version Features (Check out the Licensing tab to know more):- =

* <strong>Add unlimited LDAP / AD Attributes: </strong> Add and configure as many LDAP/Active Directory custom attributes to display on your WordPress site.
* <strong>Multiple Search Attributes: </strong>Search the LDAP / AD staff / employees using more than one LDAP attribute at a time. For example, search from the LDAP Server/Active Directory for users by name and city attributes.
* <strong>Auto-fetching of LDAP Organizational Units (OUs): </strong>Fetches the LDAP Organizational Units (OUs) present in your Active Directory/ Business Directory/ Employee Directory/ Staff Directory or other LDAP Directory.
* <strong>Search Users from Multiple LDAP Search Bases: </strong>Select multiple search bases and search LDAP users from these configured search bases from your Active Directory / other LDAP Directory.
* <strong>Custom Search Filter: </strong>Add a Custom Search Filter to customize the LDAP Employee search result as per the requirements. Ex. Search only active LDAP Directory users, and restrict particular LDAP/Active Directory group users in LDAP search results.
* <strong>Fetch LDAP/Active Directory Profile Picture: </strong>Display the thumbnail photo / Profile Picture set in your LDAP/Active Directory as the user profile picture in the search result.

= Use Cases Supported By Our Plugin =

* [Create a Phonebook Directory / Employee Directory / Staff Directory](https://plugins.miniorange.com/employee-directory-search-and-listing-from-active-directory-in-wp?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory) that is in sync with your Active Directory.
* Fetch the complete profile information along with pictures of students enrolled in a school or university.
* Display hospital staff and doctors with the details of their specialization from your Active Directory / LDAP on a WordPress page.
* Search and display the employees' / staff's data present in your LDAP server on the fly without storing the employee information in WordPress.
* [Display Staff / Employees having birthdays and anniversaries](https://plugins.miniorange.com/ldap-staff-employee-directory-use-cases?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory) on a specific page and send automated congratulating emails.

= Other Use-Cases we support =
* <strong>[miniOrange WP LDAP/AD Login for Intranet sites plugin](https://plugins.miniorange.com/wordpress-ldap-login-intranet-sites?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory)</strong> supports login to WordPress sites using credentials stored in Active Directory and LDAP Directory systems. Only if you have access to <strong>[LDAP Extension](https://faq.miniorange.com/knowledgebase/how-to-enable-php-ldap-extension/?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory)</strong> on your site.
* <strong>[miniOrange Active Directory/LDAP Integration for Cloud & Shared Hosting Platforms Plugin](https://plugins.miniorange.com/wordpress-ldap-login-cloud?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory)</strong> supports login to WordPress sites hosted on a shared hosting platform using credentials stored in active directory and LDAP Directory systems in case you are not able to enable <strong>[LDAP Extension](https://faq.miniorange.com/knowledgebase/how-to-enable-php-ldap-extension/?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory)</strong> on your site.
* <strong>[WordPress Login and User Management Plugin](https://plugins.miniorange.com/wordpress-login-and-user-management-plugin?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory)</strong>: This plugin offers several functionalities, including bulk user management, user redirection based on WordPress roles, user session management, auto-logout users, and the ability to make a page or post private or public based on an ID or URL.
* miniOrange supports <Strong>[API Security use cases](https://apisecurity.miniorange.com/use-case/?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory)</Strong> to protect and secure your APIs using our product <strong>[XecureAPI](https://apisecurity.miniorange.com/?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory)</strong> which helps you to enable Authentication methods ( like OAuth, SAML, LDAP, API Key Authentication, JWT Authentication etc ), Rate Limiting, IP restriction and much more on your APIs for complete protection.
* miniOrange also supports <Strong>[VPN use cases](https://www.miniorange.com/iam/solutions/vpn-mfa-multi-factor-authentication?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory)</Strong> Log in to your VPN client using Active Directory /other LDAP Directory credentials and <strong>[Multi-Factor Authentication](https://www.miniorange.com/products/multi-factor-authentication-mfa?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory)</strong>.
* miniOrange supports <strong>[Single-Sign-On (SSO)](https://www.miniorange.com/products/single-sign-on-sso?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory)</strong> into a plethora of applications and supports various protocols like(<strong>[RADIUS](https://www.miniorange.com/blog/radius-server-authentication/?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory), [SAML](https://plugins.miniorange.com/wordpress-single-sign-on-sso?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory), [OAuth](https://plugins.miniorange.com/wordpress-sso?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory), [LDAP/LDAPS](https://plugins.miniorange.com/wordpress-ldap-login-intranet-sites?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory)</strong>, using various IDP's like <strong>Azure Active Directory, Microsoft On-Premise Active Directory, Octa, ADFS</strong>, etc.
* Contact us at info@xecurify.com to know more.


= Why you should go with our solution =

* <strong> Support</strong>: With search being one of the essential functions of a website, our priority support ensures that any issues you face on a live production site can be resolved on time.
* <strong>Regular updates</strong>: We regularly update our plugin and ensure it is compatible with the latest WordPress versions. These updates include security and bug fixes that <strong> provide you have the newest security fixes</strong>.
* Ensure timely updates for <strong>new WordPress/PHP releases</strong> with our premium plugins and compatibility updates to ensure you have adequate support for smooth transitions to new versions of WordPress and PHP.
* <strong>Reasonable priced</strong>: Various plans are tailored to suit your needs. We provide discounts to educational and non-profit organizations and bulk discounts on large purchases.
* <strong>Easy to set up </strong>: High-quality, easy-to-understand documentation will help you in setting up our plugin. Our developers can also help you by walking you through the setup process of the plugin.
* High level of <strong>customization</strong> and <strong>add-ons</strong> to support specific requirements.


= Need support? =
Please email us at ldapsupport@xecurify.com or <a href="https://www.miniorange.com/contact?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory" target="_blank">Contact us</a>

= Minimum Requirements =

* Compatible with WordPress version 5.0 or higher
* Compatible with PHP version 5.6.0 or higher

== Installation ==

= Prerequisites =

I. Staff/Employee Business Directory for Active Directory plugin requires the following `PHP Modules` to be enabled. Make sure you have enabled them.

1. **PHP LDAP Module**:
  Step-1: Open the php.ini file.
  Step-2: Search for "extension=php_ldap.dll" in the php.ini file. Uncomment this line. If it isn't present, add this line to the file and save the file.

2. **OpenSSL Module**:
  Step-1: Open the php.ini file.
  Step-2: Search for "extension=php_openssl.dll" in the php.ini file. Uncomment this line. If not present, add this line to the file and save the file.

II. To install the Staff / Employee Business Directory for Active Directory plugin, the minimum requirements are:

1. **WordPress version 5.0**
2. **PHP version 5.6.0**

= From your WordPress dashboard =
1. Visit `Plugins > Add New`
2. Search for `Staff/Employee Business Directory for Active Directory`. Find and install the `Staff/Employee Business Directory for Active Directory`.
3. Activate the plugin from your Plugins section.

= From WordPress.org =
1. Download the Staff/Employee Business Directory for Active Directory.
2. Unzip and upload the `miniorange-ldap-directory-search` directory to your `/wp-content/plugins/` directory.
3. Activate the Staff/Employee Business Directory for Active Directory from your Plugins section.

Make sure that if there is a firewall, you `OPEN THE FIREWALL` to allow incoming requests to your LDAP from your WordPress Server IP and open port 389 (636 for SSL or LDAPS).

== Frequently Asked Questions ==

= Why am I getting an error while trying to Test LDAP Connection? =

1. Please make sure that the LDAP Server URL, Username and Password that you have entered are correct.
2. In the Username field, please enter either the UserPrincipalName or DistinguishedName (DN) attribute of any user present in your LDAP server.
3. Check if the LDAP server URL is accessible from your hosted site and the port 389 is open. { To check this, run this command on your WordPress server: >telnet < LDAP server URL or IP >:389 }
4. If you are using a firewall, open the firewall to allow incoming requests to your LDAP from your WordPress Server IP and port 389.

If you have any queries or if you need any sort of assistance configuring our plugin, you can contact us at ldapsupport@xecurify.com. Our customer support team is available 24x7 to assist you in any way possible.

= What is meant by Search Base in my LDAP environment? =

1. Search Base is a container / path where your LDAP/AD users that you want to search are present.
2. This is the container in which the Staff/Employee Business Directory For Active Directory Plugin will search for LDAP users.
3. The Search Base value can be obtained from the distinguishedName attribute of a container / node where the LDAP/AD users are present.

For example, if you want to search all LDAP/AD users in the Organizational Unit (OU) named "LDAPUsers. The Search Base would be OU=LDAPUsers, DC=DomainName, DC=SubDomainName.
If you have any queries or if you need any sort of assistance in configuring our plugin, you can contact us at ldapsupport@xecurify.com. Our customer support team is available 24x7 to assist you in any way possible.

= I can not add more LDAP user attributes in the Attributes Configuration. Why? =

To add and display unlimited LDAP user attributes, please upgrade your existing plan to the premium plan.

= Is it possible to display only active (non-disabled) users from the LDAP/AD Server? =

Yes, It is possible using the custom search Filter feature, which is present in the premium version of our plugin.

Click [here](https://faq.miniorange.com/faq/ldap-authentication/) to view our detailed FAQ page.

For support or troubleshooting help, please email us at info@xecurify.com or [Contact us](https://www.miniorange.com/contact?utm_source=wordpress%20readme&utm_medium=marketplace&utm_campaign=Staff%20/%20Employee%20Business%20Directory%20for%20Active%20Directory).

= How does the Custom Search Filter work? =

Custom LDAP search filters allow you to apply advanced filters to your search. You can restrict / allow specific users belonging to LDAP groups or Organizational Units. For Example, If you want to display users from Sales Department, then you can do this using the below search filter:  

(&(objectClass=user)(objectCategory=person)(sAMAccountName=?)(department=’Sales’))

= Does this plugin store any staff / employee information in the WordPress database? =

No, this plugin does not store any LDAP user's data in the WordPress database. Our Staff / Employee Business Directory For Active Directory plugin dynamically fetches and displays users' information on the fly.

= Can the plugin fetch user details dynamically from Active Directory? =

Yes, the plugin performs an LDAP search and dynamically fetches user details from your Active Directory. It does not create or store users in WordPress but displays them using a shortcode.

= Which directory systems are supported for the staff directory feature? =

The plugin supports multiple directory systems, including Microsoft Active Directory, Azure Active Directory, Sun Active Directory, OpenLDAP, JumpCloud, FreeIPA, and more, to fetch staff information dynamically.

= Can I display custom attributes for users in my business directory? =

Yes, you can configure custom LDAP attributes such as department, title, and birthday to display in your business directory. The premium version allows unlimited custom attributes.

= Does the plugin support secure connections for the staff directory? =

Yes, the plugin supports LDAP Secure (LDAPS) and TLS connections, ensuring secure transmission of data between WordPress and your Active Directory during searches.

= Can I search for staff across multiple organizational units in Active Directory? =

Yes, the plugin allows you to search users across different LDAP search bases or organizational units, and it can auto-fetch the available organizational units in your directory.

= Is customization available in the staff directory/employee directory plugin? =

Yes, we provide customizations for UI as well as functionalities in the plugin. 


== Screenshots ==

1. Configure the LDAP Server Connection
2. Attribute Configuration Settings
3. User Display Configuration
4. User Search Result

== Changelog ==

= 1.4.4 =
* Compatibility with WordPress 6.9
* PHPCS and PCP Fixes
* Security Fixes
* Optimized the bulk user fetch flow for better performance

= 1.4.3 = 
* Minor Bug Fix
* Minor Security Fixes
* Compatibility with WordPress 6.8

= 1.4.2 =
* Code optimization
* Added Feature : Test User Search Result

= 1.4.1 = 
* Minor Bug Fixes
* Compatibility with WordPress 6.6

= 1.4.0 = 
* Added feature to apply custom styles to the search results template
* Added List and Grid view for user search results
* Fix for LDAP Injection vulnerability
* Compatibility with the WordPress version 6.5

= 1.3.2 =
* Usability Improvements

= 1.3.1 =
* Compatibility with the WordPress version 6.4.
* UI Improvements

= 1.3 =
* Enhanced security measures to prevent LDAP Passback Vulnerability.

= 1.2.3 =
* Security Fixes

= 1.2.2 =
* Compatibility with the WordPress version 6.3

= 1.2.1 =
* Compatibility with the WordPress version 6.2

= 1.2.0 =
* WP Guideline & Security Fixes.
* Code Optimization.

= 1.1.2 =
* Black Friday Sale Advertisement.
* Updated Licensing Page.
* Added Settings Menu.

= 1.1.1 =
* Added Advertisement for Trialware.
* Minor Bug Fixes.
* Compatibility with WordPress 6.1

= 1.1 =
* Read me changes.
* UI Improvements.
* Added an optional feedback form on plugin deactivation.
* Code optimization

= 1.0.1 =
* Read me changes.
* Minor UI changes.

= 1.0 =
This is the first version of the plugin.

== Upgrade Notice ==

= 1.4.4 =
* Compatibility with WordPress 6.9
* PHPCS and PCP Fixes
* Security Fixes
* Optimized the bulk user fetch flow for better performance

= 1.4.3 = 
* Minor Bug Fix
* Minor Security Fixes
* Compatibility with WordPress 6.8

= 1.4.2 =
* Code optimization
* Added Feature : Test User Search Result

= 1.4.1 = 
* Minor Bug Fixes
* Compatibility with WordPress 6.6

= 1.4.0 = 
* Added feature to apply custom styles to the search results template
* Added List and Grid view for user search results
* Fix for LDAP Injection vulnerability
* Compatibility with the WordPress version 6.5.

= 1.3.2 =
* Usability Improvements

= 1.3.1 =
* Compatibility with the WordPress version 6.4.
* UI Improvements

= 1.3 =
* Enhanced security measures to prevent LDAP Passback Vulnerability.

= 1.2.3 =
* Security Fixes

= 1.2.2 =
* Compatibility with the WordPress version 6.3

= 1.2.1 =
* Compatibility with the WordPress version 6.2

= 1.2.0 =
* WP Guideline & Security Fixes.
* Code Optimization.

= 1.1.2 =
* Black Friday Sale Advertisement.
* Updated Licensing Page.
* Added Settings Menu.

= 1.1.1 =
* Added advertisement for trialware.
* Minor Bug Fixes.
* Compatibility with WordPress 6.1

= 1.1 =
* Read me changes.
* UI Improvements.
* Added an optional feedback form on plugin deactivation.
* Code optimization

= 1.0.1 =
* Read me changes.
* Minor UI changes.

= 1.0 =
This is the first version of the plugin.