About this plugin↑ Back to Top

Nice Testimonials displays quotes from your clients in a clean, responsive and beautiful way. You can show your testimonials using a shortcode or template tags (PHP functions).

This plugin is fully integrated with WordPress. It makes use of its native architecture to show your testimonials, and includes a huge set of hooks, so you can customize it in any way you need.

Nice Testimonials works right out of the box with any theme.

Installation↑ Back to Top

Using The WordPress Dashboard

1. Navigate to the “Add New” link in the plugins dashboard.
2. Search for “Nice Testimonials“.
3. Click “Install Now”.
4. Activate the plugin on the Plugin dashboard.

Uploading in WordPress Dashboard

1. Navigate to the “Add New” in the plugins dashboard.
2. Navigate to the “Upload” area.
3. Select nice-testimonials.zip from your computer.
4. Click “Install Now”.
5. Activate the plugin in the Plugin dashboard.

Using FTP

1. Download nice-testimonials.zip.
2. Extract the nice-testimonials directory to your computer.
3. Upload the nice-testimonials directory to the /wp-content/plugins/ directory.
4. Activate the plugin in the Plugin dashboard.

Setting up↑ Back to Top

Once you installed and activated the plugin, you can go to Testimonials > Settings and tweak the options there. Those settings will also be used as the default ones for the shortcode and template tag when you’re not specifying any values for them.

Shortcode↑ Back to Top

The basic usage of the shortcode is just [testimonials]. That will display a list of your testimonials using the settings you entered in Testimonials > Settings.

However, you can specify values for the shortcode using the following fields:

• id: Numeric ID for a single testimonial to be displayed.
• columns: The number of columns to be displayed in a list of testimonials.
• limit: The maximum number of testimonials to be displayed in a list. A value of zero means nothing will be displayed. You can use -1 for no limit.
• image_size: The size (in pixels) of your testimonial image.
• orderby: The ordering criteria that will be used to display your testimonials. Accepted values: ID, title, menu_order, date, random.
• order: The sorting criteria that will be used to display your testimonials. Accepted values: asc (ascendant), desc (descendant).
• category: Comma-separated numeric IDs of testimonial categories that you want to display. A value of zero means that all categories will be considered.
• exclude_category: Comma-separated numeric IDs of testimonial categories that you want to exclude. A value of zero means that no categories will be excluded.
• include_children: Choose if you want to display testimonials from sub-categories. Accepted values: 1 (display), 0 (not display).
• author: Choose if you want to see the name of the testimonial’s author. Accepted values: 1 (display), 0 (not display).
• avatar: Choose if you want to see the image of the testimonial’s author. Accepted values: 1 (display), 0 (not display).
• url: Choose if you want to display a link to the website of the testimonial’s author. Accepted values: 1 (display), 0 (not display).
• avatar_link: Choose if you want the image of the testimonial’s author to link to the author’s website. Accepted values: 1 (display), 0 (not display).
• avoidcss: Choose if you want to remove the default styles for the current list of testimonials. Accepted values: 1 (avoid styles), 0 (not avoid styles).

If any of these values is not declared explicitly, the default value will be the one set in Testimonials > Settings.

A typical usage of the shortcode with these fields would be the following:

[testimonials columns="2" limit="5" image_size="120" orderby="date" order="asc"]

Template tag (PHP function)↑ Back to Top

You can include testimonials in your own templates by using our nice_testimonials() function. This is a very basic usage example:

<?php
if ( function_exists( 'nice_testimonials' ) ) :
    nice_testimonials();
endif;
?>

As it happens with the shortcode, that code snippet will display a list of your testimonials using the settings you entered in Testimonials > Settings. However, you can give the function an array of options with specific values on how to show the list of testimonials:

• id: Numeric ID for a single testimonial to be displayed.
• columns: The number of columns to be displayed in a list of testimonials.
• limit: The maximum number of testimonials to be displayed in a list. A value of zero means nothing will be displayed. You can use -1 for no limit.
• image_size: The size (in pixels) of your testimonial image.
• orderby: The ordering criteria that will be used to display your testimonials. Accepted values: ID, title, menu_order, date, random.
• order: The sorting criteria that will be used to display your testimonials. Accepted values: asc (ascendant), desc (descendant).
• category: Comma-separated numeric IDs of testimonial categories that you want to display. A value of zero means that all categories will be considered.
• exclude_category: Comma-separated numeric IDs of testimonial categories that you want to exclude. A value of zero means that no categories will be excluded.
• include_children: Choose if you want to display testimonials from sub-categories. Accepted values: 1 (display), 0 (not display).
• author: Choose if you want to see the name of the testimonial’s author. Accepted values: 1 (display), 0 (not display).
• avatar: Choose if you want to see the image of the testimonial’s author. Accepted values: 1 (display), 0 (not display).
• url: Choose if you want to display a link to the website of the testimonial’s author. Accepted values: 1 (display), 0 (not display).
• avatar_link: Choose if you want the image of the testimonial’s author to link to the author’s website. Accepted values: 1 (display), 0 (not display).
• avoidcss: Choose if you want to remove the default styles for the current list of testimonials. Accepted values: 1 (avoid styles), 0 (not avoid styles).

If any of these values is not declared explicitly, the default value will be the one set in Testimonials > Settings.

Using these options, you can have something like this in your code:

<?php
if ( function_exists( 'nice_testimonials' ) ) :
    nice_testimonials( array(
        'columns'    => 2,
        'limit'      => 5,
        'image_size' => 96,
        'order'      => 'date',
        'sort'       => 'asc',
    ) );
endif;
?>

Using custom CSS↑ Back to Top

You can load a custom stylesheet by using wp_enqueue_script() and adding your custom CSS to your own file. However, if you really want to get rid of the default CSS of Nice Testimonials, so you can avoid overriding our styles, you can check the “Avoid Plugin CSS” option in Testimonials > Settings.