• Installation
• Quick Setup
• Shortcode
• Extend this plugin

Guide to the Good Reviews for WordPress plugin for WordPress

This guide will help you install and configure the plugin for your site.

Further support for this plugin can be found at themeofthecrop.com.

Installation

The following steps describe how to upload the Good Reviews for WordPress plugin to an existing WordPress installation. If you have not yet installed WordPress, consult the WordPress documentation for more information.

1. Unpack the good-reviews-wp.zip file. It should create a folder named /good-reviews-wp/.
2. Upload the /good-reviews-wp/ folder to your WordPress plugin directory at /wp-content/plugins/.
3. Go to your WordPress admin dashboard at yoursite.com/wp-admin and click the Plugins item in the menu on the left.
4. Find Good Reviews for WordPress in the list of Plugins and click the Activate link below the plugin name.

The plugin is now active. Now you can start adding reviews.

Quick Setup

To get this plugin working as quickly as possible, all you need to do is add a review and then add it to your site.

1. Go to the Good Reviews > Add New page in your admin dashboard.
2. Create a new review. You need to add a reviewer name and the review in the content area, but the rest you can leave off if you want.
3. To add your reviews to any page or post, add the [good-reviews] shortcode. There is also a widget you can add to any sidebar to display one or all of your reviews.

Shortcode

Prints one or all reviews. All reviews will be displayed with the default shortcode [good-reviews]. To show a single review, use the ID. You can find the shortcode for any single review by looking on the right-hand panel while editing the review.

[good-reviews review=0]

• review
  Use a review's ID here to show just a single review. Don't include this attribute if you want to show all reviews.
• random
  Set this to 1 and it will order the reviews randomly. Add a limit attribute to show one or more randomly selected reviews.
• limit
  Set this from 1 to any number to limit how many reviews to show. Use this in combination with the random attribute to show one or two randomly selected reviews.
• category
  Set this to the category slug to only show reviews from this category. This can be combined with other attributes to show, for example, 2 reviews randomly selected from a specific category.
• cycle
  If the shortcode will show more than one review, you can set the cycle to "fader" to have it cycle through each review using a fade effect.
• excerpt
  Set this to 1 if you have longer reviews and want to display an excerpt that links to the main review on your site.

Extend this plugin

This plugin has been designed from the ground up to be extensible and customizable. There are several hooks to allow you to customize the functionality and output.

If you have any questions, please contact me.

This plugin is available on GitHub if you would like to contribute pull requests.