Testimonials Widget plugin allows you to display rotating content, portfolio, quotes, showcase, or other text with images on your WordPress blog.
Contributors: comprock
Donate link: http://aihr.us/about-aihrus/donate/
Tags: ajax, business, client, commendation, custom post type, customer, quotations, quotations widget, quote, quote shortcode, quotes, quotes collection, random, random content, random quote, recommendation, reference, shortcode, sidebar, sidebar quote, testimonial, testimonial widget, testimonials, testimonials widget, testimony, widget
Requires at least: 3.4
Tested up to: 3.4.2
Stable tag: 2.0.4
License: GPLv2 or later
Description
Testimonials Widget plugin allows you to display rotating content, portfolio, quotes, showcase, testimonials, or other text with images on your WordPress blog. You can insert Testimonials Widget content via shortcode, theme functions, or widgets with category and tag selections and having multiple display options to include random or specific ordering.
More than one Testimonials Widget section can be displayed at a time. Each Testimonials Widget separately pulls from the testimonials-widget
custom post type. Additionally, with shortcodes and theme functions, you can display a short or long list or rotation of testimonials. Also, each Testimonal Widget has its own CSS identifier for custom styling.
Through categories and tagging, you can create organizational structures based upon products, projects and services via categories and then apply tagging for further classificaton. As an example, you might create a Portfolio category and then use tags to identify web, magazine, media, public, enterprise niches. You can then configure the Testimonial Widget to show only Portfolio testimonials with the public and enterprise tags. In another Testimonial Widget, you also select only Portfolio testimonials, but then allow web and media tags.
Features
- Admin interface to add, edit and manage testimonials
- Auto-migration from old custom table to new custom post type
- Company, URL and email details are attempted to be identified and placed properly
- Public testimonials are saved as Published. Non-public, are marked as Private.
- Compatible with WordPress multi-site
- Display testimonials directly in template via theme function
- Editors and admins can edit testimonial publisher
- Fields for source, testimonial, email, company and URL
- Image, Gravatar, category and tag enabled
- Localizable – see
languages/testimonials-widget.pot
- Multiple widget capable
- Rotation JavaScript in footer than body
- Testimonial supports HTML
- Testimonial, email, and URL fields are clickable
- Testimonials Widget widget displays static and rotating testimonials
- [testimonialswidget_list] shortcode
- [testimonialswidget_widget] shortcode
- Widget options
- Title
- Category filter
- Tags filter
- Require all tags
- Advanced options
- Hide image?
- Hide source?
- Hide email?
- Hide company?
- Hide URL?
- Character limit
- IDs filter
- Limit
- Minimum Height
- ORDER BY
- ORDER BY Order
- Random order
- Refresh Interval
Shortcodes [testimonialswidget_list] [testimonialswidget_widget]
- Shortcode Options
category
– default none; category=product or category=”product,services”char_limit
– default none; char_limit=200hide_company
– default show; hide_company=truehide_email
– default show; hide_email=truehide_image
– default show; hide_image=truehide_source
– default show; hide_source=truehide_url
– default show; hide_url=trueids
– default none; ids=2 or ids=”2,4,6″limit
– default 25; limit=10order
– default DESC; orderby=ASCorderby
– default ID; order=post_daterandom
– default newest first; random=true (overrides order
and orderby
)tags_all
– default OR; tags_all=truetags
– default none; tags=fire or tags=”fire,water”
- [testimonialswidget_list] Examples
- [testimonialswidget_list hide_source=true hide_url=true]
- [testimonialswidget_list tags=”test,fun” random=true]
- [testimonialswidget_list category=”product” tags=”widget” limit=5]
- [testimonialswidget_list ids=”1,11,111″]
- [testimonialswidget_widget] Examples
- [testimonialswidget_widget]
- [testimonialswidget_widget tags=”sometag” random=true]
- [testimonialswidget_widget category=”product” order=”asc”]
Theme Function `testimonialswidget_list()`
<?php echo testimonialswidget_list( $args ); ?>
$args
is an array of the above [testimonialswidget_list] shortcode options – optional
Theme Function `testimonialswidget_widget()`
- For calling the widget with rotation code into your theme directly
<?php echo testimonialswidget_widget( $args, $number ); ?>
$args
is an array of the above [testimonialswidget_list] shortcode options – optional$number
should be an arbitrarily number that doesn’t conflict with existing actual Testimonial Widgets widget IDs – optional
Notes
- Default image size is based upon Thumbnail size in Media Settings
- Gravatar image is configured in the Avatar section of Discussion Settings
Languages
You can translate this plugin into your if it’s not done so already. The localization file testimonials-widget.pot
can be found in the languages
folder of this plugin. After translation, please send the localized file to the plugin author.
Background & Thanks
Version 2.0.0 of Testimonials Widget is a complete rewrite based upon a composite of ideas from user feedback and grokking the plugins Imperfect Quotes, IvyCat Ajax Testimonials, Quotes Collection, and TB Testimonials. Thank you to these plugin developers for their efforts that have helped inspire this rewrite.
A cool thanks to RedRokk Library for the redrokk_metabox_class. It makes configuring metaboxes for your posts, pages or custom post types a snap.
Prior to version 2.0.0, this plugin was a fork of Quotes Collection by Srini G with additional contributions from j0hnsmith, ChrisCree and comprock.
Installation
- Upload
testimonials-widget
directory to the /wp-content/plugins/
directory - Activate the ‘Testimonials Widget’ plugin through the ‘Plugins’ menu in WordPress
Usage
- Add and manage the quotes through the ‘Testimonials’ menu in the WordPress admin area
- To display testimonials in the sidebar, go to ‘Widgets’ menu and drag the ‘Testimonials’ widget into the desired widget area
- Configure the Testimonial Widget to select quotes and display as needed
- Alternately, use the
[testimonialswidget_list]
or [testimonialswidget_widget]
to display testimonials on a page or in a post - Or read the description for
testimonialswidget_list()
and testimonialswidget_widget()
theme functions usage
Frequently Asked Questions
How do you include the actual testimonials for the widget? Where do I quote my customers? I mean, where do I enter the actual text?
Checkout the first screenshot 1 at http://wordpress.org/extend/plugins/testimonials-widget/screenshots/ to see where to manage testimonials.
Basically, look down the left side of your WordPress admin area for the Testimonials sections. Click on that section link, then scroll down or click “Add new ttestimonial” to add quotes.
How do I change the image size?
The default image size is based upon Thumbnail size in Media Settings. If changing that doesn’t work for you, then use add_filter
in your theme to adjust the image size.
add_filter( 'testimonials_widget_image_size', array( 120, 90 ) );
You can use either a string keyword (thumbnail, medium, large or full) or a 2-item array representing width and height in pixels, e.g. array(32,32).
How do I change the Gravatar size?
Use an add_filter
in your theme to adjust the Gravatar size.
add_filter( 'testimonials_widget_gravatar_size', 120 );
Default Gravatar size is 96, maximum 512.
What CSS applies to testimonials container?
CSS class testimonialswidget_testimonials
wraps all testimonials. Additionally, shortcode lists are wrapped by testimonialswidget_testimonials testimonialswidget_testimonials_list
.
What CSS applies to single testimonial container?
CSS class testimonialswidget_testimonial
wraps a single testimonial. Additionally, single shortcode list tems are wrapped by testimonialswidget_testimonial testimonialswidget_testimonial_list
.
How can I add the testimonials plugin to any where on the site? ie. somewhere other than the side bar like the contact page etc.?
Use [testimonialswidget_list]. Usage examples are at the bottom of http://wordpress.org/extend/plugins/testimonials-widget/.
Look for [testimonialswidget_list]
.
How do I hide the comma after the source?
Use CSS.
.testimonialswidget_testimonial .testimonialswidget_join { display: none; }
Testimonials widget is not showing or rotating
The usual problem is that jQuery is included twice. Once by WordPress and again by a theme. Remove the jQuery version included by your theme and you should be fine.
I’m not seeing any testimonials but the title
If you’re not seeing any testimonials, even when not using tags filter, you might try increasing the Character limit or setting it to ’0′ or ‘none’ in the widget box.
How do I apply custom CSS to a testimonial widget?
The easiest thing is to check the source code of your page with the widget and look for the testimonial widgets div container id tag. It’ll be something like id="testimonials_widget-3"
.
How to stop testimonial text being cut off in the widget?
Specify a larger minimum height in the testimonials widget, see screenshot 3.
How to get rid of the quotation marks that surround the random quote?
.testimonialswidget_testimonial q { quotes: none; }
How to change the random quote text color?
Styling such as text color, font size, background color, etc., of the random quote can be customized by editing the testimonials-widget.css file or applying CSS like the following.
.testimonialswidget_testimonial q { color: blue; }
How can I style the shortcode testimonials?
Using my own testimonials page, http://aihr.us/typo3-vagabond-testimonials/, as the example.
Each shortcode testimonial is wrapped by a div
using classes testimonialswidget_testimonial testimonialswidget_testimonial_list
. As such, to increase spacing between testimonials, try…
.testimonialswidget_testimonial_list { padding-bottom: 1em; }
Making the citation line a different color is a little trickier. The reason being is that applying a color to .testimonialswidget_testimonial cite
will change the entire citation line in the widget display as well. To only change the shortcode testimonial citation color, try…
.testimonialswidget_testimonial_list cite { color: blue; }
If you’re wanting to change only the company or URL color, then try.
.testimonialswidget_testimonial_list cite .testimonialswidget_company { color: purple; }
Like wise, the source uses class testimonialswidget_source
.
How do I change the join “, ” text?
In CSS, revise the join content like the following.
.testimonialswidget_testimonial .testimonialswidget_join:before { content: " | " }
How to change the admin access level setting for the quotes collection admin page?
Change the value of the variable $testimonialswidget_admin_userlevel
on line 33 of the testimonials-widget.php file. Refer WordPress documentation for more information about user roles and capabilities.
How do I put company details on a separate line?
In CSS put the following.
.testimonialswidget_testimonial .testimonialswidget_join { display: none; } .testimonialswidget_testimonial .testimonialswidget_company, .testimonialswidget_testimonial .testimonialswidget_url { display: block; }
I’m stuck, how can I get help?
Visit the support forum and ask your question.
Screenshots
- Testimonials admin interface
- Edit testimonial
- Testimonials Widget options – top
- Testimonials Widget options – bottom
- [testimonialswidget_widget] in post and testimonial widget in the sidebar
- [testimonialswidget_list] in post
- [testimonialswidget_list] results
-
- screenshot-1
-
- screenshot-2
-
- screenshot-3
-

