WordPress.org

Plugin Directory

Easy Testimonials

Easy Testimonials is a simple-to-use plugin for adding Testimonials to your WordPress Theme, using a shortcode or a widget.

This section describes how to install the plugin and get it working.

  1. Upload the contents of /easy_testimonials/ to the /wp-content/plugins/ directory
  2. Activate Easy Testimonials through the 'Plugins' menu in WordPress
  3. Visit here for information on how to configure the plugin.

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.

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

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.

Controlling Testimonial Theme via Shortcode

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

Outputting Random Testimonials

  • To output a Random Testimonial, place the following shortcode in the desired area of the Page or Post Content: [random_testimonial]
  • To display more than one Random Testimonial, use the following shortcode, where count is the number of testimonials you want displayed. [random_testimonial count='3']
  • To display the title above the Random Testimonial and use excerpts (short versions of the Testimonial), use the following shortcode: [random_testimonial show_title='1' use_excerpt='1']
  • To output Random Testimonials from a specific Category, with images, use the following shortcode: [random_testimonial category='the_category_slug' show_thumbs='1']
  • To display the rating along with the random testimonial, use the following shortcode: [random_testimonial show_rating='stars']

    Possible values for show_rating are show_rating=before, for the rating to appear before the testimonial content, show_rating=after, for the rating to appear after the testimonial content, and show_rating=stars, to show the rating in stars format.

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: [testimonials]
  • To output a list of the 5 most recent Testimonials, use the following shortcode: [testimonials 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 display the title above the list of Testimonials and use excerpts (short versions of the Testimonial), use the following shortcode: [testimonials show_title='1' use_excerpt='1']

  • To output Testimonials from a specific Category, with images, use the following shortcode: [testimonials category='the_category_slug' show_thumbs='1']
  • To display the rating along with the testimonials, use the following shortcode: [testimonials show_rating='stars']

    Possible values for show_rating are show_rating=before, for the rating to appear before the testimonial content, show_rating=after, for the rating to appear after the testimonial content, and show_rating=stars, to show the rating in stars format.

  • To paginate the list of Testimonials, use the following shortcode: [testimonials paginate='1' testimonials_per_page='5']

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.

Outputting a Testimonial Slider

  • NOTE: You can view live examples here.
  • Easy Testimonials Supports Cycle2! To output a sliding widget, use the following shortcode: [testimonials_cycle]
  • The same properties as the list of testimonials, such as Showing the Title and controlling the Count, also apply. To output a Testimonial Cycle using excerpts, from a specific category, with images, use the following shortcode: [testimonials_cycle category='the-category-slug' use_excerpt='1' show_thumbs='1']
  • To show a randomly ordered Testimonial Cycle, use the following shortcode: [testimonials_cycle random='true']
  • To show a sliding Testimonial Cycle, with 10 seconds between each transition, use the following shortcode: [testimonials_cycle timer='10000' transition='scrollHorz']
  • To show a sliding Testimonial Cycle, with Previous and Next buttons, use the following shortcode: [testimonials_cycle prev_next='1']
  • To show a sliding Testimonial Cycle, that only transitions when Prev or Next is clicked, use the following shortcode: [testimonials_cycle paused='1' prev_next='1']

    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: [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: [testimonials_cycle auto_height='container']

  • To show a Testimonial Cycle that sets the slideshow height to the height of tallest Testimonial, use the following shortcode: [testimonials_cycle auto_height='calc']
  • To show a Testimonial Cycle with 3 Testimonials per Slide and Pager Icons below the Slider, use the following shortcode: [testimoanials_cycle pager='1' testimonials_per_slide='3']

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.

Front End Testimonial Submission

  • NOTE: This feature requires the Pro version of Easy Testimonials.
  • To display the Testimonial Submission Form, use the following shortcode: [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.
  • 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.

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

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 a numerical Count of your pending Testimonials from a specific category, use the following shortcode: [testimonials_count status='pending' category='gold-plugins']
  • Supported parameters for status are publish,pending,draft,future,private,trash,any. For example, the following shortcode will display a count of all Testimonials, excluding those in the Trash: [testimonials_count status='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!"

Ouptting a Testimonials Search Form

  • To display a form that Searches your Testimonials, use the following shortcode: [easy_t_search_testimonials]

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 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.
  • To Show Testimonials in Public Search, use the Show in Search checkbox on the Basic Settings Page.
  • To change your Registered Shortcodes, in case of conflict with theme or other plugins, use the Shortcode Options section on the Basic Settings screen.

Requires: 3.1 or higher
Compatible up to: 4.2.2
Last Updated: 2015-7-7
Active Installs: 20,000+

Ratings

4.4 out of 5 stars

Support

12 of 21 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,1,1
100,1,1
100,1,1 100,1,1 100,1,1
100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1
100,2,2 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1
50,2,1 100,1,1 100,1,1 100,1,1
100,1,1 100,1,1 100,1,1 50,2,1 100,1,1 100,1,1 100,2,2 100,1,1 100,1,1
100,2,2 100,2,2 100,1,1 100,1,1 100,1,1 50,2,1 100,1,1 100,3,3
100,1,1
100,1,1
100,1,1
100,1,1 50,2,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1
100,1,1 100,1,1 100,1,1
100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,2,2
100,1,1 100,1,1 100,1,1 100,1,1 100,1,1
100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,2,2 100,1,1 100,1,1
100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,2,2 100,1,1
100,1,1
100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,2,2 100,1,1