Getting Started With Easy Testimonials Pro – Usage Instructions

Help & Instructions

This page includes all kinds of helpful tips for getting you up and running.

Contents:

  1. Adding a New Testimonial
  2. Editing a Testimonial
  3. Selecting Testimonial Theme via Shortcode
  4. Outputting Random Testimonials
  5. Output a Random Testimonial in the Sidebar
  6. Output a List of Testimonials
  7. Outputting a Testimonial Slider
  8. Outputting a Testimonial Slider in the Sidebar
  9. Front End Testimonial Submission
  10. Testimonial Filters
  11. Outputting a Count of your Testimonials
  12. Options

Adding a New Testimonial

Adding a New Testimonial is easy! There are 3 ways to start adding a new testimonial

How to Add a New Testimonial

  1. Click on “+ New” -> Testimonial, from the Admin Bar or
  2. Click on “Add New Testimonial” from the Menu Bar in the WordPress Admin or
  3. Click on “Add New Testimonial” from the top of the list of Testimonials, if you’re viewing them all.

New Testimonial Content

You have a few things to pay attention to:

  • Testimonial Title: this content can be displayed above your Testimonial.
  • Testimonial Body: this is the content of your Testimonial. This will be output and displayed about the Testimonial Information fields.
  • Client Name: This field is displayed first, below the Testimonial Body. The field title is just an example use – of course you don’t have to put the client name here.
  • Position / Location / Other: This field is displayed second, below the Client Name. The field title is just an example use – you can put whatever you want here.
  • Location / Product Reviewed / Other:This field is optional and is displayed third, below Position / Location / Other. The field title is just an example of how it can be used – typically this item is used for the Item the Testimonial is being left about and will match the itemReviewed Schema.
  • Rating: This field is displayed in different locations, depending on your theme, and represents the out of 5 rating for the item reviewed. If you are collecting ratings with your Testimonials, place them in this field.
  • Featured Image: This image is shown to the left of the testimonial, as a 50px by 50px thumbnail by default.
  • Testimonial Category: This field is useful for grouping and organizing your Testimonials. This can be useful if you want to display Testimonials about a certain topic as a group.

Back To Top

Editing a Testimonial

This is as easy as adding a New Testimonial!

  1. Click on “Testimonials” in the Admin Menu.
  2. Hover over the Testimonial you want to Edit and click “Edit”.
  3. Change the fields to the desired content and click “Update”.

Back To Top

Deleting a Testimonial

This is as easy as adding a New Testimonial!

  1. Click on “Testimonials” in the Admin Menu.
  2. Hover over the Testimonial you want to Delete and click “Delete”.

You can also change the Status of a Testimonial, if you want to keep it on file.

Back To Top

Controlling Testimonial Theme via Shortcode

  • To select a theme via the Shortcode, use the following shortcode syntax:
    // Output a list of 10 testimonials with the Card Style - Maroon theme
    [testimonials theme='card_style-maroon' count='10']
  • To get the full list of Themes available to your version of Easy Testimonials, we recommend using the Shortcode Generator.

Back To Top

Outputting Random Testimonials

Below are many examples, but feel free to mix and match the shortcode attributes as you like.

  • To output a Random Testimonial, place the following shortcode in the desired area of the Page or Post Content:
    // Output a single, randomly selected testimonial
    [random_testimonial]
  • To display more than one Random Testimonial, use the following shortcode, where count is the number of testimonials you want displayed.
    // Output 3 randomly selected testimonials
    [random_testimonial count='3']
    
    // Output 10 randomly selected testimonials
    [random_testimonial count='10']
    
    // Output 20 randomly selected testimonials
    [random_testimonial count='20']
  • To display the title above the Random Testimonial and use excerpts (short versions of the Testimonial), use the following shortcode:
    // Output a single testimonial, show its title, and use an excerpt for the content
    [random_testimonial show_title='1' use_excerpt='1']
    
    // Output up to 5 testimonials, show its title, and use an excerpt for the content
    [random_testimonial show_title='1' use_excerpt='1' count='5']
    
    // Output up to 10 testimonials, using the Card Style - Maroon theme, show the titles, and use excerpts
    [random_testimonial show_title='1' use_excerpt='1' count='10']
  • To limit your random testimonials to a specific category, use the category attribute:

    // Show a single random testimonial from a specfic category
    [random_testimonial category='the_category_slug']
    
    // Show a single random testimonial from a specfic category and show thumbnails
    [random_testimonial category='the_category_slug' show_thumbs='1']
    
    // Show 10 random testimonials from a specfic category and show thumbnails
    [random_testimonial category='the_category_slug' show_thumbs='1' count='10']
    
    // Show 10 random testimonials from a specfic category and show thumbnails using the Card Style - Maroon theme
    [random_testimonial category='the_category_slug' show_thumbs='1' count='10' theme="card_style-maroon"]
    
    // Show 10 random testimonials from a specfic category, show thumbnails and titles, and use the Card Style - Maroon theme
    [random_testimonial category='the_category_slug' show_thumbs='1' show_titles='1' count='10' theme="card_style-maroon"]
  • To display the rating along with the random testimonial, use the following shortcode:
    // Show the rating as stars, outside the content
    [random_testimonials show_rating='stars']
    
    // Show the rating as a number, before the content
    [random_testimonials show_rating='before']
    
    // Show the rating as a number, after the content
    [random_testimonials show_rating='after']

