pmpro_member_directory-avatarsEnhance your membership site with a public or private, searchable directory and NEW member profiles. The add on includes two shortcodes, which can be customized with easy-to-define attributes.

Member Profiles have special handling for file-type fields (audio, video, image, document, YouTube, Vimeo). The shortcode will embed or display based on mime type.

View the Add On


Directory and Profile Shortcode Attributes

pmpro_member-directoryShortcode attributes for [pmpro_member_directory] include:
  • avatar_size: The square pixel dimensions of the avatar to display. Requires the “show_avatar” attribute to be set to ‘true’. default: ‘128’ (accepts any numerical value).
  • fields: Display additional user meta fields. default: none (accepts a list of label names and field IDs, i.e. fields=”Company,company;Website,user_url”).
  • layout: The format of the directory. default: div (accepts ‘table’, ‘div’, ‘2col’, ‘3col’, and ‘4col’).
  • levels: The level ID or a comma-separated list of level IDs to include in the directory. default: all levels (accepts a single level ID or a comma-separated list of IDs).
  • limit: the number of members to display per page
  • link: Optionally link the member directory item to the single member profile page. default: true (accepts ‘true’ or ‘false’).
  • order: Sort the results based on the order_by attribute in ascending or descending order. default: ASC (accepts ‘DESC’ or ‘ASC’).
  • order_by: The sort order for the results. default: ‘u.display_name’ (accepts ‘u.user_email’, ‘u.user_email’, ‘u.display_name’, ‘u.user_login’, ‘u.user_registered’, ‘mu.membership_id’, ‘mu.startdate’, ‘joindate’)
  • show_avatar: Display the user’s avatar generated via Gravatar or user-submitted using a plugin like Simple Local Avatars; default: true (accepts ‘true’ or ‘false’).
  • show_email: Display the user’s email address; default: true (accepts ‘true’ or ‘false’).
  • show_level: Display the user’s membership level; default: true (accepts ‘true’ or ‘false’).
  • show_search: Display a search form (searches on member display name or email address); default: true (accepts ‘true’ or ‘false’).
  • show_startdate: Display the user’s membership start date for their current level; default: true (accepts ‘true’ or ‘false’).

pmpro_member-profileShortcode attributes for [pmpro_member_profile] include:
  • avatar_size: The square pixel dimensions of the avatar to display. Requires the “show_avatar” attribute to be set to ‘true’. default: ‘128’ (accepts any numerical value).
  • fields: Display additional user meta fields. default: none (accepts a list of label names and field IDs, i.e. fields=”Company,company;Website,user_url”).
  • levels: The level ID or a comma-separated list of level IDs that allow profiles. default: all levels (accepts a single level ID or a comma-separated list of IDs).
  • show_avatar: Display the user’s avatar generated via Gravatar or user-submitted using a plugin like Simple Local Avatars; default: true (accepts ‘true’ or ‘false’).
  • show_bio: Display the user’s bio (if available); default: true (accepts ‘true’ or ‘false’).
  • show_billing: Display the user’s billing address (if available); default: true (accepts ‘true’ or ‘false’).
  • show_email: Display the user’s email address; default: true (accepts ‘true’ or ‘false’).
  • show_name: Display the user’s display name; default: true (accepts ‘true’ or ‘false’). Use our Force First Last plugin to batch update display names.
  • show_level: Display the user’s membership level; default: true (accepts ‘true’ or ‘false’).
  • show_phone: Display the user’s billing phone (if available); default: true (accepts ‘true’ or ‘false’).
  • show_search: Display a search form (searches on member display name or email address); default: true (accepts ‘true’ or ‘false’).
  • show_startdate: Display the user’s membership start date for their current level; default: true (accepts ‘true’ or ‘false’).
  • user_id: Show a specific member’s profile; default: none (accepts any numeric uesr id, i.e. user_id=”125″).

Members can opt out of the member directory by checking the “Hide from Directory?” field on the “Edit Profile” page.


Notes about File-type Fields

If you are displaying a field that is a file type (audio, video, image, document), the shortcode will attempt to embed or display the file based on the mime type (about WordPress filetypes).


Notes about other Third-Party embeddable links (YouTube, Vimeo, etc.)

The field will also display as an embed (list of supported sites here) if the field value can be embedded via oEmbed (about WordPress oEmbeds).


Installation

  1. Members with a valid PMPro Plus license can install and activate this add on via the Memberships > Add Ons admin page. Or, download the zip file (above) and upload the ‘pmpro-member-directory’ directory to the ‘/wp-content/plugins/’ directory of your site.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Create a page for your directory and set the appropriate shortcode attributes and “Require Membership” settings per your needs.
  4. Create a page for your profile and set the appropriate shortcode attributes and “Require Membership” settings per your needs.
  5. Navigate to Memberships > Page Settings to assign your pages to the Directory and Profile page settings.
View the Add On

Shortcode Examples

Show only level IDs 1 and 4, hide avatars and email address:

[pmpro_member_directory levels="1,4" show_avatar="false" show_email="false"]

