
Testimonials Widget Premium extends Testimonials Widget with caching, excerpts, more selection options, post types, shortcodes and user entry.
Contributors: comprock
Donate link: http://aihr.us/about-aihrus/donate/
Tags: client, customer, quotations, quote, quotes, random, review, quote, recommendation, reference, testimonial, testimonials, testimony, widget, wpml
Requires at least: 3.4
Tested up to: 3.6.0
Stable tag: 1.13.0
License: GPLv2 or later (http://www.gnu.org/licenses/gpl-2.0.html)
Description
Testimonials Widget Premium plugin extends the best Testimonials Widget plugin for WordPress with caching, excerpts, filters, read more links, more selection options, and advanced capabilities like selecting posts, pages and other custom post types as testimonials. Additionally, users can add testimonials via a front-end form shortcode or widget.
The Testimonials Widget plugin allows you to display rotating content, portfolio, quotes, showcase, or other text with images on your WordPress blog.
User submitted testimonials are marked as “Pending” in WP Admin > Testimonials listing.
Author: Michael Cannon
Copyright: 2013 Aihrus
Features
- “Read more” link column on testimonial posts admin page
- Akismet anti-spam checking
- Alternate destinations for “Read more” links
- Alternating
.evenand.oddCSS classes for styling testimonial list entries - Built-in update notification
- Caching of testimonials queries and content to decrease server load time improve page loading speed by 1/10 to 1/2 a second
- Deactivates self if no active or incorrect version of Testimonials Widget plugin
- Default post author, category, and status options for user testimonial submissions
- Deletes old and related testimonial cache entries automatically
- Disable caching for widget, shortcode or theme functions
- Email notification for user submitted testimonials
- Excerpts for widget view, with read more link to complete testimonial
- Filters for caching and more link control, text replacement, and more
- Front-end entry form for user supplied testimonials. Live demo
- Multiple anti-spam traps
- Multiple user-entry forms on same page are allowed
- Plugin version tracking to ensure compatibility
- Premium tab on settings screen for site-wide option defaults
- Prevent duplicate testimonials when using multiple testimonial instances
- Read more links for testimonials exceeding the character limit
- Right Now Dashboard widget displays “Pending Testimonials” counts
- Select only testimonials with excerpts, images or of arbitrary maximum and minimum length
- Select post, page and other custom post types for content rotations
- Settings and URL based cache clearing
- Shortcodes and theme functions for testimonials count and testimonial link list
- Shortcodes, theme functions, and widget user testimonial submission form
- Show excerpts with list and single views
- Show unique testimonials on page with multiple testimonial instances
- Testimonial links listing with image, source, title, location, company, and URL fields
- WPML compatible
Shortcodes
- Count of testimonials
[testimonialswidgetpremium_count] - List of testimonial source and title linking to full entry
[testimonialswidgetpremium_link_list] - Testimonials entry form
[testimonialswidgetpremium_form]
Shortcode and Widget Options
- Disable Caching? – Disables caching for this particular Testimonials Widget instance. Useful for letting Testimonials Widget list be cached and shown, while a rotation widget shows a different sequence on each page load
no_cache- default false; no_cache=true
- Link Image? – If checked, wraps image in link to testimonial
link_image- default true; link_image=false
- Hide Excerpt? – Show excerpts instead of testimonial content in widget views. Also, shows excerpts with testimonial content in single views.
hide_excerpt- default show; hide_excerpt=true
- Hide “Read more” Links? – Show ‘Read more’ links on testimonials exceeding the character limit
hide_read_more- default show; hide_read_more=true
- Force “Read more” Links?
force_read_more- default false; force_read_more=true
- Add
nofollowto “Read more” Links?nofollow_read_more- default false; nofollow_read_more=true
- Maximum Length – Maximum number of allowed characters in testimonial content for query selection
maximum_length- default none; maximum_length=500
- Minimum Length – Minimum number of characters required in testimonial content for query selection
minimum_length- default none; minimum_length=250
- Prevent Duplicates? – Prevent allowing duplicate testimonials from showing on a page. Requires caching to be enabled.
unique- default false; unique=true
- Require Excerpt? – Select only testimonials with excerpts
require_excerpt- default none; require_excerpt=true
- Require Image? – Select only testimonials with images
require_image- default none; require_image=true
- Show “Next testimonial…” Link? – Display link to next testimonial for rotating widgets
next_button- default none; next_button=true
- Alternate Testimonial Post Type? – Set this to use Posts, Posts or another custom post type for testimonials
post_type- default testimonials-widget; post_type=post
Form Options
- Default Testimonial Status – default pending; Select blog Publish, Pending, Draft, or Private
- Default Testimonial Author
post_author– default 1; Select blog administrator or editor
- Default Testimonial Category – Only one category is allowed
post_category– default 1; Select Testimonials Widget post category
- Hide Excerpt Field?
hide_post_excerpt– default false; hide_post_excerpt=true
- Hide Title Field?
hide_meta_title– default false; hide_meta_title=true
- Hide Location Field?
hide_meta_location– default false; hide_meta_location=true
- Hide Email Field?
hide_meta_email– default false; hide_meta_email=true
- Hide Company Field?
hide_meta_company– default false; hide_meta_company=true
- Hide URL Field?
hide_meta_url– default false; hide_meta_url=true
- Hide “Read More Link” Field?
hide_meta_read_more_link– default true; hide_meta_read_more_link=false
- Hide Tags Field?
hide_tags_input– default true; hide_tags_input=false
- Hide Image Field?
hide_featured_image_url– default false; hide_featured_image_url=true
- Disallow Edit After Submission?
disallow_edit– default false; disallow_edit=true
- Send Mail Notification? – Send admin notice of testimonial submission
- Akismet API Key – For many people, Akismet will greatly reduce or even completely eliminate the testimonial spam you get on your site. If you don’t have an API key yet, you can get one at Akismet.com.
- Hide “Are you a real person?” – A simple anti-spam helper
hide_are_you_human– default false; hide_are_you_human=true
Shortcode Examples
[testimonialswidget_widget maximum_length=100]- Display only short testimonials[testimonialswidget_widget minimum_length=250]- Ignore short testimonials for display[testimonialswidget_widget next_button=true keep_whitespace=true char_limit=250 min_height=200 minimum_length=100]- Widget with “Read more”, “Next testimonial…”, and minimum height and length requirements links[testimonialswidget_widget next_button=true]- Display rotating testimonials widget with link to next testimonial[testimonialswidget_widget post_type=post]- Display posts instead of testimonials[testimonialswidget_widget require_image=true require_excerpt=true]- Display only testimonials with excerpts and featured images. Great for lead-ins[testimonialswidget_widget unique=true]- Prevent showing previously selected testimonials on a page[testimonialswidgetpremium_count category=product-a]- Display the number of “Product A” category testimonials[testimonialswidgetpremium_form hide_meta_email=true hide_tags_input=false]– Display a testimonial input form on the front-end sans email, but enables tags entry[testimonialswidgetpremium_form hide_post_excerpt=true hide_meta_title=true hide_meta_location=true hide_meta_email=true hide_meta_company=true hide_meta_url=true hide_featured_image_url=true]- Very simple testimonial submission form[testimonialswidgetpremium_link_list char_limit=250]– Display a list of all testimonials with a character limit for each testimonial and with a link to access to the full testimonial page.
Theme Functions
<?php echo testimonialswidgetpremium_count( ); ?><?php echo testimonialswidgetpremium_form( ); ?><?php echo testimonialswidgetpremium_link_list( ); ?>
Filters
testimonials_widget_disable_cache- accepts boolean to use caching or nottestimonials_widget_premimum_form_options- Customize form optionstestimonials_widget_premimum_html_link- Customize testimonial title linktestimonials_widget_premimum_link_title_text- A tag title text prependtestimonials_widget_premimum_more_ellipsis- “…” replacement texttestimonials_widget_premimum_more_text- “Read more” replacement texttestimonials_widget_premimum_next_text- “Next testimonial…” replacement text
Languages
You can translate this plugin into your own language if it’s not done so already. The localization file testimonials-widget-premium.pot can be found in the languages folder of this plugin. Read How do I change Testimonials Widget text labels? for more information on translating.
Support
Please visit the Testimonials Widget Knowledge Base for frequently asked questions, offering ideas, or getting support.
Spam? Read Where’s the CAPTCHA?
Installation
- The ‘Testimonials Widget‘ plugin is required to be installed and activated prior to installing and activating ‘Testimonials Widget Premium’
- Via WordPress Admin > Plugins > Add New, Upload the
testimonials-widget-premium.zipfile - Alternately, via FTP, upload
testimonials-widget-premiumdirectory to the/wp-content/plugins/directory - Activate the ‘Testimonials Widget Premium’ plugin through WordPress Admin > Plugins
Frequently Asked Questions
Please visit the Testimonials Widget Knowledge Base for frequently asked questions, offering ideas, or getting support.
Latest Major Changes
- CSS and JavaScript renaming
bottom_textrenamed tobottom-textclose_quoterenamed toclose-quotedisplay_nonerenamed todisplay-nonejoin_locationrenamed tojoin-locationjoin_titlerenamed tojoin-titleopen_quoterenamed toopen-quotetestimonialswidget_excerptrenamed totestimonials-widget-premium-excerpttestimonialswidget_testimonialrenamed totestimonials-widget-testimonialtestimonialswidget_testimonialsrenamed totestimonials-widget-testimonialstestimonialswidgetpremium_formrenamed totestimonials-widget-premium-form
Screenshots
- Single
[testimonialswidget_list]entry with and without ‘Read more’ link - Widget with “Read more” and “Next testimonial…” links
- Widget with Premium Options
[testimonialswidgetpremium_link_list]Shortcode examples, unstyled- Widget with ‘sample excerpt’ and ‘Read more’ link
- Single view with and without excerpt
require_image,minimum_lengthandmaximum_lengthshortcode option examples- Edit testimonial with “Excerpt” and “Read more Link” fields
[testimonialswidgetpremium_count]Examples[testimonialswidget_widget unique=true]Show multiple testimonials in rotation- Alternating background colors – Courtesy of placeofstillness
- Testimonials Widget Settings > Premium tab
[testimonialswidgetpremium_form]– Add a Testimonial- Testimonials Widget Settings > Entry Form tab
- New testimonial submission email
- Testimonials submission form widget
- Options for testimonials submission form widget
- Dashboard > Right Now “Pending Testimonials” count
Changelog
See Changelog
Upgrade Notice
- 1.12.0
- CSS and JavaScript renaming testimonialswidget_excerpt renamed to testimonials-widget-premium-excerpt testimonialswidget_testimonial renamed to testimonials-widget-testimonial testimonialswidget_testimonials renamed to testimonials-widget-testimonials testimonialswidgetpremium_form renamed to test
- 1.11.1
- Requires at least Testimonials Widget 2.11.2
- 1.11.0
- CSS class names are simplified. For the most part, other than testimonialswidget_testimonial remove testimonialswidget_ from the CSS class name in your CSS customizations. Ex: .testimonialswidget_join becomes .join Ex: .testimonialswidget_author becomes .author Testimonials are now formatted usin
- 1.10.2
- CSS class names are simplified. For the most part, other than testimonialswidget_testimonial remove testimonialswidget_ from the CSS class name in your CSS customizations. Ex: .testimonialswidget_join becomes .join Ex: .testimonialswidgetpremium_testimonials_links to .testimonialswidget_testimonia
- 1.10.0
- Requires at least Testimonials Widget 2.10.0
- 1.9.0
- Using posts, pages, and other custom post types for rotation and testimonials is possible now
- 1.8.0
- Requires at least Testimonials Widget 2.8.0
- 1.7.9
- Requires at least Testimonials Widget 2.7.15
- 1.7.2
- Requires at least Testimonials Widget 2.7.3
TODO
Is there something you want done? Write it up on the support forums and then donate or write an awesome testimonial.
- Add “Stick this testimonial to the top” like option – See Add New Post > Visibility
- CSV import
- Quote or reference Twitter blurbs
- Display the testimonials by Category
- 1. Single `[[testimonialswidget_list]]` entry with and without ‘Read more’ link
- 2. Widget with “Read more” and “Next testimonial…” links
- 3. Widget with Premium Options
- 4. `[[testimonialswidgetpremium_link_list]]` Shortcode examples
- 5. Widget with ‘sample excerpt’ and ‘Read more’ link
- 6. Single view with and without excerpt
- 7. `require_image`, `minimum_length` and `maximum_length` shortcode option examples
- 8. Edit testimonial with “Excerpt” and “Read More Link” fields
- 9. `[[testimonialswidgetpremium_count]]` Examples
- 10. `[[testimonialswidget_widget unique=true]]` Show multiple testimonials in rotation
- Testimonials Widget plugin banner
- Alternating background colors
- Testimonials Widget Settings > Premium tab
- Testimonials Widget Settings > Entry Form tab
- `[[testimonialswidgetpremium_form]]` – Add a Testimonial
- Testimonials submission form widget
- Options for testimonials submission form widget
- Dashboard > Right Now “Pending Testimonials” count
![1. Single `[[testimonialswidget_list]]` entry with and without 'Read more' link](http://cdn.aihr.us/wp-content/uploads/2012/12/screenshot-1-600x364.png)


![4. `[[testimonialswidgetpremium_link_list]]` Shortcode examples](http://cdn.aihr.us/wp-content/uploads/2012/12/screenshot-4-600x477.png)




![9. `[[testimonialswidgetpremium_count]]` Examples](http://cdn.aihr.us/wp-content/uploads/2012/12/screenshot-9-600x320.png)
![10. `[[testimonialswidget_widget unique=true]]` Show multiple testimonials in rotation](http://cdn.aihr.us/wp-content/uploads/2012/12/screenshot-10-600x376.png)




![`[[testimonialswidgetpremium_form]]` – Add a Testimonial](http://cdn.aihr.us/wp-content/uploads/2012/12/screenshot-14-600x373.png)




amazing plugin works beautifully out of the box. Couple of questions:
Any chance of using the ‘excerpt’ field to push to the widget and then the full testimonial could be displayed on the widgetlist?
I’m also trying to get the single testimonial to have some kind of hierarchy with a testimonial ‘page’. Any suggestions?
Jim, Thank you for the compliment.
I’ve not yet implemented the excerpt yet. I’m still pondering that one’s usability.
For hierarchies, there’ll remain none for now. The reason being is that it’s a slow query and there’s other ways to group testimonials via categories and tags.
Actually the excerpt would be used for the short widget display (since you can control exactly what part of the testimonial you want to use in the Excerpt and that can be the ‘draw’ to get someone to read more and go to the actual testimonial). The widget list would just show the full testimonial. This would be great when you want to add before/after shots and include them as additional photos in the testimonial body but don’t need to show it in the widget. I’ve been struggling for most of a day to get the stripped characters option to show the ‘right’ part of the testimonial, without making it look bad on the list version.
On the categories and tags, that would be great, except in a ‘breadcrumbs’ style feature, there’s nothing to relate an individual testimony back to the full group of testimonials. They’re not ‘posts’ per se, they’re a Custom Post Type and should have their own Taxonomy.
Thank you for the feedback.
Would you show the excerpt in the single or list view?
Your breadcrumb code should be able to pick up the chain without issue. You might just need to update it. The tag and category relations are WP defaults than custom.
Jim,
Version 1.4.0 of Testimonials Widget Premium now offers excerpts support. You can download it after Testimonials Widget Premium purchase above.
Michael
Wow, thanks so much for that! Nice job!
You’re welcome. Do let me know of any other suggestions. I just made 2 minor releases that have more capabilities.
do you have a form that users can use to submit a testimonial (ajax would be nice) that integrates with admin to approve, delete, edit and publish testimonial to db?
thanks
Wayne
Wayne, There’s no front end form yet. It’s to be one of my projects while traveling India and Malaysia over the next 5 weeks. Michael
Hi Michael. I am using the testimonial as two unique groups. One is “team profiles” and the other is “testimonials”. Is there a way when the use is in a set, say “profiles”, and selects “Read More” that they do not see the set “testimonials” in the posts next/prev selection. I use the pro version in case that has any functionality to support this. Thank you!
Georgia, thank you for writing.
You’ll need to check “Prevent duplicates?” or `unique=true` in your testimonial options.
Michael
Hi Michael — Thanks for the great support & a great plugin! How does one get updates for the premium version?
Just visit your WordPress > Admin > Dashboard > Updates screen and click “Check Updates”. Then, if you have a newer version of Testimonials Widget Premium it’ll be auto-updated. If not, contact me for a new copy with the email address you purchased or donated through PayPal with.
Uh oh, after the new premium update, the ‘Hide Read More’ link in the Widget no longer works. You can check it out at http://sweatshoptampa.com/
Jim, Thank you for the notification. I’ve fixed this bug plus a few other things for the 1.7.11 release that’s going out now.
@JohnBunka I really love coding http://aihr.us/testimonials-widget-premium/ #wordpress #plugin
hi i just bought the premium version, nice plugin but i’m having a few issues:
1) Next testimonial… link does not work
2) The testimonial do not rotate on the home page side bar widget.
Please advise.
Thanks.
Mei, I’m sorry that you’re having trouble. Please submit your issues to http://wordpress.org/support/plugin/testimonials-widget. Also, don’t forget to specifically provide a URL with the items not working.