WordPress.org

Ready to get started?Download WordPress

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.
  • Featured Image: This image is shown to the left of the testimonial, as a 50px by 50px thumbnail.

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 theme='theme_name' attribute in any of our shortcodes.
  • Valid theme options in the Free version are: 'dark_style','light_style','clean_style','no_style','default_style'.
  • Valid theme options in the Pro version are: 'bubble_style','bubble_style-brown','bubble_style-pink','bubble_style-blue-orange','bubble_style-red-grey','bubble_style-purple-green','avatar-left-style','avatar-left-style-blue-orange','avatar-left-style-pink','avatar-left-style-brown','avatar-left-style-red-grey','avatar-left-style-purple-green','avatar-left-style-50x50','avatar-left-style-50x50-blue-orange','avatar-left-style-50x50-brown','avatar-left-style-50x50-pink','avatar-left-style-50x50-purple-green','avatar-left-style-50x50-red-grey','avatar-right-style','avatar-right-style-blue-orange','avatar-right-style-pink','avatar-right-style-brown','avatar-right-style-red-grey','avatar-right-style-purple-green','avatar-right-style-50x50','avatar-right-style-50x50-blue-orange','avatar-right-style-50x50-brown','avatar-right-style-50x50-pink','avatar-right-style-50x50-purple-green','avatar-right-style-50x50-red-grey','card_style','card_style-salmon','card_style-orange','card_style-purple','card_style-slate','elegant_style-sky_blue','elegant_style-graphite','elegant_style-green_hills','elegant_style-salmon','elegant_style-smoke','notepad_style-stone','notepad_style-sea_blue','notepad_style-forest_green','notepad_style-red_rock','notepad_style-purple_gems','business_style-stone','business_style-blue','business_style-green','business_style-red','business_style-grey','modern_style-concept','modern_style-money','modern_style-digitalism','modern_style-power','modern_style-sleek',
  • If no Theme is passed via the Shortcode, the Theme set on the Settings page will be used.

Outputting Random Testimonials

  • To output a Random Testimonial, place the shortcode [random_testimonial] in the desired area of the Page or Post Content. To display more than one random testimonial, use the shortcode [random_testimonial count='3'], where count is the number of testimonials you want displayed.
  • To display the title above the testimonial, use the shortcode [random_testimonial show_title="1"]. To use the Excerpt of a testimonial, add the attribute use_excerpt=1 to your shortcode. To output Testimonials in a specific Category, use the attribute category='the_category_slug'. To show or hide the images next to Testimonials, use the attribute show_thumbs=0 for hiding the images, and show_thumbs=1 for displaying the images.
  • To control the Order of the Testimonials with the Shortcode, use the attribute order='ASC'. To control the Order By parameter, use the attribute orderby='title'. 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 rating along with the testimonial, use the attribute show_rating. Possible values 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, for the rating to appear as stars with the Testimonial meta data.
  • To display the publication date of the testimonial, use the attribute show_date. Possible values are show_date=1.

Output a List of Testimonials

  • To output a list of All Testimonials, place the shortcode [testimonials] in the desired area of the Page or Post Content. To display more than one testimonial, use the shortcode [testimonials count='3'], where count is the number of testimonials you want displayed. To display the title above the testimonial, use the shortcode [testimonials show_title="1"]. To use the Excerpt of a testimonial, add the attribute use_excerpt=1 to your shortcode. To output Testimonials in a specific Category, use the attribute category='the_category_slug'. To show or hide the images next to Testimonials, use the attribute show_thumbs=0 for hiding the images, and show_thumbs=1 for displaying the images.
  • To control the Order of the Testimonials with the Shortcode, use the attribute order='ASC'. To control the Order By parameter, use the attribute orderby='title'. 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 rating along with the testimonial, use the attribute show_rating. Possible values 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, for the rating to appear as stars with the Testimonial meta data.
  • To paginate the list of Testimonials, use the attribute paginate='1'. When paginated, to control the number of Testimonials shown per page use the attribute testimonials_per_page='5' (where 5 is the number of Testimonials displayed.)
  • To display the publication date of the testimonial, use the attribute show_date. Possible values are show_date=1.

Output a Testimonial in the Sidebar

  • To output a Testimonial in the Sidebar, use the Widgets section of your WordPress Theme, Accessible on 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 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 this shortcode: [testimonials_cycle].
  • The same properties as the list of testimonials, such as Showing the Title and controlling the Count, also apply. To use the Excerpt of a testimonial, add the attribute use_excerpt=1 to your shortcode. To output Testimonials in a specific Category, use the attribute category='the_category_slug'. To show or hide the images next to Testimonials, use the attribute show_thumbs=0 for hiding the images, and show_thumbs=1 for displaying the images. You can randomize the order of the testimonials with the attribute random="true".
  • To change the timer, use the attribute timer, which defaults to 2000 (2 seconds.) For example: [testimonials_cycle timer="4000"]
  • To change the transition to a fade in, fade out, or no transition, use the attributes transition="fade", or transition="fadeout", or transition="none". These features are enabled for Pro users - 'fade' is included in the Free version! For example: [testimonials_cycle transition="fadeout"]
  • Supported transitions in the Pro version are "scrollVert", "scrollHorz", "fadeIn", "fadeOut", "flipHorz", "flipVert", and "tileSlide".
  • To control the Order of the Testimonials with the Shortcode, use the attribute order='ASC'. To control the Order By parameter, use the attribute orderby='title'. 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 a pager below the slider, use the attribute pager='1'. On the Widget, check the box labeled Display Pager Icons.
  • To have the height of the slider automatically adjust to the height of it's content, set the attribute container='1'.
  • To control the number of testimonials that appear per slide, use the attribue testimonials_per_slide='1'.
  • To display the publication date of the testimonial, use the attribute show_date. Possible values are show_date=1.

Outputting a Testimonial Slider in the Sidebar

  • To output a Testimonial Cycle in the Sidebar, use the Widgets section of your WordPress Theme, Accessible on the Appearance Menu in the WordPress Admin. You can 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 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.
  • Supported transitions in the Pro version are "scrollVert", "scrollHorz", "fadeIn", "fadeOut", "flipHorz", "flipVert", and "tileSlide".

Front End Testimonial Submission

  • NOTE: This feature requires the Pro version of Easy Testimonials.
  • Add the shortcode [submit_testimonial] to the area of the page you want your form on.
  • Any submissions will be added to your Testimonials list, on the back end. 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.

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<pre><code></code></pre>easy_t_single_testimonial_html-- single testimonial filter<pre><code></code></pre>`easy_t_testimonials_html -- all testimonials list filter

easy_t_testimonials_cyle_html``` -- testimonials cycle filter<pre><code></code></pre>easy_t_submission_form``` -- testimonial submission form

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.

Requires: 3.1 or higher
Compatible up to: 4.1.1
Last Updated: 2015-3-2
Active Installs: 10,000+

Ratings

4.5 out of 5 stars

Support

13 of 24 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

1 person says 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