[rep_projects]

You can use our Projects Listing Shortcode to display a list of projects 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, tab.
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 to display in the project description.
   • Default: The default value is based on the selected value 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.

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 section. Use image URL as value.
4. section_background_color – Adds a background color to the section. Use valid CSS color value.
5. section_font_color – Defines the font color used on the section. Use valid CSS color value.
6. section_width – Defines the width of the section.
   • Default: default (which is a max width of 1140px).
   • Options: default, small, medium, large or full. Specify one only.
7. view_more_link – URL to view more agencies.
8. view_more_link_text – Text to display on the section view more button. This is not applicable when archive is on.
   • Default: View more.
9. classes – Adds an HTML class to the section wrapper so you can modify the specific output with custom CSS.
10. id – Adds an HTML ID to the section wrapper so you can modify the specific output with custom CSS.

FILTER

1. types – Project types.
2. search_location – Specifies a search location for filtering projects by location.
3. office_id – Specifies the office ID for filtering projects by office.
4. office_post_id – Specifies the office post ID for filtering projects by office.
5. team_member_id – Specifies the team member ID for filtering projects by team member.
6. 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’.
7. 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’.
8. featured – Set as featured.
   • Default: off.
   • Options: on or off. Other truthy value is accepted like ‘yes’, ‘no’, ‘1’, ‘0’, ‘true’, ‘false’.
9. orderby – Specifies the order in which projects are displayed.
   • Default: The default value is based on the selected value under Malcolm > Settings > Projects > General > Order By.
   • Options: date, menu_order, rand. Specify one only.
10. order – Specifies the ordering direction of projects.
    • Default: The default value is based on the selected value under Malcolm > Settings > Projects > General > Order.
    • Options: asc, desc. Specify one only.
11. categories – Set the post categories.
12. exclude_categories – An array of excluded categories.
13. tags – Set the post tags.

CONTENT

1. content_to_display – Specifies what content details to display for projects.
   • Default: The default value is based on the selected value under Malcolm > Settings > Projects > Display > Featured Details.
   • Options: address, description, price, project_attributes, status. Use commas , to separate values.
2. button_to_display – Specifies the buttons to display on each agency.
   • Default: The default value is based on the selected value under Malcolm > Settings > Projects > Display > Featured Buttons.
   • Options: view, enquire. Use commas , to separate values.

Example Usage

[rep_projects display="grid" layout="2" content_to_display="description,price,status" button_to_display="view,enquire"view_more_link_text="View More Projects"  view_more_link="/projects" search_filter="on"]