=== wpCJ Testimonials === Contributors: willcast Plugin URI: http://www.wpcj.com/plugins/testimonials Author URI: http://www.wpcj.com Tags: testimonials,reviews,critics Requires at least: 2.8 Tested up to: 2.8.4 Stable tag: 1.0.4 This plugin helps you manage a list of testimonials that you can place anywhere in your blog using shortcodes, php calls or widgets. == Description == This plugin helps you manage a list of testimonials that you can place anywhere in your blog using shortcodes, php calls or widgets. Optionally, you can specify what "product" a given testimonial is refering to so basically you can use this plugin to present testimonials about different products or services. == Installation == The easiest way to install it is using the WordPress build-in installation feature: * Look for wpCJ Testimonials * Click on Install * Then click on Activate If you prefer to use the old fashion way then: * Download the plugin zip file, * Uncompress it anywhere in your hard disk and then * Upload it to your plugin directory. * Visit the Plugins page of your WordPress installation, * Locate wpCJ Testimonials in the plugin list and * Click on Activate. Once you have activate it, a new option is added to your WordPress Settings module named wpCJ Testimonials and a new widget as well. In the plugins page, you will find four options to set: * **Template:** This setting is used to specify the "layout" of a testimonial. You can use a pure HTML template or, much better, a CSS powered template. It's up to you, just be sure to include the pseudo-tags that the plugin provides ([CLIENT] [COMPANY] [LCOMPANY] [WEBSITE] and [TESTIMONIAL]). * **Link Attribute:** You can specify if the links that the plugin create based on the website of the clients, will have the attribute rel="nofollow" or not. * **Max. Size for images:** (still not used but) It specify the maximum weight in KB that an image can be. * **Zap Me!:** It just tell the plugin that you want to completelly uninstall the plugin so the next time it gets deleted, it delete any trace of the plugin from your WordPress installation. **Usage** Once you have set the configuration settings of the plugin, it will allow you to introduce the testimonials. **Handling Testimonials** The Manage Testimonials page have two section: An upper section where you add or edit testimonials and a lower section showing the current list of testimonials. There are two mandatory fields for any testimonial: Client and Testimonial. Optionally you can especify the client's company, its website and an image. There is a field named "Product". This field is useful if you want to store different testimonials for different products or services. All you have to do is especify a unique "product key" for every object you want to store testimonials to. Or leave it blank if they are not useful to you. If you need to edit a testimonial, click on the Client Name in the Testimonial List and then proceed to edit it. Click on Save Changes when you are done and that's it. **Showing Testimonials** wpCJ Testimonials allows you to show your testimonials in every possible way allowed by WordPress: * **Shortcodes:** If you need to add a list of testimonials to any post or page, use the shortcode [wpcjt]. It has three optional parameters: limit, product and id. Limit define the number of testimonials to be show (default 1), Product defines the criteria to use when the plugin choose the testimonials to show and ID a certain testimonial to show (or the latest $limit testimonials if you use 'last' as id. I.e.- **[wpcjt limit="3" product="wpCJ"]** or **[wpcjt limit="3" id="last"]** * **Widgets:** If you need to show a testimonial box in any of your sidebars, just add a wpCJ Testimonials widget to it. This widget needs three parameters: Title, Number of Testimonials, Product and ID. They are pretty self-explanatories... or not? * **PHP Calls:** Just in case you need to add testimonials to your themes, we have provided an option to do so. Just add the following code to your theme: **``** == Changelog == = 1.0 = * First public version = 1.0.1 = * Support for i18n initiated (still working on it though). * Added a new parameter to the shortcode, php call and widgets: ID. Now you can specify which ID you wan't to show. Also, there is a special id called 'last'): If you specify the parameters $limit and $id='last' you will get the latest $limit testimonials. = 1.0.2 = * Correct stripping of slashes in testimonials and client names. * In testimonials list, added an "Edit" link below client name. = 1.0.3 = * handling some weird slashes here and there. * Added the possibility to add images to the testimonials. = 1.0.4 = * I think I finally solved the issues with non-english characters, charsets, slashshes and stuff like that. * Also solved and false error given when you saved an testimonial where no image was supplied,