[rep_team_members]
You can use our Team Member Listing Shortcode to display team members from your Malcolm account directly on any page or post.
Product
Shortcode Attributes
There are a number of shortcode attributes available which you can use to customise the output.
GENERAL LAYOUT
- display – Defines the display between Grid, and Carousel view.
- Default: The default value is based on the selected layout under Malcolm > Settings > General > General > Display.
- Options:
grid,carousel.
- layout – Controls the layout of each team members on the result.
- Default: The default value is based on the selected layout under Malcolm > Settings > General > General > Layout.
- Options: From
1to5. Specify one only.1– Image above content2– Image left content3– Image right content4– Image overlay content5– Content only
- columns – Defines how many team members are displayed per row. Use in conjunction with layout
1,4, and5. This attribute is ignored on layout2and3.- Default: The default value is based on the selected layout under Malcolm > Settings > General > General > Columns.
- Options: From
1to5. Specify one only.
- group_by – Defines the criteria by which team members will be grouped.
- Options:
team,office.
- Options:
- group_layout – Defines how the grouped items will be displayed.
- Default:
grid.
- Default:
- max_chars – Maximum number of characters/words to display in the description.
- Default: The default value is based on the selected layout under Malcolm > Settings > General > General > Max Characters.
- Options: Integer values. Recommended value is around 150.
- max_posts – The maximum number of team members to display.
- Default: The default value is based on the selected layout under Malcolm > Settings > General > General > Max Posts.
- Options: Integer values.
GRID LAYOUT
- posts_per_page – Toggles pagination on. Use in conjunction with max_posts.
- Default: The default value is based on the selected layout under Malcolm > Settings > General > General > Posts Per Page.
- Options: Integer values.
CAROUSEL LAYOUT
- autoplay – Enable or disable carousel autoplay.
- Default: The default value is based on the selected layout under Malcolm > Settings > General > General > Autoplay.
- Options:
onoroff. Other truthy value is accepted like ‘yes’, ‘no’, ‘1’, ‘0’, ‘true’, ‘false’.
- infinite_carousel – Enable or disable infinite carousel, allowing the carousel to slide endlessly.
- Default: The default value is based on the selected layout under Malcolm > Settings > General > General > Infinite Carousel.
- Options:
onoroff. Other truthy value is accepted like ‘yes’, ‘no’, ‘1’, ‘0’, ‘true’, ‘false’.
SECTION
- header_title – Displays section title on the section header above the section body.
- header_sub_title – Displays section sub title on the section header above the section body.
- section_background_image – Adds a background image to the HTML wrapper for the feed. Use image URL.
- section_background_color – Adds a background color to the section. Use valid CSS color value.
- section_font_color – Defines the font color of section header and section footer.
- section_width – Defines the width of the feed.
- Default:
default(which is a max width of 1140px). - Options:
default,small,medium,largeorfull(specify one only).
- Default:
- view_more_link – URL to view more agencies.
- view_more_link_text – Text to display on the section view more button. This is not applicable when
archiveison.- Default:
View more.
- Default:
- classes – Adds an HTML wrapper class so you can modify the specific output with custom CSS.
- id – Adds an HTML wrapper ID so you can modify the specific output with custom CSS.
FILTER
- archive – If set, the shortcode will allow filtering the results based on the user search.
- Default: off.
- Options:
onoroff. Other truthy value is accepted like ‘yes’, ‘no’, ‘1’, ‘0’, ‘true’, ‘false’.
- search_filter – Display the search filter form to search through the team members. Setting this on will set
archiveattribute toonregardless of the value set on that attribute.- Default: off.
- Options:
onoroff. Other truthy value is accepted like ‘yes’, ‘no’, ‘1’, ‘0’, ‘true’, ‘false’.
- show_search_count – Display the number of agents found above the search filter.
- Default: off.
- Options:
onoroff. Other truthy value is accepted like ‘yes’, ‘no’, ‘1’, ‘0’, ‘true’, ‘false’.
- office_id – Specifies the office ID for filtering team members by office.
- office_lid – Filters team members by office LID.
- office_post_id – Specifies the office post ID for filtering team members by office.
- team_id – Specifies the team ID for filtering team members by team.
- exclude_team_ids – An array of excluded team IDs.
- orderby – Specifies the order in which team members are displayed.
- Default: The default value is based on the selected value under Malcolm > Settings > Teams > General > Order By.
- Options:
date,title,category,menu_order,rand. Specify one only.
- order – Specifies the order of sorting team members.
- Default: The default value is based on the selected value under Malcolm > Settings > Teams > General > Order.
- Options:
,asc. Specify one only.desc
- group_orderby – Defines the criteria by which the groups will be sorted.
- Default:
name. - Options:
name,id, specific list of ids (the specific order of group IDs separated by commas). Specify one only.
- Default:
- group_order – Defines the sorting direction of the groups.
- Default:
asc. - Options:
asc,desc. Specify one only.
- Default:
- featured – Filters team members based on their “featured” status.
- Default: off.
- Options:
onoroff. Other truthy value is accepted like ‘yes’, ‘no’, ‘1,’ , ‘0’, ‘true’, ‘false’.
- search_location – Specifies a search location for filtering team members by their location.
- categories – Set the post categories.
- exclude_categories – An array of excluded categories.
- tags – Set the post tags.
CONTENT
- content_to_display – Specifies the content details to display for team members.
- Default: The default value is based on the selected value under Malcolm > Settings > Teams > Display > Featured Details.
- Options:
contact_details,description,rating,social_media,statistic,website. Use commas,to separate values.
- button_to_display – Specifies the buttons to display on each team member.
- Default: The default value is based on the selected value under Malcolm > Settings > Teams > Display > Featured Buttons.
- Options:
view,enquire. Use commas,to separate values.
- Options:
- Default: The default value is based on the selected value under Malcolm > Settings > Teams > Display > Featured Buttons.
Example Usage
[rep_team_members office_id="12" search_location="Canberra" featured="yes" display="grid" search_filter="on"]
| Example: This example displays a list of team members with the following parameters: – Filters team members by office ID (in this case, office ID 12); – Displays only team members located in Canberra; – Shows only team members marked as “featured”; – Sets the display layout to a grid (Grid Layout); – Enables the search filter form, allowing users to filter employees based on specified criteria. This automatically sets the archive="on" attribute. |
featured attribute.Pagination: Pagination is added automatically on
grid display if there are more results than can be displayed at once.Multi-Column or Archive Layout: The shortcode supports multi-column or archive layouts, if
archive is set to on. The layout depends on the selected value on Malcolm > Settings > Teams > Archive Page > Archive Page Layout.