WordPress.org

Plugin Directory

Clean Testimonials

Add Testimonials to your WordPress website. Simple, easy, quick and clean.

Can testimonials be submitted by my visitors automatically?

Yes. On top of your ability to add and edit testimonials in the WordPress admin area, you can also use a shortcode to display a form on any page you like. This form will create a new testimonial when a user fills it out. The shortcode to do this is [testimonial-submission-form]

When a user submits a testimonial, it will default to "Draft" status. You will need to publish any testimonials this way before they will display on your site. Just in case someone writes anything naughty!

How do I display all of my testimonials?

To display all testimonials with pagination, use the [testimonials] shortcode.

How do I display a testimonial?

To display a single testimonial you can use the [testimonial id="xyz"] shortcode, where "xyz" is the ID of the testimonial you wish to display. You can copy and paste the testimonial shortcode complete with ID from your Testimonials admin page in WordPress.

How can I display a category of testimonials?

To display a category of testimonials (with pagination!), you can use the [testimonials category="xyz"] shortcode. where "xyz" is the ID of the testimonial category you wish to display. You can also display testimonials from multiple categories by using [testimonials category="xyz,abc"] where "xyz" is the first ID and "abc" is the second. You can pass in as many ID's as you like, just separate them with commas.

You can copy and paste this shortcode complete with ID from the Testimonials -> Categories admin page in WordPress.

Can I display a random testimonial?

Yes, you can use the Testimonial Widget and specify the "random" option, or you can use the [testimonial id="random"] shortcode.

Can I change the number of testimonials shown per page?

Yes. Specify the "per_page" attribute when using the [testimonials] shortcode. EG, [testimonials category="10" per_page="5"].

Available filters

The following filters are available in Clean Testimonials so you can customise it to your liking.

  1. new_testimonial_notification - Filter whether an email notification should be sent to the administrator when a new testimonial is submitted.
  2. new_testimonial_email - Filter which email address which the new testimonial notification email is sent to. Defaults to administrator email.
  3. new_testimonial_confirmation_message - Filter the text which is displayed when a new testimonial is received.
  4. new_testimonial_failure_message - Filter the text which is displayed when a testimonial submission fails.
  5. ct_disable_captcha - Return true to disable captcha on the testimonial submission form

Available actions

The following actions are available in Clean Testimonials so you can customise it to your liking. 1. ct_before_render_testimonial - Fires before a testimonial is rendered. Passes in $testimonial and $context 1. ct_after_render_testimonial - Fires after a testimonial is rendered. Passes in $testimonial and $context

I am a developer, what can you tell me?

The following information might be handy for you to know.

  1. Testimonials operate via a custom post type which is simply named "testimonial".
  2. Testimonials are grouped in a custom taxonomy named "testimonial_category".
  3. The Testimonial widget class name is "Testimonial_Widget" and of course extends WP_Widget.

Requires: 2.5 or higher
Compatible up to: 3.8.8
Last Updated: 2014-6-14
Active Installs: 4,000+

Ratings

4.5 out of 5 stars

Support

0 of 3 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