Dynamic User Directory

Description

Multi-user WordPress websites often serve organizations whose members interact both online and in person. This lightweight plugin facilitates that interaction by creating an alphabetically sorted user directory displaying the user meta information you specify. It can show avatars, mailing address, email address, website, phone, or any other user meta information you wish. It is also fully compatible with the Cimy User Extra Fields plugin.

Current Features

The best thing about Dynamic User Directory is the high degree of control you have over the content, formatting, and style. This allows you to create a highly customized directory and integrate it seamlessly into your WordPress theme. Features include:

  1. Sort by user last name or user display name.
  2. Specify which user meta fields to display (up to 10), including fields from the Cimy User Extra Fields plugin.
  3. Hide users with specified user roles.
  4. Include or exclude specific users.
  5. Optionally hyperlink the user name and avatar to their WP author page or BuddyPress profile page.
  6. Enjoy a fully responsive display for smaller screen sizes.
  7. Optionally show a search box to quickly locate a user
  8. Search by any user meta field with our Meta Fields Search add-on
  9. Create multiple directory instances with our Multiple Directories add-on
  10. Easily format the display in the following ways:
  • Show/hide avatars
  • Set avatar style (circle, rounded edges, or standard)
  • Show/hide listing border
  • Set listing border style, color, length, and thickness
  • Control font size of all text displayed
  • Set the display order of each field
  • Control space between alphabet letter links
  • Control space between each directory listing
  • Choose between showing all users or filtering by selected alphabet letter
  • Hyperlink almost any user meta field

Add-Ons and Customization

There are several Dynamic User Directory add-ons available here to enhance and extend your directory. You can also hire me to customize the plugin according to your site’s specific needs (email: sarah@sgcustomwebsolutions.com).

Your Feedback is Valuable!

If this plugin benefits your website, please take a moment to say thanks by leaving a positive rating and/or review. Did you find a bug? Let me know and I’ll fix it ASAP. Have suggestions for improvement? Don’t hesitate to email me with your thoughts. Thanks so much!

Screenshots

  • Directory style example #1
  • Directory style example #2
  • Directory style example #3
  • Directory style example #4
  • Actual Site #1
  • Actual Site #2
  • 1 of 3: plugin settings page
  • 2 of 3: plugin settings page
  • 3 of 3: plugin settings page

Installation

  1. Copy the whole dynamic-user-directory subdir into your plugin directory or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress
  3. Use the Settings->Dynamic User Directory screen to configure the plugin

FAQ

Installation Instructions
  1. Copy the whole dynamic-user-directory subdir into your plugin directory or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress
  3. Use the Settings->Dynamic User Directory screen to configure the plugin
Q: Does this plugin let me create custom fields on the user profile?

A: Dynamic User Directory strictly displays pre-existing user profile information in a searchable directory format. To create custom fields on the user registration/profile page, you’ll need a plugin such as WPForms, Meta Box, or Cimy User Extra Fields. Once your custom fields have been added to the user registration/profile page, simply enter the corresponding Meta Key names on the DUD settings page to show them in the directory.

Q: Why are the avatars misaligned in my directory?

A: The Dynamic User Directory plugin should play well with most themes. However, on occasion there may be CSS conflicts with a particular theme that skew the appearance. Currently the only known theme with this problem is the Basic theme. If you are using Basic or any other theme that skews the appearance, contact me and I will work with you to resolve the issue.

Q: Why is my selected avatar shape not working?

A: Some themes enforce a certain avatar shape. For example, the WordPress Twenty Fifteen and Twenty Sixteen themes do this. The Dynamic User Directory plugin intentionally does not interfere with the sitewide avatar settings, so the theme-enforced avatar shape will take precedence in your user directory display.

Q: Will this plugin support non-English languages?

A: Currently this plugin only supports English. However, there are plans to internationalize it in the near future!

Q: How do I contact you with questions or suggestions?

A: If you have a support question please create a thread under the Support tab of the plugin page. I will be glad to help you resolve the problem ASAP. You can also reach me at sarah@sgcustomwebsolutions.com. In the future I will have a page on my website dedicated to comments and FAQs.

Reviews

Exactly What I Needed

