This addon can be used to create a list of all members on your site, with pagination and search option. It allows the public to easily navigate through the listing and access detailed profiles of the members.
The listing includes a “View Profile” link that the visitors can use to view the full profile of a user. As new members join the site, they are automatically included in the listing. The user listing is fully responsive so it works fine on all devices.
Table of Contents
- Example Screenshots of Display Output
- Installing the Addon
- Using the Member Directory Listing Addon
- Creating a New Directory Listing Page
- Difference Between the Listing Page and the Info/Details Page
- How to Recreate the Member Info/Details Page
- Using the Block to Add a Member Directory Listing
- Additional Usage Instruction
- Member Listing Page (Grid View) Shortcode Parameters
- Showing/Hiding Fields in the Listing (Grid View)
- Hiding the View Profile Link in the Listing
- Hiding the Member Search Box
- How Many Entries to Show Per Page
- Listing Members from a Particular Membership Level Only
- Listing Members with a Particular Account Status Only
- Listing Members Based on Member ID Values Only
- Exclude Specific Members by Member ID
- Member Info/Details Page Shortcode Parameters
- Sorting the Member Directory Listing
- Using this Addon with the Form Builder Addon
- Get the Member Listing Addon
- Addon Bundle Deal
Example Screenshots of Display Output
The screenshot below illustrates how members are listed on a post or page:
Clicking on the ‘View Profile‘ link will navigate to a new page where the complete details of the user are displayed.
If you are using the “Profile Image” field from the Form Builder addon, you can enhance your directory listing by including user profile images. See the example below:
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 Directory Listing Addon
When you first activate the add-on, it automatically creates a ‘Member Listing‘ page with a shortcode that displays all members in a grid layout. It also creates a ‘Member Info‘ page with a shortcode to show detailed profile information for individual members. You can customize these pages by modifying the shortcode parameters. Alternatively, you can create a new WordPress page to set up a member directory to your liking.
The add-on automatically creates the two necessary pages when activated, so it’s ready to use right away. To access them, go to the ‘Member Directory’ link under the main Simple Membership plugin menu. This section displays the URLs of the generated pages. You can preview these pages to see how the member directory looks. To make it accessible to your visitors, simply add the listing page to your site’s navigation menu.
The screenshot below shows an example of what the Member Directory add-on menu looks like.
Creating a New Directory Listing Page
You can create as many member listing (grid view) pages as you like. These pages can display all members or be limited to specific membership levels or account statuses. Below are the steps for creating a new member directory listing page.
Note: Before creating your own directory listing page or modifying the shortcodes, it’s recommended to review the default listing and info pages generated by the add-on. This will give you a clear understanding of how the add-on works and help avoid confusion when making customizations.
Step 1) Create a new WordPress page where you want to show the listing (to display the member directory listing in a grid format).
Step 2) Add the following shortcode to this newly created page. This shortcode can be customized using various parameters. The section below explains the available shortcode options in detail.
[swpm_show_member_listing]
This shortcode will generate a member listing on the page. This listing serves as a concise directory, displaying essential details for each user in a grid view. Visitors can easily navigate the list, and with a click on the ‘View Profile’ link associated with each entry, they can access more comprehensive information about specific users.
Step 3) Ensure the member information/details/profile page exists. This page, which displays the full profile details of a member, is automatically created when the addon is activated.
Upon activation, the add-on creates a WordPress page titled ‘Member Info’, which should not be deleted. This page includes a shortcode that, when the ‘View Profile’ link is clicked, will display the complete details of a member’s profile. Note that this ‘Member Info/Details’ page is distinct from the listing page that you created in Step 2.
Difference Between the Listing Page and the Info/Details Page
This addon involves two pages that are commonly confused. The following explanation will clarify the differences between them.
Member Listing Page: This page displays all members in a grid view, providing a summary list that allows users to browse easily.
Member Info/Details/Profile Page: In contrast, this page offers comprehensive details of a specific member, accessible by clicking the ‘View Profile’ link on the Member Listing Page.
How to Recreate the Member Info/Details Page
If you have accidentally deleted the Member Info/Details page that this addon creates at install time, do the following to recreate it:
- 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.
Using the Block to Add a Member Directory Listing
In addition to using a shortcode, the addon includes a dedicated WordPress block called “Simple Membership Member List”. This block allows you to easily add a member directory to any page on your site.
The block also provides customization options, enabling you to show or hide specific fields as needed. You can configure these settings directly within the block options.
Refer to the screenshot below for a visual reference.
Block for the Member Info/Details Page
The addon includes a dedicated block for displaying a member’s full details on the Info/Details page.
When the addon is installed, it automatically creates this page with a shortcode. You can edit the page and replace the shortcode with the “Simple Membership Member Info/Details” block for a more seamless integration.
Refer to the screenshot below for a visual reference.
Additional Usage Instruction
The following section contains further instructions for customizing the output of the member listing (grid view) and the info/details page using shortcode parameters.
To customize certain aspects of the output, you can include parameters in the shortcode used for the listing and info/details pages. The following section has explanation of what each shortcode parameter does. You can edit the page containing the shortcode then add parameters to suit your needs.
Member Listing Page (Grid View) Shortcode Parameters
This is useful if you’re using the shortcode instead of the block. Below is the shortcode for displaying the member listing page in a grid layout. The following section explains how to show or hide various details in the listing.
[swpm_show_member_listing]
Showing/Hiding Fields in the Listing (Grid View)
By default, the member listing (grid view) displays each member’s name, membership level, and country. You can use additional shortcode parameters to show or 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_mailto
- member_since
- gender
- company_name
- address_street
- address_city
- address_state
- address_zipcode
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"]
You can use the email parameter to show the email address in plain text format. Alternatively, you can use the email_mailto parameter to show the email address using the “mailto” link.
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"]
Listing Members Based on Member ID Values Only
You can utilize the “from_member_ids” parameter within the listing shortcode to display users based on specific member ID values.
For instance, the shortcode below will showcase members with the given member IDs:
[swpm_show_member_listing from_member_ids="10,32,45,50"]
Exclude Specific Members by Member ID
You can exclude specific members from the directory listing by using the “exclude_member_ids” parameter in the shortcode. This allows you to prevent certain members from appearing based on their Member ID.
For example, the following shortcode excludes members with the specified Member IDs:
[swpm_show_member_listing exclude_member_ids="12,13,15"]
Member Info/Details Page Shortcode Parameters
This is useful if you’re using the shortcode instead of the block. The shortcode below displays the info/details/profile page with full details of a single member. Visitors are directed to this page when they click the ‘View Profile’ link from the grid view member listing.The following section explains how to show or hide various details in this info/details page.
The shortcode for the info/details page is the following:
[swpm_show_member_profile]
Showing/Hiding Fields on the Info/Details Page
By default, the member info/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_mailto
- member_since
- gender
- company_name
- address_street
- address_city
- address_state
- address_zipcode
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 (in plain text format) and the email address (with “mailto” link) from the profile details page:
[swpm_show_member_profile email="0" email_mailto="0"]
Sorting the Member Directory Listing
Sorting by Member 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 demonstrate 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="DESC"]
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"]
Sorting by Membership Level
To sort the member listing by membership level, use the sort_by="membership_level" parameter in the shortcode. See example below:
[swpm_show_member_listing sort_by="membership_level" sort_order="ASC"]
Sorting by Company Name
To sort the member listing by company name, use the sort_by="company_name" parameter in the shortcode. See example below:
[swpm_show_member_listing sort_by="company_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:
If you are using this template and want to display the profile photo on the Full Profile page, then edit the shortcode in the details page to add the ‘profile_image’ parameter. Below is an example shortcode to show full profile details with profile photo:
[swpm_show_member_profile profile_image="1"]
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.
Add 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
This is a one-time payment (includes 1 year of support and updates).
Addon Bundle Deal
Form Builder + Member Directory Listing
Single Site
Full Price: $87
Discounted Price: $69