Member Directories 2.1.0+

This article describes a member directory settings. You can use the existing member directory or create a new one on wp-admin > Ultimate Member > Member Directories.

Contents

General Options #

View type(s) - this option allows you to select view types of the Member Directory. There are able Grid and List views. If you select more than 1 view type, there will be displayed the change layout button at the member directory front-end.

Default view type - this option allows you to select default view type from already selected view type(s).

User roles to display – this option allows you to select which user roles are displayed in the directory. If left blank the directory will display the profile cards of all members of your site.

Only show members who have uploaded a profile photo – this option allows you to only show members who have uploaded a profile photo. If turned on any member who does not upload a profile photo will not be shown in the directory. This option is turned off by default.

Only show members who have uploaded a cover photo – this option allows you to only show members who have uploaded a cover photo. If turned on any member who does not upload a cover photo will not be shown in the directory. This option is turned off by default.

Only show specific users (Enter one username per line) - this option allows you to show only selected members by username.

Exclude specific users (Enter one username per line) - this option allows you to exclude only selected members by username.

Only show members who have completed their profile - this option allows you to show only members who completed their profile with the Required completeness (%) option value. The last one is visible when the "Only show members who have completed their profile" option is enabled. These options are integrated by the Profile Completeness extension.

Only show members who have verified their profile - this option allows you to only show members who verified their profile. This option is integrated by the Verified Users extension.

Sorting Options #

Default sort users by - this option allow you to decide the order of how members are shown in the directory.

You can sort members by:

Plugin Fields
Ultimate Member New users first. Is used by default
Old users first
Display name
First name
Last login
Last name
Other (Custom Field). Allows you to insert field key to the option "Meta key" and "Label of custom sort" below
Random
Username
Nickname
Ultimate Member - Followers Most followed
Least followed
Ultimate Member - Friends Most friends
Least friends
Ultimate Member - myCRED Most points
Least points
Ultimate Member - Profile Completeness Most completed
Least completed
Ultimate Member - User Reviews Highest rated first
Lowest rated first
Ultimate Member - Verified Users Verified accounts first
Not verified accounts first

Enable custom sorting - this option allows you to show the dropdown with sorting options, which are selected in the "Choose fields to enable in sorting" option.

Choose fields to enable in sorting - this option allows you to select the fields for the member directory sorting. If you select the "Other (Custom Field)." option, please fill the fields "Meta Key" and "Label" below. Note: the value of the "Default sort users by" option will be added to the list on the frontend if it is not selected here. If the total number of unique sorting options for a directory is 1 or less, the sorting field will be hidden on the frontend. And users will be sorted by default sort value.

Profile Card #

Enable Profile Photo - This option allows you to show or hide the user profile photos on the member directory.

Enable Cover photo - This option allows you to show or hide the user cover photos on the member directory. Note: There isn’t a cover photo in the "List" layout.

Show display name - This option allows you to show or hide the user display name on the member directory.

Hide followers stats - option integrated by the Followers extension. If it isn’t checked gets from Ultimate Member > Settings > Extensions > Followers > Show followers stats in member directory.

Hide follow button - option integrated by the Followers extension. If it isn’t checked gets from Ultimate Member > Settings > Extensions > Followers > Show follow button in member directory.

Hide rating stats - option integrated by the User Reviews extension. If it isn’t checked gets from Ultimate Member > Settings > Extensions > Reviews > Show user rating in members directory.

Hide myCRED badges - option integrated by the myCRED extension. If it isn’t checked gets from Ultimate Member > Settings > Extensions > myCRED > Show user badges in Member Directories?

Hide friends stats - option integrated by the Friends extension. If it isn’t checked gets from Ultimate Member > Settings > Extensions > Friends > Show friends stats in member directory.

Hide friend button - option integrated by the Friends extension. If it isn’t checked gets from Ultimate Member > Settings > Extensions > Friends > Show friend button in member directory.

Hide online stats - option integrated by the Online extension. If it isn’t checked gets from Ultimate Member > Settings > Extensions > Online > Show online stats in member directory.

Hide message button in a directory? - option integrated by the Private Messages extension. If it isn't checked gets from Ultimate Member > Settings > Extensions > Private Messaging > Show messages button in member directory.

