[rep_listing_events]

You can use our Listings Events Shortcode to display listing events 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 customize the output.

GENERAL LAYOUT

1. 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.
2. layout – Controls the layout of each agency on the result.
   • Default: The default value is based on the selected layout under Malcolm > Settings > General > General > Layout.
   • Options: From 1 to 5. Specify one only.
     • 1 – Image above content
     • 2 – Image left content
     • 3 – Image right content
     • 4 – Image overlay content
     • 5 – Content only
3. columns – Defines how many agencies are displayed per row. Use in conjunction with layout 1, 4, and 5. This attribute is ignored on layout 2 and 3.
   • Default: The default value is based on the selected layout under Malcolm > Settings > General > General > Columns.
   • Options: From 1 to 5. Specify one only.
4. 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.
5. max_posts – The maximum number of agencies to display.
   • Default: The default value is based on the selected layout under Malcolm > Settings > General > General > Max Posts.
   • Options: Integer values.
6. filter_popup – Specifies whether to display filter options in a popup.
   • Default: 0.
   • Options: 1 or 0.
7. modal_only – Specifies whether to use modal display for events.
   • Default: 0.
   • Options: 1 or 0.
8. include_labels – Specifies whether to include labels in the display.
   • Default: 1.
   • Options: 1 or 0.
9. group_by_date – Specifies whether to group events by date.

GRID LAYOUT

1. 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

1. autoplay – Enable or disable carousel autoplay.
   • Default: The default value is based on the selected layout under Malcolm > Settings > General > General > Autoplay.
   • Options: on or off. Other truthy value is accepted like ‘yes’, ‘no’, ‘1’ , ‘0’, ‘true’, ‘false’.
2. 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: on or off. Other truthy value is accepted like ‘yes’, ‘no’, ‘1’, ‘0’, ‘true’, ‘false’.

SECTION

1. header_title – Displays section title on the section header above the section body.
2. header_sub_title – Displays section sub title on the section header above the section body.
3. section_background_image – Adds a background image to the HTML wrapper for the feed. Use image URL.
4. section_font_color – Defines the font color of section header and section footer.
5. section_width – Defines the width of the feed.
   • Default: default (which is a max width of 1140px).
   • Options: default, small, medium, large or full (specify one only).
6. classes – Adds an HTML wrapper class so you can modify the specific output with custom CSS.

FILTER

1. archive – If set, the shortcode will allow filtering the results based on the user search.
   • Default: off.
   • Options: on or off. Other truthy value is accepted like ‘yes’, ‘no’, ‘1’, ‘0’, ‘true’, ‘false’.
2. search_filter – Display search filter form to search through the agencies. Setting this on will set archive attribute to on regardless of the value set on that attribute.
   • Default: off.
   • Options: on or off. Other truthy value is accepted like ‘yes’, ‘no’, ‘1’, ‘0’, ‘true’, ‘false’.
3. agency_id – Filters events by agency ID.
4. agency_lid -Filters events by agency LID.
5. agency_post_id -Filters events by agency post ID.
6. agent_id – Filters events by agent ID.
7. categories – Set the post category.
8. exclude_categories – An array of excluded categories.
9. featured – Filters events based on their “featured” status.
   • Default: off.
   • Options: on or off. Other truthy value is accepted like ‘yes’, ‘no’, ‘1’, ‘0’, ‘true’, ‘false’.
10. search_location – Filters events by location.
11. tags – Set the post tags.
12. event_type – Filters events by event type.
13. property_types – Filters events by property types.

Example Usage

[rep_listing_events agency_id="456" search_location="Melbourne" featured="yes" display="grid" search_filter="on"]
[rep_listing_events group_by_date="1"]
[rep_listing_events agency_id="123" agent_id="456"]
[rep_listing_events search_location="Melbourne" min_price="500000" max_price="1000000"]