Skip to content

Testimonials Shortcode

Oliver Juhas edited this page Mar 14, 2018 · 4 revisions

Info

Displays list of testimonials.
You can display testimonials in a carousel.


Example

Displays 6 newest testimonials categorized under "My category" (category slug should be my-category) in 3 columns:

[wm_testimonials columns="3" count="6" category="my-category" /]

Displays 6 testimonials ordered by name in 2 columns carousel with automatic scrolling every 5 seconds:

[wm_testimonials order="name" columns="2" count="6" scroll="5000" /]

Displays a single testimonial:

[wm_testimonials testimonial="testimonial-slug-here" /]

Parameters

Please note that you can omit parameters with empty values when writing the shortcode.

Parameter Type Value example    Description
category string category-slug If you specify this parameter, only testimonials from specific category will be displayed.
class string my-class Adds a custom CSS class(es) onto shortcode wrapper.
columns predefined 1, 2, 3, 4, 5 or 6 Number of columns items are displayed in.
count integer 6 Number of items to display. From performance perspective it is not recommended to use a value of -1 to display all items, instead use 50, for example.
heading_tag predefined h2, h3, h4, h5 or h6 Sets the caption HTML heading tag for headings cascade control (for better accessibility).
no_margin boolean 0 (false) or 1 (true) Removes or minimizes the gap between the items. Your theme must provide the related styles.
order predefined custom, menuasc, menudesc, name, new, old or random Sets the order in which posts display. Default is new. The custom is synonym for menuasc. Also, it is not really recommended to use random as it slows down your website performance.
pagination boolean 0 (false) or 1 (true) Whether to display a multi-page navigation (pagination).
scroll integer 0 or 1 or 5000 Enables horizontal carousel scrolling. 0 stands for disabled, 1 enables manual carousel, 1000 and more enables automatic carousel where the value sets the carousel pause in milliseconds (so, 5000 sets the carousel pause to 5 seconds, for example). Default is 0.
testimonial string testimonial-slug If specified, a single testimonial of testimonial-slug is going to be displayed. You may also set this value to a number - a post ID. If you set this parameter, the ones related to multi-item display (such as columns or count) will be ignored.

Compatibility

Please, make sure your theme supports this shortcode, before using it.
Some themes may not be compatible with certain shortcodes as they may use different approach to displaying similar elements. In that case the shortcode is displays in its raw code format on your website front-end.