- screenshot-4
-
- screenshot-5
-

- screenshot-6
-
- screenshot-7
Changelog
trunk
* Mark testimonialswidget_widget() $number
argument as optional
2.0.4
- Allow for 0 refresh_interval in get_testimonials_html
2.0.3
- Allow for 0 refresh_interval in widget
2.0.2
2.0.1
- Verbiage updates
- Readme.txt validation
- widget q p tag display inline
- GPL2 licensing
- Move upgrade notice text towards installation
- Reorder screenshots
- Apply ‘the_content’ filters directly to prevent plugin baggage
- Update screenshot-7.png
2.0.0
- Major rewrite
- Add filters for image & gravatar sizes
- Admin bar New > Testimonial
- Authors and lower can manage their own testimonials
- Auto-migration from old to new format upon install
- Public > Published
- Not public > Private
- Categories – product, project, service
- Clean up verbiage
- Cleaner widget class
- Custom columns list view
- Image
- Source
- Shortcode
- Email
- Company
- URL
- Published by
- Category
- Tags
- Date
- Custom fields metabox
- Custom post-type
- Default fields – source, email, company, URL
- Editors and higher can manage all testimonials and edit testimonial publisher
- Enable categories and tags
- Enable full shortcode options in widget
- Gravatar
- HTML content allowed
- Images
- JavaScript in footer
- Localization
- Reference shortcode column
- Reorganize widget options panel
- Rotation JavaScript in footer than body
- Shortcode options validation
- WP_Query for get_testimonials()
- Widget image on own line
- Widget options
- Title
- Category filter
- Tags filter
- Require all tags
- Advanced options
- Hide image?
- Hide source?
- Hide email?
- Hide company?
- Hide URL?
- Character limit
- IDs filter
- Limit
- Minimum Height
- ORDER BY
- ORDER BY Order
- Random order
- Refresh Interval
- Move caching to ideas
- Add theme function
testimonialswidget_widget()
doc - Update POT
- [testimonialswidget_widget] shortcode
- Match [testimonialswidget_widget] shortcode option defaults to widget
- Update screenshots
- Readd Minimum Height – need help getting around this
0.2.13
- Clean up CSS
- Remove q & cite p wrapper
0.2.12
0.2.11
- Enable character limit for shortcode
0.2.10
- Character limit nows forces text truncation than preventing of testimonial to show
- Add option – Limit number of testimonials to pull at a time
- Sanitize widget variables
- Fix random_order issue on testimonials widget
0.2.9
- Require Editor role for managing Testimonials
0.2.8
- CSS testimonialswidget_testimonial_list fix #2
0.2.7
- CSS testimonialswidget_testimonial_list fix
0.2.6
- CSS updates for widgets and lists
0.2.5
- Add span.testimonialswidget_join for author , join text
- Add nl2br for testimonials display on a page
0.2.4
- Shortcode added – Thank you Hal Gatewood
0.2.3
- Allow testimonials to have multiple tags
- Show only quotes with all tags
0.2.2
- Show newest testimonials first in admin list by default
- Quick locallization
- Quotes Collection recommendation
2011-10-03: Version 0.2
- Multi-widget enabled
- Testimonial, author & source text are clickable automatically
- Allow 0 refresh to make widget static
- Allow pressing return when editing testimonial to save record
2011-08-12: Version 0.1
Upgrade Notice
- Version 2.0.0
- CSS
Class testimonialswidget_company replaces testimonialswidget_source
Class testimonialswidget_source replaces testimonialswidget_author
The tighten widget display up, p tags within q are displayed inline.
Shortcode options
hide_source replaced by hide_url
hide_author replaced by hide_source
TODO
- Ideas
- Caching
- Centralized defaults – share widgets and shortcode options
- CSV import
- Custom CSS
- Custom templating
- Disable post password
- During migration
- Pull out images and attach correctly
- Set category
- Fields to show
- Global options page
- Number of refresh interations
- Widget options inherit from global
- Minimum height removal for widgets
- Move CSS to footer? – http://wordpress.org/support/topic/plugin-testimonials-widget-html-validation
- Next/Back buttons or click to advance – http://wordpress.org/support/topic/plugin-testimonials-widget-how-to-add-nextback-buttons-or-clickthrough
- Pagination when using shortcode
- Scrolling text – http://wordpress.org/support/topic/plugin-testimonials-widget-scroll-for-a-single-but-long-testimonial
- Testimonial manual ordering
- Translate with WPML
Related Entries
I am getting error Call to undefined function testimonialswidget_widget() in
when I add this
Franklin, Could you please submit a support post at http://wordpress.org/support/plugin/testimonials-widget? This way, the support is centralized and available for other people who might have this issue. Next, when leaving the support request, please copy and paste the whole error message and describe how to replicate the problem. Thank you, Michael