Show tagline below profile name - This option allows you to show the user meta below the user display name. This could be an important piece of information relevant to your site e.g you could show the user’s nationality below the display name. Below this option is the user meta "Choose field(s) to display in tagline"

Show extra user information below tagline? - This option allows you to show extra user meta below the tagline. If you select yes it will show an option Enable reveal section transition by default show the information in a reveal section (the information is hidden until the user clicks the arrow) or show it on page load. Below this option is the user meta selector "Choose field(s) to display in reveal section" where you can choose which field(s) to add to this area of the profile card.

Show social connect icons - This option allows you to social icons on the profile card which link to a user’s social media accounts. The social icons are LinkedIn to the social fields which are found in the pre-defined fields list. If a user does not enter any information in the relevant social media field then the social icon will not show e.g if a user does not enter their Twitter username in the Twitter field then the Twitter field will not show on their profile card.

Enable Search feature - This option allows you to show or hide the general search line on the member directory. If you enable the search "User Roles that can use search" option will appear below.

Ultimate Member uses for the searching all Ultimate Member custom metadata, created via Ultimate Member > Forms > Fields screen and WP native fields like username, user_email, display_name, first_name, last_name, user_nicename.

User Roles that can use search - This option allows you to select which user roles can use the general search line. If left blank anyone can use the search line.

Enable Filters feature - This option allows you to show or hide the filters on the member directory. If you enable the filters "User Roles that can use filters" and "Choose filter(s) meta to enable" options will appear below.

User Roles that can use filters - This option allows you to select which user roles can use the filters. If left blank anyone can use the filters.

Choose filter(s) meta to enable - This option allows you to select fields that will be shown in the filters section. The filters section can be expanded by default via the Expand the filter bar by default option below. Please note that not all field types are allowed in the search filters, so not all of your custom fields will appear in this list.

There are 4 filter types by default in Ultimate Member core and extensions: Dropdown, Slider range, Date range, and Time range.

The values available in the filters (Dropdown options, Slider range limits, Date range period) depend on the members' data. Therefore, a dropdown option is shown if there are members who have selected this option in their profiles. The option is hidden if no one has selected this option in their profile.

Table - Supported filter fields and their types.

Field Type
Ultimate Member Core predefined fields
Country Dropdown
Gender Dropdown
Languages Dropdown
Roles* Dropdown
Age(Birth Date field) Slider range
Last Login Date range
User Registered Date range
Ultimate Member Core custom fields
Timepickers Time range
Datepickers Date range
Rating fields Slider range
Checkboxes Dropdown
Radio buttons Dropdown
Selects/Multiselects Dropdown
UM: myCRED
Rank Dropdown
Balance Slider range
UM: Online
Online Status Dropdown
UM: Profile Completeness
Completeness Slider range
UM: User Reviews
User Rating Slider range
UM: Woocommerce
Billing Country Dropdown
Shipping Country Dropdown
Total Orders Slider range
Total Spent Slider range
UM: User Tags
User Tags custom field Dropdown

Note: The Role is a reserved word to determine if the field is a role field.

Image - Filters in the member directory.

Admin filtering - this option allows you to select the predefined filters that display users on the page's first loading. All fields available for front-end filtering are available here. Particular attention should be paid to the fact that if a field for a predefined filter is selected, and then filtered by it using “Choose filter(s) meta to enable” fields, then the “Choose filter (s) meta to enable” fields will be more priority.

Results & Pagination #

Show results only after search/filtration - you can decide how to display members in the directory. On page loading or after the searching/filtration.

Maximum number of profiles, Number of profiles per page, Number of profiles per page (for Mobiles & Tablets) - you can decide the number of profiles to show on each page (Please note: the higher the number the longer the page will take to load) and there is also an option to limit the total number of profiles that will be shown in this directory (leave blank to show all users in the directory).

Results Text - This option allows you to customize the text that is shown after a user performs a search. The tag {total_users} will show the number of users that match the search criteria. The same but for single result Single Result Text option.

Custom text if no users were found - This option allows you to customize the text that is shown after a user performs a search and the search returns empty (no users were matched the search criteria).