[testimonial_element]
This is the main shortcode for displaying the testimonials section on a page.
Product
Shortcode Attributes
There are a number of shortcode attributes available which you can use to customize the output.
GENERAL LAYOUT
- listing_only – Determines whether to display only the testimonial listing.
- Default:
off. - Options:
on,off. Specify one only.
- Default:
- layout – The layout type.
- Default:
grid. - Options:
grid,carousel.
- Default:
- display – Determines the display style of testimonials.
- Default:
image-above-content. - Options:
- ORDINARY DISPLAYS:
image-above-content,image-overlay-content,content-only. Specify one only. - SPLIT DISPLAYS:
image-left-content,image-right-content. Specify 2 (Split and Split Size). Use commas to separate. - SPLIT DISPLAY SIZES (Required on Split Display):
split-25-75,split-40-60,split-50-50,split-60-40. Specify 3 (Split, Split Size, and Alternate Split). Use commas to separate. - ALTERNATE SPLIT DISPLAY (Can use only on Split-50-50 and on the opposite option of the Split Display):
then-left,then-right.
- ORDINARY DISPLAYS:
- Default:
- per_row – Number of testimonials to display per row.
- Default:
3. - Options:
1–6. Specify one only.
- Default:
- per_page – Number of testimonials to display per page.
- Options: Any numeric value. Specify one only.
- pagination – Pagination type.
- Default:
loadmore. - Options:
loadmore,pagination. Specify one only.
- Default:
- search_filter – Enable or disable search filter.
- Options:
on,off. Specify one only.
- Options:
GRID LAYOUT
- grid_layout – The grid layout style.
- Default:
default-grid-layout. - Options:
default-grid-layout,grid-layout-1,grid-layout-2,grid-layout-3,masonry-layout-1. Specify one only.
- Default:
CAROUSEL LAYOUT
- carousel_layout – The carousel layout style.
- Default:
default-carousel-layout.
- Default:
- autoplay – Enable or disable autoplay for the carousel.
- Default:
off. - Options:
on,off. Specify one only.
- Default:
- slider_speed – Autoplay speed in seconds.
- Default:
6. - Options: Any numeric value.
- Default:
- slider_arrows – Show or hide navigation arrows.
- Default:
on. - Options:
on,off. Specify one only.
- Default:
- slider_dots – Show or hide navigation dots.
- Default:
on. - Options:
on,off. Specify one only.
- Default:
DESIGN
- element_width – Width of the element.
- Default:
default-width. - Options:
default-width,small-container,medium-container,large-container,row-fluid. Specify one only.
- Default:
- alignment – Alignment of the content.
- Default:
default-alignment. - Options:
default-alignment,text-left,text-center,text-right,text-justified. Specify one only.
- Default:
- theme – Theme or style for the section.
- Default:
default-section. - Options:
default-section,light-section,grey-section,dark-section,theme-section,second-theme-section. Specify one only.
- Default:
- background – Background image for the element.
- Options: Any image URL.
- classes – Adds an HTML wrapper class so you can modify the specific output with custom CSS. Use spaces to separate
- id – Custom ID for the element.
HEADER
- heading – Main heading text on the testimonial section.
- Options: Any text value.
- heading_size – HTML tag for the heading.
- Default:
h2. - Options:
h1,h2. Specify one only.
- Default:
- sub_heading – Sub-heading text for the testimonial section.
- Options: Any text value.
CONTENT
- meta – Specifies the metadata to display for each testimonial.
- Default:
name,location,rating,description. - Options:
name,location,rating,date,category,tag,description. Use commas,to separate values.
- Default:
- content – Specifies the metadata to display for each testimonial.
- Default:
description. - Options:
description,excerpt. Specify one only.
- Default:
- max_words – Maximum number of words to display for the testimonial content.
- Default:
20. - Options: Any numeric value.
- Default:
- link_type – Specifies the type of link for the testimonial.
- Default:
button. - Options:
button,text,none. Specify one only.
- Default:
- show_in_modal – Determines whether to show the full testimonial in a modal.
- Default:
off. - Options:
on,off. Specify one only.
- Default:
- limit – Limits the number of testimonials to display
- Options: Any numeric value.
- orderby – Specifies the order by criteria.
- Default:
date. - Options:
id,date,title,menu_order,rand. Specify one only.
- Default:
- order – Specifies the order direction.
- Default:
desc. - Options:
asc,desc. Specify one only.
- Default:
FILTER
- featured – Filters testimonials to display only featured ones.
- Default:
no. - Options:
no,yes. Specify one only.
- Default:
- categories – Filter testimonials by categories. Comma-separated list of category IDs or slugs.
- tags – Filter testimonials by tags. Comma-separated list of tag IDs or slugs.
- testimonials – Filters testimonials by specific testimonial IDs. Comma-separated list of post IDs.
Example Usage
[testimonial_element per_row="3" heading="Customer Testimonials" sub_heading="What our clients say about us"]
[testimonial_element layout="carousel" autoplay="on" slider_speed="5" featured="yes heading="Featured Testimonials"]
| Example 1: This example displays the testimonials in a grid layout with 3 posts per row, a heading titled “Customer Testimonials”, and a sub-heading “What our clients say about us”. Example 2: This example displays a dynamic, auto-playing carousel that showcases featured testimonials. The carousel transitions every 5 seconds, and the section is titled “Featured Testimonials”. |
testimonials post type and related functionality are enabled in your theme.