WordPress.org

You can install from within WordPress using the Plugin/Add New feature, or if you wish to manually install:

1. Download the plugin.
2. Upload the entire ivycat-ajax-testimonials directory to your plugins folder.
3. Click Activate Plugin in your WordPress plugin page.

Overview

Here's the gist: you add testimonials to the system, and create testimonial groups if you need to categorize them so you can 'pull' them into different areas of the site. Then use simple shortcodes to embed a testimonial in a page or post.

Create a Testimonial Group

To create a testimonial group, go to Testimonials/Testimonial Groups and add a new group category. Groups aren't mandatory, but can make it easier to segment your testimonials later.

For example, if you wanted to have a specific testimonial that is shown in the Services pages of your site, you might create a group called Services so you can easily identify them in the future and add them to your shortcodes.

Add Testimonials

Adding testimonials is easy:

1. Go to Testimonials / New Testimonial - this will allow you to enter the testimonial, cite (where it comes from), and embed images, if necessary.
2. Give your testimonial a title; this is the cite, so if the testimonial is from Joe Blow, you'd enter "Joe Blow".
3. Enter the testimonial content (text or HTML) in the main editor window, which is the body of the testimonial. Note: images, html and text are okay here.
4. Assign the testimonial to a group, if applicable. If you haven't already created a group, click on the Add New Category link in the testimonial Groups box and add one.
5. Give this testimonial an order in its group. If you want it to show first in your Services testimonial, set Order to 1 under Testimonial Data.

Embed a testimonial in a page or post using shortcodes:

There are several shortcode variations listed below, and the shortcodes can be combined to pull only the testimonials you need, displayed how you'd like them.

• [ic_do_testimonials] - Adds a testimonial, Defaults to three testimonials.
• [ic_do_testimonials group='my-created-group'] - Adds testimonials from a custom group. Defaults to 3 testimonials
• [ic_do_testimonials quantity='5'] - changes default quantity to 5.
• [ic_do_testimonials num_words='55'] - Shows only the first x number of words, as defined by value given
• [ic_do_testimonials num_words='55' read_more='[...]' ] - When num_words is given, allows the text for the "read more" link to be changed
• [ic_do_testimonials ajax_on='no'] - Adds the ability to turn off AJAX. If AJAX is disabled, a random testimonial will be shown on page load. (on by default)
• [ic_do_testimonials link_testimonials=true] - Adds the ability to link to individual testimonials. (off by default)
• [ic_do_testimonials all_url='http://www.example.com/testimonials/'] - give a url to show all of the testimonials. The page for this is not part of the plugin, so you'll want to add one.

Changing timing on AJAX rotation:

Note: All timing speeds below are listed in milliseconds.

1000 milliseconds = 1 second 100 milliseconds = 1/10th of a second

• [ic_do_testimonials speed='6000'] - change how long each slide is shown.
• [ic_do_testimonials fadeIn='600'] - change timing for each slide to fade in.
• [ic_do_testimonials fadeOut='700'] - change timing for each slide to fade out.

Shortcode Examples

If you wanted to pull in a total of three testimonials from the 'wordpress' category, but you don't want AJAX rotation, your shortcode might look like:

[ic_do_testimonials group='wordpress' ajax_on='no']

Note: I didn't specify 3 testimonials because that's the default number, but I could have:

[ic_do_testimonials group='wordpress' ajax_on='no' quantity='3']

Or, say you wanted to dynamically rotate between five testimonials in the group called 'licorice', but you only want to show the first 30 words, followed by a link that says "find out more . . ." your shortcode would look like this:

[ic_do_testimonials group='licorice' quantity='5' num_words='30' read_more='find out more . . .']

Embed a testimonial directly in your theme template

You can drop the following WordPress function in your template files, replacing the [shortcode] part with your, custom shortcode.

<?php echo do_shortcode("[shortcode]"); ?>