[memb_member_listing]
This Applies to
Shortcode Video
Summary
This shortcode displays a list of users based on their user role or tag ID. The list can display their first and last name, Gravatar, IP address, and total number of logins.
In order for this to work, “Sync Meta Updates” option under Memberium => Settings => Performance tab needs to be enabled. In addition, for a user to be listed in the listing, they need to have logged into the site at least once or have had a Contact Update HTTP POST run on them.
This shortcode will display 10 users by default and if you’d like to display more users then you’d need to use the “count” parameter.
Also note that by default, this shortcode will only display users that have a “subscriber” user role. If you’d like to display other user roles, then you’d need to specify the role using the “roles” parameter (see examples below).
Shortcode Examples
Display a list of users who have “Memberium Gold” user role:
[memb_member_listing roles="Memberium gold"] [memb_gravatar email="%%contact.email%%"] Name: %%contact.firstname%% %%contact.lastname%% IP: %%meta.ipaddress%% Logins: %%meta.login_count%% [/memb_member_listing]
Display a list of users who have the tag ID “101” for example:
[memb_member_listing tag_id=101] [memb_gravatar email="%%contact.email%%"] Name: %%contact.firstname%% %%contact.lastname%% IP: %%meta.ipaddress%% Logins: %%meta.login_count%% [/memb_member_listing]
Display a list of 20 users who have the tag ID “101”, along with their First name, Phone number and Custom field, for example:
[memb_member_listing tag_id=101 count=20] [memb_gravatar email="%%contact.email%%"] Name: %%contact.firstname%% Phone: %%contact.phone1%% CustomField: %%contact._customfield%% Logins: %%meta.login_count%% [/memb_member_listing]
Display a list of users with different roles like subscriber and group leader:
[memb_member_listing roles="subscriber,group_leader" count=20] Name: %%contact.firstname%% Phone: %%contact.phone1%% [/memb_member_listing]
Sort the order of the listing by ascending order, based on First name.
[memb_member_listing tag_id=123 order=asc order_by=first_name] Name: %%contact.firstname%% %%contact.lastname%% Logins: %%meta.login_count%% Email: %%contact.email%% [/memb_member_listing]
Show the date from the custom field with date formatting.
[memb_member_listing tag_id=123] Name: %%contact.firstname%% %%contact.lastname%% Date: [memb_contact fields=_CurrentDate date_format="m-d-Y" contact_id=%%contact.id%%] [/memb_member_listing]
Important note on using roles parameter
You’d need to use the actual role name in the “roles” parameter and not the human-friendly name. For example, memberium_manager_level instead of “Memberium manager level”.
Full Example with CSS:
/* Create three equal columns that floats next to each other */
.memberium_column {
float: left;
width: 32%;
padding: 10px;
margin-right: 0.9%;
}
/* Clear floats after the columns */
.memberium_row:after {
content: "";
display: table;
clear: both;
}
.memberium_card {
box-shadow: 0 4px 8px 0 rgba(0,0,0,0.2);
transition: 0.3s;
}
.memberium_card:hover {
box-shadow: 0 8px 16px 0 rgba(0,0,0,0.2);
}
.memberium_container {
padding: 2px 16px;
}
<div class="memberium_row">[memb_member_listing] <div class="memberium_card memberium_column">[memb_gravatar size=128 email="%%contact.email%%"] <div class="memberium_container"> <h4><b>%%contact.firstname%% %%contact.lastname%%</b></h4> <p>Email: %%contact.email%%</p> </div> </div> [/memb_member_listing] </div>
Shortcode Parameters
id: Contact ID of the user.
tag_id: Tag ID for which you want to display users.
roles: Role of the user for which you want to display users.
count: Number of users to show in the list. It will show 10 users by default.
offset: Number of users to offset from the list.
order: Sort the order of the listing by ASC or DESC
order_by: Define the sorting order field name (Default is Display Name). Since WordPress stores the data as text and not as numeric values, sorting won’t actually work correctly for numbers.
Merge Fields
The following merge fields or placeholders are used by [memb_member_listing]
%%contact.email%% – Displays the email address of the contact.
%%contact.firstname%% – Displays the First name of the contact.
%%contact.lastname%% – Displays the Last name of the contact.
%%contact.phone1%% – Displays the Phone number of the contact.
%%meta.ipaddress%% – Displays IP address of the contact.
%%meta.login_count%% – Displays the login count.
%%contact.fieldname%% – Replace fieldname with the name of an Infusionsoft field.
Shortcode Attributes
[memb_member_listing]
This Applies To