Back To Top

Output a Random Testimonial in the Sidebar

  • To output a Random Testimonial in the Sidebar, use the Widgets section of your WordPress Theme, accessible via the Appearance Menu in the WordPress Admin.
  • You can show more than one random testimonial by placing a number in the Count field.
  • You can choose a Category to pick the testimonial from, with the Category drop-down.
  • You can show the Date of the Testimonial by checking Show Testimonial Date.
  • You can show the Rating of the Testimonial by picking an option from the Show Rating drop-down.
  • You can show the Testimonial Title above the Testimonial by checking Show Testimonial Title. Note: The Title Field on the Widget is displayed above the Widget, if your theme supports Widget Titles – this is different than the Testimonial Title.

Back To Top

Output a List of Testimonials

  • To output a list of all the Testimonials, place the following shortcode in the desired area of the Page or Post Content:
    // output a list of testimonials
    [testimonials]
  • To output a list of the 5 most recent Testimonials, use the following shortcode:
    // output your 5 most recent testimonials
    [testimonials count='5' order='DESC' orderby='date']
  • More examples using the order and orderby attributes:
    // output your 5 most recent testimonials
    [testimonials count='5' order='DESC' orderby='date']
    
    // output your 5 oldest testimonials
    [testimonials count='5' order='ASC' orderby='date']
    
    // output 10 testimonials ordered by their post IDs
    [testimonials count='10' order='ASC' orderby='ID']
    
    // output 10 testimonials ordered by their parent post's IDs
    [testimonials count='10' order='ASC' orderby='parent']
    
    // output 10 testimonials ordered by their title
    [testimonials count='10' order='ASC' orderby='title']
    
    // output 10 testimonials ordered by the post slugs
    [testimonials count='10' order='ASC' orderby='name']
    
    // output 10 testimonials ordered by their author's name (WordPress users)
    [testimonials count='10' order='ASC' orderby='author']
    
    // output 10 testimonials in a random order
    [testimonials count='10' order='ASC' orderby='rand']

    Acceptable attributes for 'order' are 'ASC' and 'DESC'.

    Acceptable attributes for 'orderby' are 'none','ID','author','title','name','date','modified','parent', and 'rand'

  • To display the title above the list of Testimonials and use excerpts (short versions of the Testimonial), use the following shortcode:
    // Output a list of 10 testimonials showing their titles and using excerpts
    [testimonials count='10' show_title='1' use_excerpt='1']
  • To output Testimonials from a specific Category, with images, use the following shortcode:
    // Output 10 testimonials from a specific category, and show the thumbnails next to each one
    // be sure to replace the_category_slug with your own Testimonial Category's slug
    [testimonials count='10' category='the_category_slug' show_thumbs='1']
  • To display the rating along with the testimonials, use the following shortcode:
    // Show the rating as stars, outside the content
    [testimonials show_rating='stars']
    
    // Show the rating as a number, before the content
    [testimonials show_rating='before']
    
    // Show the rating as a number, after the content
    [testimonials show_rating='after']

  • To paginate the list of Testimonials, use the paginate and testimonials_per_page attributes.

    // Show your testimonials in groups of 5 per page
    [testimonials paginate='1' testimonials_per_page='5']
    
    // Show your testimonials in groups of 10 per page
    [testimonials paginate='1' testimonials_per_page='10']
    
    // Show testimonials from a specific category in groups of 5 per page
    // (Be sure to replace the_category_slug with your own Testimonial Category's slug)
    [testimonials paginate='1' testimonials_per_page='5' slug='the_category_slug']
    
    // Show your testimonials in groups of 10 per page, show the titles, and show thumbnails
    [testimonials paginate='1' testimonials_per_page='10' show_title='1' show_thumb='1']

