=== Easy Testimonials === Contributors: richardgabriel, ghuger Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=V7HR8DP4EJSYN Tags: testimonials, testimonial widget, testimonial feed, random testimonials Requires at least: 3.1 Tested up to: 4.2.2 Stable tag: 1.28.2 License: GPLv3 or later License URI: http://www.gnu.org/licenses/gpl-3.0.html Easy Testimonials is a simple-to-use plugin for adding Testimonials to your WordPress Theme, using a shortcode or a widget. == Description == Easy Testimonials is an easy-to-use plugin that allows users to add Testimonials to the sidebar, as a widget, or to embed them into a Page or Post using the shortcode. The Easy Testimonials plugin also allows you to insert a list of all Testimonials or output a Random Testimonial. Easy Testimonials allows you to include an image with each testimonial - this is a great feature for adding a photo of the testimonial author. = Premium Support = The GoldPlugins team does not provide direct support for the Easy Testimonials plugin on the WordPress.org forums. One on one email support is available to people who have purchased Easy Testimonials Pro only. Easy Testimonials Pro also includes tons of extra themes and advanced features including a Testimonial Collection Form, so you should [upgrade today!](https://goldplugins.com/our-plugins/easy-testimonials-details/upgrade-to-easy-testimonials-pro/ "Upgrade to Easy Testimonials Pro") = Easy Testimonials is a great plugin for: = * Adding a Random Testimonial to Your Sidebar * Adding a Random Testimonial to Your Page * Outputting a List of Testimonials * Outputting a Fading or Sliding Testimonial Widget * Able To Use Multiple Testimonial Themes on the Same Page! * Developers love our Filters! * Displaying an Image with a Testimonial * Displaying a Testimonial with a Rating * Displaying Testimonials using Schema.org compliant markup * Custom Options Allow You to Link Your Testimonials to a Custom Page, Such As a Product Page * Testimonial Categories Allow You To Organize Testimonials in Many Ways! * Collect Testimonials: Front-End Testimonial Submission Form Allows Customers to Submit Testimonials on your Website! * Its easy to use interface allows you to manage, edit, create, and delete Testimonials with no new knowledge Easy Testimonials includes options to set the URL of the View More Link, whether or not to display the Testimonial Image, and more! You can set the URL of the Testimonials read more links for many purposes - such as directing visitors to the product info page that the testimonial is about. Showing an Image next to a Testimonial is a great tool! Collecting Testimonials can be a tedious job - fortunately, in the Pro version of Easy Testimonials, adding a form to your website for users to submit Testimonials is a breeze! Users can even upload an image with their Testimonial! Easy Testimonials integrates with Really Simple Captcha to prevent spam form submissions. = Why Do I Need Testimonials on My Website? = Testimonials are a great thing to add to your website, for many reasons. * Testimonials help potential customers get to know that you are a credible business. * Testimonials give you the opportunity to point out specific features or compelling reasons why a customer should buy from you. * Testimonials, when used effectively, are a great tool to increase conversions rates on your website! The Easy Testimonials plugin is the easiest way to start adding your customer testimonials, right now! Click the Download button now to get started. The Easy Testimonials plugin will inherit the styling from your Theme - just install and get to work adding your testimonials! == Installation == 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](https://goldplugins.com/documentation/easy-testimonials-documentation/ "Easy Testimonials Pro Documentation") 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. - **Location / Product Reviewed / Other:**This field is optional and is displayed third, below Position / Location / Other. The field title is just an example of how it can be used - typically this item is used for the Item the Testimonial is being left about and will match the itemReviewed Schema. - **Rating:** This field is displayed in different locations, depending on your theme, and represents the out of 5 rating for the item reviewed. If you are collecting ratings with your Testimonials, place them in this field. - **Featured Image:** This image is shown to the left of the testimonial, as a 50px by 50px thumbnail by default. - **Testimonial Category:** This field is useful for grouping and organizing your Testimonials. This can be useful if you want to display Testimonials about a certain topic as a group. ### 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 following shortcode syntax: [testimonials theme='card_style-maroon'] - To get the full list of Themes available to your version of Easy Testimonials, we recommend using the Shortcode Generator. ### Outputting Random Testimonials - To output a Random Testimonial, place the following shortcode in the desired area of the Page or Post Content: [random_testimonial] - To display more than one Random Testimonial, use the following shortcode, where count is the number of testimonials you want displayed. [random_testimonial count='3'] - To display the title above the Random Testimonial and use excerpts (short versions of the Testimonial), use the following shortcode: [random_testimonial show_title='1' use_excerpt='1'] - To output Random Testimonials from a specific Category, with images, use the following shortcode: [random_testimonial category='the_category_slug' show_thumbs='1'] - To display the rating along with the random testimonial, use the following shortcode: [random_testimonial show_rating='stars'] Possible values for show_rating 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`, to show the rating in stars format. ### Output a List of Testimonials - To output a list of all the Testimonials, place the following shortcode in the desired area of the Page or Post Content: [testimonials] - To output a list of the 5 most recent Testimonials, use the following shortcode: [testimonials count='5' order='DESC' orderby='date'] 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 title above the list of Testimonials and use excerpts (short versions of the Testimonial), use the following shortcode: [testimonials show_title='1' use_excerpt='1'] - To output Testimonials from a specific Category, with images, use the following shortcode: [testimonials category='the_category_slug' show_thumbs='1'] - To display the rating along with the testimonials, use the following shortcode: [testimonials show_rating='stars'] Possible values for show_rating 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`, to show the rating in stars format. - To paginate the list of Testimonials, use the following shortcode: [testimonials paginate='1' testimonials_per_page='5'] ### Output a Random Testimonial in the Sidebar - To output a Random Testimonial in the Sidebar, use the Widgets section of your WordPress Theme, accessible via 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 choose a Category to pick the testimonial from, with the Category drop-down. - You can show the Date of the Testimonial by checking Show Testimonial Date. - You can show the Rating of the Testimonial by picking an option from the Show Rating drop-down. - 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](https://goldplugins.com/documentation/easy-testimonials-documentation/easy-testimonials-examples/ "Example Testimonial Sliders"). - Easy Testimonials Supports Cycle2! To output a sliding widget, use the following shortcode: [testimonials_cycle] - The same properties as the list of testimonials, such as Showing the Title and controlling the Count, also apply. To output a Testimonial Cycle using excerpts, from a specific category, with images, use the following shortcode: [testimonials_cycle category='the-category-slug' use_excerpt='1' show_thumbs='1'] - To show a randomly ordered Testimonial Cycle, use the following shortcode: [testimonials_cycle random='true'] - To show a sliding Testimonial Cycle, with 10 seconds between each transition, use the following shortcode: [testimonials_cycle timer='10000' transition='scrollHorz'] To pick from our full list of available transitions, we recommend using the Shortcode Generator. - To show a sliding Testimonial Cycle, using the 5 most recent Testimonials ordered chronologically, use the following shortcode: [testimonials_cycle count='5' order='DESC' orderby='date'] Acceptable attributes for `'order'` are `'ASC'` and `'DESC'`. Acceptable attributes for `'orderby'` are `'none'`,`'ID'`,`'author'`,`'title'`,`'name'`,`'date'`,`'modified'`,`'parent'`, and `'rand'` - To show a Testimonial Cycle that automatically changes height to match the Testimonial body, use the following shortcode: [testimonials_cycle container='1'] - To show a Testimonial Cycle with 3 Testimonials per Slide and Pager Icons below the Slider, use the following shortcode: [testimoanials_cycle pager='1' testimonials_per_slide='3'] ### Outputting a Testimonial Slider in the Sidebar - To output a Testimonial Cycle in the Sidebar, use the Widgets section of your WordPress Theme, accessible via the Appearance Menu in the WordPress Admin. - You can control 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 Date of the Testimonial by checking Show Testimonial Date. - You can control the number of Testimonials Per Slide by using the Testimonials Per Slide input. - You can show clickable pager icons below the Testimonial slideshow by checking Show Pager Icons. - You can Randomize the order of the Slideshow by checking Random Testimonial Order. - You can limit the length of the Testimonial to just the Excerpt by checking Use Testimonial Excerpt. - 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. - You can choose a Category to pick the testimonial from, with the Category drop-down. - You can show the Rating of the Testimonial by picking an option from the Show Rating drop-down. ### Front End Testimonial Submission - **NOTE:** This feature requires the [Pro version of Easy Testimonials](https://goldplugins.com/our-plugins/easy-testimonials-details/ "Easy Testimonials Pro"). - To display the Testimonial Submission Form, use the following shortcode: [submit_testimonial] - Any submissions will be added to your Testimonials list, on the back end, as pending Testimonials. Only Testimonials that you choose to publish will be displayed publicly. - Captcha support is enabled with the installation of the [Really Simple Captcha plugin](https://wordpress.org/plugins/really-simple-captcha/ "Really Simple Captcha"). - Front End Image Submission is enabled via a checkbox on the Submission Form Options tab. - Labels, descriptions, and visibility of fields can be controlled via the Submission Form Options screen. ### 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 - `easy_t_single_testimonial_html` -- single testimonial filter - `easy_t_testimonials_html` -- all testimonials list filter - `easy_t_testimonials_cyle_html` -- testimonials cycle filter - `easy_t_submission_form` -- testimonial submission form ### Outputting a Count of your Testimonials - To display a numerical Count of your Testimonials, use the following shortcode where you want the Number to appear: [testimonials_count] - To display a numerical Count of your pending Testimonials from a specific category, use the following shortcode: [testimonials_count status='pending' category='gold-plugins'] - Supported parameters for `status` are `publish`,`pending`,`draft`,`future`,`private`,`trash`,`any`. For example, the following shortcode will display a count of all Testimonials, excluding those in the Trash: [testimonials_count status='any'] - **Note:** this Shortcode only displays the numerical count -- you will need to add any words yourself. For example, "There are currently [testimonials_count] Testimonials on your website!" ### Ouptting a Testimonials Search Form - To display a form that Searches your Testimonials, use the following shortcode: [easy_t_search_testimonials] ### 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