Simple Membership - Member Directory Listing Addon

This addon can be used to create a list of all the users on your site, with pagination and search option.

The listing includes a “View Profile” link that the visitors can use to view the full profile of a user. When new members are added to the site, they will automatically show up in the listing. The user listing is fully responsive so it works fine on all devices.

The following screenshot shows an example of how the members are listed on a post or page:

swpm-member-directory-listing-example

Clicking on the view profile will open a new page which will show the full details of the user.

If you are using the “Profile Image” field from the form builder addon then you can also create a directory listing with the user profile images. Example below:

member-directory-listing-example-template-2

Installing the Addon

Click on the Add New menu under the plugins interface.
Click on the the Upload Plugin button to go to the upload tab.
Upload the swpm-member-directory.zip file.
Hit the Install Now button and then activate the addon.

Using the Member Listing Addon

Step 1) Create a new WordPress page (where you want to show the listing)

Step 2) Add the following shortcode to this newly created page

[swpm_show_member_listing]

The above shortcode will output the member listing on the page. The purpose of the listing page is to list all the user entries with a small number of details. A visitor can click on the “View Profile” link from the listing entry to view more details of a particular user.

Step 3) Check and make sure the member details page exists (this is the page that the addon uses to show the full profile of a member).

The addon automatically creates a WordPress page called “Member Info” at activation time (do not delete this page). This page contains a shortcode that will show the full member details when the “View Profile” link is clicked.

How to Recreate the Member Details Page

If you have accidentally deleted the Member Details page this addon creates at install time, then do the following:

Create a new page (call it something like Member Details).
Add the [swpm_show_member_profile] shortcode to this page.
Enter the URL of this page in the Member Details Page URL settings field of this addon.

swpm-member-details-settings-field-interface

Additional Usage Instruction

The following section provides additional usage instruction that can be used to customized the member listing.

Hiding the View Profile Link in the Listing

If you don’t want to have the “View Profile” link in the listing then use the following additional parameter in the shortcode to turn it off:

[swpm_show_member_listing profile_button="0"]

Hiding the Member Search Box

You can hide the member search box from the listing by using the search_box=”0″ parameter in the shortcode. Example usage below:

[swpm_show_member_listing search_box="0"]

How Many Entries to Show Per Page

By default, the listing will show 30 entries per page. The visitor can use the pagination to browse all the entries. You can change that number by using the “items_per_page” parameter in the shortcode. Example usage below:

[swpm_show_member_listing items_per_page="50"]

Listing Members from a Particular Membership Level Only

By default, the listing will show all your members. You can use the “from_levels” parameter in the listing shortcode to show users from a particular membership level.

For example, the following will list all members from level 2:

[swpm_show_member_listing from_levels="2"]

The following will list all members from membership levels 2, 3 and 4:

[swpm_show_member_listing from_levels="2,3,4"]

Listing Members with a Particular Account Status Only

You can use the “from_account_status” parameter in the listing shortcode to show users with a particular account status.

For example, the following listing shortcode will list members with an active account status only:

[swpm_show_member_listing from_account_status="active"]

The following shortcode will list all members from level 2 with an active account status:

[swpm_show_member_listing from_levels="2" from_account_status="active"]

Showing/Hiding Other Member Fields in the Listing

By default, the member listing page entries shows the member’s name, level and country. You can use additional shortcode parameters to show/hide other fields.

The following parameters can be used in the shortcode to control which fields you show/hide in the listing entries.

member_id
user_name
first_name
last_name
membership_level
account_state
full_address
country
phone
email
member_since
gender
company_name

Using a value of “1” will show the field. Using a value of “0” will hide the field.

For example, the following will show the member’s name, level, country, email address and phone number:

[swpm_show_member_listing first_name="1" last_name="1" membership_level="1" country="1" email="1" phone="1"]

Showing/Hiding Other Member Fields in the Profile Details Page

By default, the member profile details page shows the member’s username, name, level, country, phone, email, member since. You can edit the member details page and use additional shortcode parameters to show/hide other fields.

The following parameters can be used in the member details page shortcode to control which fields you show/hide in there.

member_id
user_name
first_name
last_name
membership_level
account_state
full_address
country
phone
email
member_since
gender
company_name

Using a value of “1” will show the field. Using a value of “0” will hide the field.

For example, the following will hide the email address from the profile details page:

[swpm_show_member_profile email="0"]

Sorting The Listing by Member’s Name

You can sort the member listing by name so the entries are listed Alphabetically. You can edit the member listing page and add the “sort_by” and “sort_order” parameters in the shortcode for this.

The example shortcodes below show the available sorting options:

The following shortcode will sort the member listing by Last name in an ascending order.

[swpm_show_member_listing sort_by="last_name" sort_order="ASC"]

The following shortcode will sort the member listing by Full/First name in a descending order.

[swpm_show_member_listing sort_by="full_name" sort_order="DSC"]

The following shortcode will sort the member listing by username in a descending order.

[swpm_show_member_listing sort_by="user_name" sort_order="ASC"]

Using this Addon with the Form Builder Addon

If you are using both the form builder addon and this addon then check the following section which explains various form builder related options.

Listing with Member Profile Photo

If you are using profile image field in the form builder addon then you can use the 2nd template to list the members with their profile photos. Below is an example shortcode

[swpm_show_member_listing template="2"]

You can also use the other parameters (explained above) in this shortcode to show additional details in the listing.

This template will produce an output like the following:

member-directory-listing-example-template-2

Handling Custom Fields from Form Builder Addon

If you are using the form builder addon then you can optionally show all the custom fields of a member in the member’s profile details page.

Use the “show_custom_fields” parameter in the details page shortcode to show/hide the custom fields.

For example, the following will show the custom fields of a member when his profile is being viewed:

[swpm_show_member_profile show_custom_fields="1"]

Get the Member Listing Addon

SWPM Member Directory Listing