Installation & Setup
Upload Plugin
Plugins → Add New → Upload Plugin. Select wp-user-directory.zip and click Install Now.
Activate
Click Activate. Adds the manage_user_directory capability and registers a Department shadow taxonomy.
Configure
Go to Users → Directory Settings. Choose which user roles appear, set items per page, and toggle email visibility.
Publish Directory
Add [user_directory] to any page. Add [edit_my_profile] to the account page for self-service profiles.
Plugin Features
Live AJAX Search
Searches by name, department, skills, or location. 300ms debounce, no page reload.
6 Profile Meta Fields
Phone, Department, Skills, LinkedIn URL, Location, and Public Bio — all stored as WP user meta.
Front-End Editing
[edit_my_profile] shortcode. Logged-in users update their own profile without wp-admin access.
Role Filtering
Show only specific WordPress roles in the directory via the role shortcode attribute.
Department Taxonomy
Shadow CPT taxonomy bridges the gap between WordPress users and taxonomy-based filtering.
REST API
GET members and single member endpoints. Returns all public meta fields in the response.
Shortcodes & REST API
Member Directory
Renders the searchable member grid. Respects role and department filters.
[user_directory] [user_directory department="engineering" per_page="12" role="editor,author" orderby="display_name"]
| Attribute | Default | Description |
|---|---|---|
department | all | Department taxonomy slug to filter by. |
per_page | Settings value | Members per page. |
role | Settings value | Comma-separated WordPress role slugs (e.g. editor,author). |
orderby | display_name | Sort by: display_name, registered, user_email. |
order | ASC | Sort direction: ASC or DESC. |
Profile Edit Form
[edit_my_profile]
Only visible to logged-in users. Guests see a login prompt. Users edit their own Phone, Department, Skills, LinkedIn, Location, and Bio.
REST API
GET /wp-json/wpud/v1/members Public — returns active members GET /wp-json/wpud/v1/members/{id} Single member with all meta fields