Show all level IDs, hide level name and start date:

[pmpro_member_directory show_level="false" show_startdate="false"]

Show a unique member directory by level. Level 1 Members can only see other Level 1 Members…:

[membership level="1"]
[pmpro_member_directory levels="1"]
[/membership]
 
[membership level="2"]
[pmpro_member_directory levels="2"]
[/membership]
 
[membership level="3"]
[pmpro_member_directory levels="3"]
[/membership]

Show unique member profiles based on level – hide user phone number and email address.

[membership level="1"]
[pmpro_member_profile show_email="false" show_phone="false"]
[/membership]
 
[membership level="2"]
[pmpro_member_profile show_email="true" show_phone="true"]
[/membership]

Screenshots

Member Directory – 4 Column Layout
pmpro_member_directory-avatars


Member Directory – Table Layout
pmpro_member-directory-table


Member Profile
pmpro_member-profile


Member Profile with File Embeds
pmpro_member_profile-files


Author’s gravatar

There is no end date field available?

Reply
Author’s gravatar

No, but good idea. We’ve done “Member Until _____” in custom templates for people. I’m talking with Kim RE a way to add it to the add on/shortcode.

Reply
Author’s gravatar

I am also looking for a way to have an end date. I tried using “pmpro_membership_enddate”, “enddate”, etc to no avail. I’m excited that you are thinking of adding this functionality

Author’s gravatar

Second me on that end date. We like to make sure our members are well aware of their expiration date.

Author’s gravatar

Hi there, I have a question, sorry if I’m just missing it.

Where you have this instruction:

“fields: Display additional user meta fields. default: none (accepts a list of label names and field IDs, i.e. fields=”Company,company;Website,user_url”).”

Would “Company,company” be a custom input on the profile page?

Where can we set it up so users can add this info in their user profile?

Is there a place where we can see a list of available user meta fields we could add to the directory and profile pages?

Reply
Author’s gravatar

I’ll put together a comprehensive list of available fields and update the add on documentation on the Member Directory and Profile add on page. That would be a helpful addition 🙂

If you have added additional fields via the Register Helper add on, those would be available for display as well. To allow a member to update their profile display with additional fields, add them via Register Helper. You can then direct your members to update their profile via the Membership Account page “Edit Profile” link.

Reply
Author’s gravatar

I’ve created the following shortcode which is displaying nicely. [pmpro_member_directory layout=”table” link=”true” avatar_size=”40″ limit=”50″ levels=”1″ show_email=”false” show_level=”false” fields=”city,city”]
But for some reason the link field doesn’t seem to do anything. Nothing on the page is clickable through to a profile page. Shouldn’t something like the name or avatar become clickable?

Reply
Author’s gravatar

Yes the display name and avatar should be hyperlinked as in this demo as well as a “View Profile” link:

http://memberlitetheme.com/addon-demos/member-directory/.

Do you have a page assigned as the “member profile” under Memberships > Page Settings? Since this is a PMPro Plus license, we can provide specific support for your project via the member forums. Just open a topic here: https://www.paidmembershipspro.com/new-topic/

Reply
Author’s gravatar

Thanks Kimberly, that was the missing item and did the trick. As a follow on, is there any single piece of product documentation that has all fields/names listed? It really drives me a bit crazy every time I go make an update or link into a field to have to surf through all the blogs to try and find the one entry for a specific module to find the field names to make updates.

Author’s gravatar

Im looking for a concise set of documentation on this too, I know that you make your money from the paid support, but it takes far too long to get your questions answered via support. Even if you made the documentation only available to logged in paid support customers?

Im looking for a widget or shortcode to allow me to include a search bar on other pages that searches the members directory and directs the user to the results in the directory. Any help please?

Reply
Author’s gravatar

No option for adding company or web address to the profile page? I tried ‘fields=”Company,company;Website,user_url”’ without success.

Reply
Author’s gravatar

Hey Kim and Jason,
Is it possible to display a filtered group of members in the pmpro directory, by specific user meta that I added using the register helper? I’d like to display a small group of “Featured” members on our homepage for non-logged in users. Admins are able to select featured checkbox currently on the member profile.

Is this the right direction? https://www.paidmembershipspro.com/search-specific-user-and-user-meta-fields-register-helper-fields-on-the-members-list/

Reply
Author’s gravatar

This would be an interesting improvement to the Member Directory Add On – right now it would need a custom template. If you post a topic on our members forum we should be able to work through the concept with you. I’ll make a note on the development goals for our Member Directory to consider this feature.

Reply
Author’s gravatar

Hey Kim / Jason,

I would like to do something similar. Is there any way to have the directory profiles visible to non logged in users?

Thanks!

Author’s gravatar

Hi @stevedya,

As long as the page you add the `[pmpro_member_directory]` shortcode to does not have a require membership level selected, this page should be visible to all users. Once you select a membership level to be required to view the page, then it will be restricted to those members only.

Hope this helps!

Leave a Reply

Your email address will not be published. Required fields are marked *