Customize Your Membership Directory

Full Control

Introducing Meta Mixer WP, the perfect tool for creating dynamic, customizable directories. Ideal for WooCommerce Memberships users, it simplifies directory creation with easy membership level selection and user role filtering. Its intuitive interface lets you link directly to profile pages, enhancing connectivity within your directory.

  • Select and customize directory searches by membership levels and user roles

  • Utilize CSS to fully control and personalize the appearance

  • Manage search settings for quick access by usernames, emails, or company names.

Meta Mixer WP simplifies directory creation, offering flexibility and design freedom. Elevate your user experience with a directory that's both functional and engaging.

Default Shortcode Example

[membership_directory
per_page="6"
roles="customer,administrator"
profile_page_id="27"
show_debug="true"
membership_status="all"
elements="
image:user_avatar:profile_image:visible,
 name:mm_display_name:profile_link:visible,
 company:mm_display_company:search_link:visible::Company Name,
 website:mm_website:icon_link:visible:fa-solid fa-link|Visit Website,
 phone:mm_phone:icon_link:visible:fa-solid fa-phone|Call,
 facebook:mm_social_1:icon_link:visible:fa-brands fa-facebook|Facebook,
 twitter:mm_social_2:icon_link:visible:fa-brands fa-twitter|Twitter,
 linkedin:mm_social_3:icon_link:visible:fa-brands fa-linkedin|LinkedIn,
 profileButton:mm_display_name:profile_button:visible::View My Profile
"
search_columns="mm_display_name,mm_display_company"
wc_membership_plans="18,251"
wc_membership_status="active"]

Understanding the Shortcode Attributes

Accent heading

The membership_directory shortcode is a versatile tool designed to display a dynamic and customizable directory of members on your WordPress site. It offers features such as pagination, role filtering, membership status filtering, and customizable display elements, allowing you to tailor the member directory to your specific needs.

Attributes and Their Roles

per_page: Specifies the number of member profiles displayed per page.

roles: Filters members by their user roles (e.g., customer, administrator).

profile_page_id: The ID of the page designated for individual user profiles.

show_debug: When set to true, enables debug mode for troubleshooting.

membership_status: Filters members based on their membership status (e.g., all, active).

wc_membership_plans: Comma-separated IDs of WooCommerce membership plans to include.

wc_membership_status: Filters members by their WooCommerce membership status (e.g., active).

search_columns: Specifies which user metadata fields are searchable.

elements: Defines the components to display for each member, formatted as a comma-separated list. Each element follows the structure:

Elements Options

id:meta_key:type:visible:additional:label

  • id: Unique identifier for the element.
  • meta_key: Metadata key used to retrieve the value.
  • type: Type of the element (e.g., image, text, profile_link, profile_button).
  • visible: Determines if the element is visible (visible or hidden).
  • additional: Optional additional data, such as FontAwesome icons.
  • label: Optional label for the element.

Supported Element Types

    image

    Displays an image sourced from the specified meta_key.

    image:user_avatar:image:visible::Profile Picture

    profile_image

    Similar to image, but wraps the image in a link to the user’s profile page.

    image:user_avatar:profile_image:visible::Profile Picture

    text

    Displays plain text retrieved from the specified meta_key.

    name:mm_display_name:text:visible::Name

    profile_link

    Displays text as a hyperlink to the user’s profile page.

    name:mm_display_name:profile_link:visible::Name

    profile_button

    Renders a button that links to the user’s profile page.

    profileButton:mm_display_name:profile_button:visible::View Profile

    search_link

    Creates a link that performs a search query based on the element’s value.

    company:mm_display_company:search_link:visible::Company Name

    icon_link

    Displays a link accompanied by an icon, useful for social media or contact links.

    website:mm_website:icon_link:visible:fa-solid fa-link|Visit Website

In the elements attribute of the membership_directory shortcode, the additional parameter provides extra customization options for certain element types, enhancing their functionality and appearance. This parameter is particularly useful for elements like icon_link, where you might want to include specific icons or additional styling.

Understanding the additional Parameter:

The additional parameter is an optional field within the element’s definition. It allows you to specify supplementary information that can modify how the element is rendered. The content of this parameter varies depending on the type of the element.

Usage in Different Element Types:

icon_link:

  • Purpose: To display a hyperlink accompanied by an icon, commonly used for social media or contact links.
  • Additional Content: For icon_link elements, the additional parameter typically includes FontAwesome icon classes and optional link text, separated by a pipe (|) character.
  • Format: icon_class|link_text

Example:

website:mm_website:icon_link:visible:fa-solid fa-link|Visit Website

Explanation:

  • a-solid fa-link: Specifies the FontAwesome icon classes for a solid link icon.
  • Visit Website: Sets the text to be displayed for the link.
  • Rendered Output: A link labeled “Visit Website” accompanied by a link icon.


Other Element Types:
For element types such as text, profile_link, or profile_button, the additional parameter is generally not utilized. Including it in these elements will have no effect on their rendering.

Key Points to Remember:

  • Optional Parameter: The additional parameter is optional and should be used only when the element type supports or requires extra information.
  • Customization: Utilizing the additional parameter allows for enhanced customization, enabling you to tailor the appearance and functionality of elements to better fit your site’s design and user experience.
  • Consistency: Ensure that the content of the additional parameter aligns with the expected format for the specific element type to avoid rendering issues.

A basic directory with Advanced Features

The directory is built to be user and developer friendly. Advanced Filtering Options and Full CSS control over card elements make this a must have tool.

Go Pro With Bricks

    Integrate with your favourite Membership Plugins

    Ready to go for working with WooCommerce Memberships. Show only the membership plans and status you want.

    Choose Your Profile Template

    Use the profile building elements to create a custom templated profile page for users. Link different directories to different rofile templates.

    Advanced Search Control

    Only allow searching for users based on chosen meta fields

    Role Based Filters

    Only allow Roles you choose to be displayed on the front end directory.