Back To Top

Outputting a Testimonial Slider

  • NOTE: You can view live examples here.
  • Easy Testimonials Supports Cycle2! To output a sliding widget, use the following shortcode:
    // Output a slideshow of testimonials
    [testimonials_cycle]
  • The same properties used by the list of testimonials shortcode, such as show_the_title and count, can also be used with the testimonials_cycle shortcode.

    Below are several examples:

    // Output a slideshow of testimonials from one category, show an excerpt, and show thumbnails
    // (Be sure to replace the_category_slug with your own Testimonial Category's slug)
    [testimonials_cycle category='the_category_slug' use_excerpt='1' show_thumbs='1']
    
    // Output a slideshow of testimonials from one category, and limit to 20 testimonials total
    [testimonials_cycle count='20' category='the_category_slug']
    
    // Output a slideshow of your 10 most recent testimonials
    [testimonials_cycle order='ASC' orderby='date' count='10']
    
    // Output a slideshow of your 10 most recent testimonials showing titles and thumbnails
    [testimonials_cycle order='ASC' orderby='date' count='10' show_title='1' show_thumbnail='1']
    
    // Output a slideshow of 10 testimonials showing titles and using excerpts
    [testimonials_cycle count='10' show_title='1' show_thumbs='1' use_excerpt='1']
  • To show a randomly ordered Testimonial Cycle, use the following shortcode:
    // Display a testimonial slideshow, ordered randomly
    [testimonials_cycle random='true']
  • To control the slideshow’s timing, use the timer and transition attributes:
    // Output a slideshow that changes every 8 seconds and uses the horizonal scroll transition
    // and uses the Card Style - Maroon theme
    [testimonials_cycle timer='8000' transition='scrollHorz' theme='card_style-maroon']
    
    // Output a slideshow that changes every 8 seconds and uses the vertical flip transition,
    // and uses the Card Style - Maroon theme
    [testimonials_cycle timer='8000' transition='scrollVert' theme='card_style-maroon']
    
    // Output a slideshow that changes every 10 seconds and uses the horizonal flip transition,
    // and uses the Card Style - Maroon theme
    [testimonials_cycle timer='10000' transition='flipHorz' theme='card_style-maroon']
    
    // Output a slideshow that changes every 10 seconds and uses the vertical flip transition,
    // and uses the Card Style - Maroon theme
    [testimonials_cycle timer='10000' transition='flipVert' theme='card_style-maroon']
    
    // Output a slideshow that changes every 10 seconds and uses the tile slide transition,
    // and uses the Card Style - Maroon theme
    [testimonials_cycle timer='10000' transition='tileSlide' theme='card_style-maroon']
    
    // Output a slideshow that changes every 12 seconds and is displayed as a carousel,
    // and uses the Card Style - Maroon theme
    [testimonials_cycle timer='12000' transition='carousel' theme='card_style-maroon']

    To pick from our full list of available transitions, we recommend using the Shortcode Generator.

  • To show a sliding Testimonial Cycle, using the 5 most recent Testimonials ordered chronologically, use the following shortcode:
    // output your 5 most recent testimonials in a slideshow
    [testimonials_cycle count='5' order='DESC' orderby='date']

    Acceptable attributes for 'order' are 'ASC' and 'DESC'.

    Acceptable attributes for 'orderby' are 'none','ID','author','title','name','date','modified','parent', and 'rand'

  • To show a Testimonial Cycle that automatically changes height to match the Testimonial body, use the following shortcode:
    // output a testimonial slideshow that automatically changes 
    // its height to match the Testimonial body
    [testimonials_cycle container='1']
  • To control the number of testimonials per slide and toggle pager icons below the Slider, use the testimonials_per_slide and pager attributes:
    // show a single testimonial per slide, with a pager
    [testimoanials_cycle pager='1' testimonials_per_slide='1']
    
    // show a single testimonial per slide, without a pager
    [testimoanials_cycle pager='0' testimonials_per_slide='1']
    
    // show 3 testimonials per slide, with a pager
    [testimoanials_cycle pager='1' testimonials_per_slide='3']
    
    // show 3 testimonials per slide, without a pager
    [testimoanials_cycle pager='0' testimonials_per_slide='3']
    
    // show 3 testimonials per slide, with a pager, using the Card Style - Maroon theme
    [testimoanials_cycle pager='1' testimonials_per_slide='3' theme="card_style-maroon"]
    

