Looking For Something?

[wps-directory]

Purpose

Displays a directory of your site members. For distance to work with a user, it requires that user to have saved their profile via Edit Profile with Town/City and Country.

Availability

Provided in the Core Plugin.

Customising

You can use the global shortcode settings via WPS Pro->Shortcodes in the admin dashboard, or add them to the shortcode as options.

For some characters (character sets), you will need to make sure that you have installed WordPress with correct character set.

If you have problems, you might try changing the following setting in wp-config.phps: define(‘DB_CHARSET’, ”); and you might need to add something like <meta http-equiv=”Content-Type” content=”text/html; charset=iso-8859-1″ /> to your theme header.

You can also include profile extensions in your member directory if you have the Extensions plugin, see here on how to do that

Example

Show the directory, as a table style:

[wps-directory style="table"]

Options

The following (which shows default values and an example of using the shortcode option) can be set via the admin dashboard (WPS Pro->Shortcodes) or added as options to the shortcode in your WordPress page, post or widget.

Purpose

Displays a directory of your site members. For distance to work with a user, it requires that user to have saved their profile via Edit Profile with Town/City and Country.

Availability

Provided in the Core Plugin.

Customising

You can use the global shortcode settings via WPS Pro->Shortcodes in the admin dashboard, or add them to the shortcode as options.

For some characters (character sets), you will need to make sure that you have installed WordPress with correct character set.

If you have problems, you might try changing the following setting in wp-config.phps: define(‘DB_CHARSET’, ”); and you might need to add something like <meta http-equiv=”Content-Type” content=”text/html; charset=iso-8859-1″ /> to your theme header.

You can also include profile extensions in your member directory if you have the Extensions plugin, see here on how to do that

Example

Show the directory, as a table style:

[wps-directory style="table"]

Options

The following (which shows default values and an example of using the shortcode option) can be set via the admin dashboard (WPS Pro->Shortcodes) or added as options to the shortcode in your WordPress page, post or widget.

Style (style=”classic”)
How the directory should be displayed.
Order field (order=”last_name”)
The order in which the users should be displayed.
Order (orderby=”DESC”)
Whether the order should be ascending or descending.
No results text (no_results_msg=”No users found.”)
What to show if there are no users to show.
Show A to Z (a_to_z=”1″)
Should a list of A to Z be shown to select from?
A to Z values (match=”ABCDEFGHIJKLMNOPQRSTUVWXYZ”)
The values to include, each letter is checked against first letter of the user display name.
Show missing A to Z (missing=”1″)
If not applicable, should letters in the A to Z be shown?
Maximum number shown (number=”50″)
Maximum number of users to display.
Query limit (limit=””)
Query can be limited to improve performance (number of rows).
Avatar size (avatar_size=”64″)
Size of the user avatar.
Show first name/last name instead of display name (firstlast=”1″)
Show first name and last name, useful if sorting by last name. Consider if people are actually filling these in though on your site. Also, do they know it will get displayed? Better to tell them, think about privacy implications!
Link display name to profile page (link=”1″)
Should the display name of the user link to their profile page?
Show location (show_location=”1″)
Include user location?
Show distance (show_distance=”0″)
Include distance to user (if they have set their location)?
Convert miles to km (show_in_km=”0″)
Rather than miles, shown distance in kilometers.
Show date (show_date=”1″)
Include date field?
Date label (date_label=”Last active”)
Label for the date field.
Last active format (last_active_format=”%s ago”)
String for when last active.
Show by default (show_by_default=”1″)
Show the directory immediately on page load?
Show registration date (show_registered=”1″)
Include when the user registered on the site?
Registration date label (registered_label=”Joined”)
Label for registration.
Show friendship status (slows page!) (show_friendship_status=”1″)
Include status of each user friendship? This impacts on page load time.
You are friends text (friends_yes=”Joined”)
Text displayed.
Friendship request pending text (friends_pending=”You have requested to be friends”)
Text displayed.
Friendship request received text (friend_request=”You have a friends request”)
Text displayed.
Not friends text (friends_no=”You are not friends”)
Text displayed.
Layout (layout=”list”)
Whether the users should be a list, or “floated” beside each other (fluid).
Show friendship action button (include_friendship_action=”1″)
Include button to make/cancel friendships?
Optional CSS class for button (friendship_class=””)
A CSS class to add to the button.
Make friends label (friend_add_label=”Make friends”)
Text displayed.
Cancel friendship label (friend_cancel_label=”Cancel friendship”)
Text displayed.
Cancel friendship request label (friend_cancel_request_label=”Cancel Request”)
Text displayed.
Accept request label (accept_request_label=”Accept Friendship”)
Button label.
Reject request label (reject_request_label=”Reject”)
Button label.
Include current user (include_self=”1″)
Should the current user be included in the directory?
WordPress roles to include (roles=”administrator,editor,author,contributor,subscriber,”)
The WordPress roles to be included, should be at least one selected.
Sidebar