This plugin is PERFECT. Does exactly what I need (takes the information from my membership registration form and creates a directly that is listed alphabetically BY DISPLAYED NAME and IS SEARCHABLE.

It was so easy to set up. THANK YOU SO MUCH.

Easy to use. Great Plugin. Amazing Support!

I downloaded this plugin as a simple directory source for my organization’s intranet. My level of “technical know-how” is very minimal, but this plugin is very easy to use. There was an issue with a feature so I contacted Sarah (plugin creator) and she assisted me step by step, troubleshooting by email until the issue was resolved. For that, i’ll always be on the lookout for her new plugins!! I recommend this plugin for the novice and the advanced if you’re looking for a simple contact directory.

Excellent plugin

We have searched and tried multiple plugins to create our employee directory. This plugin works great and is able to use already existing data which is pulled from Active Directory.

Thank you for creating a plugin that truly will allow you to use all tupes of meta data. It works great!!

Read all 10 reviews

Contributors & Developers

“Dynamic User Directory” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.0

  • First public release.

1.0.1

  • Updated readme.txt.

1.0.2

  • Added default plugin settings.
  • Corrected a spacing issue related to the directory listing display.

1.0.3

  • Security update: Added SQL injection protection.
  • Fixed: Display issue related to show/hide user role feature.

1.0.4

  • Fixed: Spacing issue when a directory listing showed an avatar next to three or less lines of text.
  • Fixed: An extra underline was appearing in the empty space next to each letter link for themes that underline hyperlinks.
  • Fixed: The city and state of the address fields did not display if there was no zip code.
  • New Feature: A fifth meta field was added.
  • New Feature: An “Include/Exclude User” setting was added to provide a more customized directory.

1.1.0

  • New Feature: “Space between listings” setting added for greater formatting control
  • Fixed: Directory was not displaying results when using the include/exclude or hide user roles feature and sorting by display name
  • Fixed: Directory would not work if the default WordPress table name prefix had been changed (thanks, Jaya P!)
  • Fixed: Responsive display at very small screen sizes was not properly formatting the avatars

1.1.1

  • Successfully tested on WordPress 4.6
  • New Feature: Added 5 new meta fields for a total of 10 available meta fields (not including address fields).
  • New Feature: Added the User Meta Fields dropdown on the settings page so you can select the exact number of fields you need.
  • New Feature: Added the Address Fields checkbox so you can hide that section if you do not need it.

1.1.2

  • New Feature: Added a “link to author page” checkbox on the settings page that will hyperlink the user name and avatar to the user’s WP Author Page.
  • Code cleanup and reorganization

1.1.3

  • Internal change to code generating alpha links to eliminate potential display issues
  • New Feature: Added “Debug Mode” setting that will display a set of debug statements for Admins ONLY when turned on. This will help me debug site-specific issues more quickly.

1.1.4

  • New Feature: Added “Directory Type” dropdown on the settings page. You may select the “all users on one page” option to display the entire directory on one screen.
  • Code enhancement: Minified all CSS files for faster load time.

1.1.5

  • Code successfully tested on WordPress 4.7

1.1.6

  • New Feature: Added “Show search box” checkbox on the settings page that will show a search box at the top of the directory. You may search by user last name or display name, depending on the sort field.
  • Fixed: A message incorrectly stating that there are “no users in the directory” was being displayed when viewing the directory with the following settings: 1) the “Single Page Directory” option was selected, 2) The Sort Field was set to “Display Name,” and 3) users were selected for exclusion.

1.1.7

  • Enhancement: Added five filter hooks to allow developers to extend this plugin
  • Fixed: The city/state/zip portion of the address field was not showing if there was no state meta field. It will now show any portion of the city/state/zip address fields that is present.
  • Fixed: Search box was case sensitive, so that you could not search using all lowercase letters. You can now search using upper, lower, or mixed case.

1.1.8

  • Fixed: internal change in the id field of the letter dividers.

1.1.9

  • Fixed: Admin settings page did not set a default value for the letter divider font and fill colors,
    resulting in an error message if you submitted the page without choosing those colors.
  • Changed: Removed the Cimy User Extra Fields notification from the settings page for those who do not have that plugin loaded.

1.2.0

  • New Feature: Added Name Display Format on the settings page that will allow you to display name as “First Last” or “Last, First.”
  • Enhancement: Expanded the width of the key names listing and sorted it alphabetically for ease of use.
  • Enhancement: Added link to the Dynamic User Directory add-ons page.

1.2.1

  • Fixed: the code variable “$this” was causing fatal error in php 7.1. Changed variable name to correct problem.

1.2.2

  • Fixed: User meta fields that contained arrays would not display properly (e.g. multiple checkbox or radio button values stored in an array). It will now show a list of array items vertically, with one item per line.
  • Code enhancement: now storing all settings page options as an array in a single options setting. This will improve performance since every “get_option” call requires a database read.
  • New Feature: You can now choose to show Author Page links for all users rather than only for those with posts. This accomodates those who have a custom author.php page that should be shown regardless of the post count.

1.2.3

  • Fixed: Code was generating incorrect Letter Link URLs for certain intranet website confirgurations and for the WordPress “Plain” permalink setting. It will now generate the links correctly.
  • Enhancement: Added code to accommodate the new Meta Fields Search add-on.

1.2.4

  • Fixed: Corrected a null error warning: “Warning: in_array() expects parameter 2 to be array, null given” which may occur for those who do not have the Cimy plugin.

1.2.5

  • Fixed: Corrected a missing statement when the debug mode is turned on.

1.2.6

  • Enhancement: Added new code to accomodate the new Meta Fields Search add-on.
  • Fixed: Search box width was too long. Set new width to 45%.

1.2.7

  • New feature: Added the ability to hyperlink any meta field.
  • Enhancement: Added new code to accomodate the new Meta Fields Search add-on.
  • Internal code reorganization on the admin settings page.

1.2.8

  • IMPORTANT: If you have the Meta Fields Search or Alpha Links Scroll add-ons, you should see an update available for each of these on the plugins page. If you do not see these updates, contact me and I will resolve the issue. These should be run in tandem with the Dynamic User Directory update to 1.2.8.
  • Enhancement: Added new code to accomodate the new Multiple Directories add-on.
  • Fixed: when showing a dividing border and a letter divider on a single page directory, a dividing border was being displayed just before the letter divider of the single page directory.
  • Tweak: set the height of the default user search box to 40px.

1.2.9

  • Fixed: When the Meta Fields Search add-on is installed, and an invalid search value is entered, a PHP notice “Warning: Missing argument 2 for dud_build_srch_form_custom()” appears at the top of the page.

1.3.0

  • Fixed: Alpha links were not always properly created when the site uses a custom permalink structure, resulting in a 404 error.

1.3.1

  • Successfully tested against WP 4.8
  • Fixed: Letter divider was showing up on the Single Page Directory even when “No letter divider” was selected.
  • New Feature: You can now link the user name and avatar to their BuddyPress profile page in addition to the WP Author Page.