Back To Top

Outputting a Testimonial Slider in the Sidebar

  • To output a Testimonial Cycle in the Sidebar, use the Widgets section of your WordPress Theme, accessible via the Appearance Menu in the WordPress Admin.
  • You can control how many testimonials are shown by placing a number in the Count field – make sure you have at least 2, if you want them to Cycle!
  • You can show the Date of the Testimonial by checking Show Testimonial Date.
  • You can control the number of Testimonials Per Slide by using the Testimonials Per Slide input.
  • You can show clickable pager icons below the Testimonial slideshow by checking Show Pager Icons.
  • You can Randomize the order of the Slideshow by checking Random Testimonial Order.
  • You can limit the length of the Testimonial to just the Excerpt by checking Use Testimonial Excerpt.
  • You can show the Testimonial Title above the Testimonial by checking Show Testimonial Title. Note: The Title Field on the Widget is displayed above the Widget, if your theme supports Widget Titles – this is different than the Testimonial Title.
  • You can control the time between transitions using the Timer field – every 1000 equals 1 second.
  • You can choose a Category to pick the testimonial from, with the Category drop-down.
  • You can show the Rating of the Testimonial by picking an option from the Show Rating drop-down.

Back To Top

Front End Testimonial Submission

  • NOTE: This feature requires the Pro version of Easy Testimonials.
  • To display the Testimonial Submission Form, use the following shortcode:

    // Show a Submit Your Testimonial form
    [submit_testimonial]
  • Any submissions will be added to your Testimonials list, on the back end, as pending Testimonials. Only Testimonials that you choose to publish will be displayed publicly.
  • Captcha support is enabled with the installation of the Really Simple Captcha plugin, or with Google’s ReCaptcha.
  • Front End Image Submission is enabled via a checkbox on the Submission Form Options tab.
  • Labels, descriptions, and visibility of fields can be controlled via the Submission Form Options screen.

Back To Top

Using Filters to Customize Output

We provide the following filters to developers for customizing output even further:

  • easy_t_random_testimonials_html — random testimonials filter

  • easy_t_single_testimonial_html — single testimonial filter

  • easy_t_testimonials_html — all testimonials list filter

  • easy_t_testimonials_cyle_html — testimonials cycle filter

  • easy_t_submission_form — testimonial submission form

Back To Top

Outputting a Count of your Testimonials

  • To display a numerical Count of your Testimonials, use the following shortcode where you want the Number to appear:
    [testimonials_count]
  • To display an aggregate rating of your testimonials (for Google’s crawler), use the show_aggregate_rating attribute:
    // Output a count of your testimonials along with their aggregate rating
    [testimonials_count show_aggregate_rating='1']
  • To display a numerical Count of your Testimonials from a specific category and/or with a specific status, use the status and category attributes:
    // display a count of your testimonials in a specific category on the front-end
    // (Be sure to replace the_category_slug with your own Testimonial Category's slug)
    [testimonials_count status='any' category='the_category_slug']
    
    // display a count of your Approved testimonials in a specific category on the front-end
    // (Be sure to replace the_category_slug with your own Testimonial Category's slug)
    [testimonials_count status='publish' category='the_category_slug']
    
    // display a count of your Pending testimonials in a specific category on the front-end
    // (Be sure to replace the_category_slug with your own Testimonial Category's slug)
    [testimonials_count status='pending' category='the_category_slug']
    
    // display a count of your Trashed testimonials in a specific category on the front-end
    // (Be sure to replace the_category_slug with your own Testimonial Category's slug)
    [testimonials_count status='trash' category='the_category_slug']

    Supported parameters for status are publish,pending,draft,future,private,trash,any.

  • Note: this Shortcode only displays the numerical count — you will need to add any words yourself. For example, “There are currently [testimonials_count] Testimonials on your website!”

Back To Top

Options

  • To control the destination of the “View More” link, set the path in the Testimonials View More Link field.
  • To display any Featured Images that you have attached to your Testimonials, check the box next to Show Testimonial Image.
  • To display any Testimonial Information above the content, check the box next to Show Testimonial Info Above Testimonial.
  • To add any Custom CSS, to further modify the output of the plugin, input the CSS in the textarea labeled Custom CSS. You do not need to include the opening or closing <style> tags, treat it like you’re inside a CSS file.
  • To pick a global theme, use our Themes tab to browse the available choices.
  • To control the display of the Testimonial Submission Form, use the Submission Form Options tab.
  • To customize the appearance of your Testimonials, use the Display Options tab.

Back To Top