Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Hi, I'm your testimonials management plugin for WordPress. Show off what your customers or website users are saying about your business and how great they say you are, using our shortcode, widget or template tag.
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


=== Testimonials by WooThemes ===
Contributors: woothemes, mattyza, jameskoster
Donate link:
Tags: testimonials, widget, shortcode, template-tag, feedback, customers
Requires at least: 3.4.2
Tested up to: 3.5-beta3
Stable tag: 1.2.0
License: GPLv2 or later
License URI:

Show off what your customers are saying about your business and how great they say you are, using our shortcode, widget or template tag.

== Description ==

"Testimonials by WooThemes" is a clean and easy-to-use testimonials management system for WordPress. Load in what your customers are saying about your business, and display the testimonials via a shortcode, widget or template tag on your website.

Looking for a helping hand? [View plugin documentation](

Looking to contribute code to this plugin? [Fork the repository over at GitHub](
(submit pull requests to the "develop" branch)

== Usage ==

To display your testimonials via a theme or a custom plugin, please use the following code:

`<?php do_action( 'woothemes_testimonials' ); ?>`

To add arguments to this, please use any of the following arguments, using the syntax provided below:

* 'limit' => 5 (the maximum number of items to display)
* 'orderby' => 'menu_order' (how to order the items - accepts all default WordPress ordering options)
* 'order' => 'DESC' (the order direction)
* 'id' => 0 (display a specific item)
* 'display_author' => true (whether or not to display the author information)
* 'display_avatar' => true (whether or not to display the author avatar)
* 'display_url' => true (whether or not to display the URL information)
* 'echo' => true (whether to display or return the data - useful with the template tag)
* 'size' => 50 (the pixel dimensions of the image)
* 'title' => '' (an optional title)
* 'before' => '&lt;div class="widget widget_woothemes_testimonials"&gt;' (the starting HTML, wrapping the testimonials)
* 'after' => '&lt;/div&gt;' (the ending HTML, wrapping the testimonials)
* 'before_title' => '&lt;h2&gt;' (the starting HTML, wrapping the title)
* 'after_title' => '&lt;/h2&gt;' (the ending HTML, wrapping the title)

The various options for the "orderby" parameter are:

* 'none'
* 'ID'
* 'title'
* 'date'
* 'menu_order'

`<?php do_action( 'woothemes_testimonials', array( 'limit' => 10, 'display_author' => false ) ); ?>`

The same arguments apply to the shortcode which is `[woothemes_testimonials]` and the template tag, which is `<?php woothemes_testimonials(); ?>`.

== Usage Examples ==

Adjusting the limit and image dimension, using the arguments in the three possible methods:

do_action() call:

`<?php do_action( 'woothemes_testimonials', array( 'limit' => 10, 'size' => 100 ) ); ?>`

woothemes_testimonials() template tag:

`<?php woothemes_testimonials( array( 'limit' => 10, 'size' => 100 ) ); ?>`

[woothemes_testimonials] shortcode:

`[woothemes_testimonials limit="10" size="100"]`

== Installation ==

Installing "Testimonials by WooThemes" can be done either by searching for "Testimonials by WooThemes" via the "Plugins > Add New" screen in your WordPress dashboard, or by using the following steps:

1. Download the plugin via
1. Upload the ZIP file through the "Plugins > Add New > Upload" screen in your WordPress dashboard.
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Place `<?php do_action( 'woothemes_testimonials' ); ?>` in your templates, or use the provided widget or shortcode.

== Frequently Asked Questions ==

= The plugin looks unstyled when I activate it. Why is this? =

"Testimonials by WooThemes" is a lean plugin that aims to keep it's purpose as clean and clear as possible. Thus, we don't load any preset CSS styling, to allow full control over the styling within your theme or child theme.

= How do I contribute? =

We encourage everyone to contribute their ideas, thoughts and code snippets. This can be done by forking the [repository over at GitHub](

== Screenshots ==

1. The testimonials management screen within the WordPress admin.

== Upgrade Notice ==

= 1.2.0 =
* Adds basic WPML support.
* Enhancements to the widget output.
* Adds new arguments for controlling the HTML wrapping the testimonials, as well as wrapping the title.

= 1.1.0 =
* Added avatar display options and performed routine plugin maintenance.

= 1.0.0 =
* Initial release. Woo!

== Changelog ==

= 1.2.0 =
* 2012-11-28
* Adds basic WPML support to the get_features() method.
* Moves the "title" outside of the ".testimonials" DIV tag.
* Adds "before" and "after" arguments for filtering the HTML for the container. Integrate the $before_widget and $after widget variables to use these parameters with the widget.
* Adds "before_title" and "after_title" arguments, for filtering the title's wrapping HTML. Integrate the $before_title and $after_title widget variables to use these parameters with the widget.

= 1.1.0 =
* 2012-11-08
* Added option to display or hide the avatar.
* Fixed bug where %%AVATAR%% tag was displaying if no avatar image was available for a testimonial.

= 1.0.0 =
* 2012-10-23
* Initial release. Woo!
Something went wrong with that request. Please try again.