Simple Rating Plugin

Version 2.0 is currently in the works. If you’d like to see a certain feature in this release, please create a thread and tell me about your idea.

Current changelog for 2.0

Simple rating plugin with few features.

Features:

• 4 shapes which come in 5 colors to fit wide variety of themes
• Adjust scale of rating
• Turn on/off display of amount of votes
• Display before or after content
• Select for what types of content rating will be displayed
• Disable rating for specific entry
• Choose alignment of the rating
• Customize vote count style
• Widget that lists your top rated content
• Works with custom posts types
• Supports aggregated rating to show rating in search engine’s snippets
• Allow or disallow guests to vote
• Rating statistics metabox
• Few languages available with an ability to easily add your own

1. Upload the simple-rating folder to the /wp-content/plugins/ directory
2. Activate the Simple Rating plugin through the ‘Plugins’ menu in WordPress
3. Configure the plugin by going to ‘Simple Rating’ page under ‘Settings’ menu

1. 

   Simple Rating settings

2. 

   Disable rating for specific post

3. 

   Top Rated Content widget

4. 

   Example of Google Search snippet when Aggregated rating is enabled

5. 

   Rating statistics metabox which shows what votes were cast for current entry

Installation Instructions

1. Upload the simple-rating folder to the /wp-content/plugins/ directory
2. Activate the Simple Rating plugin through the ‘Plugins’ menu in WordPress
3. Configure the plugin by going to ‘Simple Rating’ page under ‘Settings’ menu

How do I add rating to my posts/pages?

You can do it in two ways:

• Automatically – set ‘Insertion method’ option to ‘Automatic’ (default). Plugin will use content filter to add rating based on your settings.
• Manually – set ‘Insertion method’ option to ‘Manual’ and insert <?php if(function_exists('spr_show_rating')){echo spr_show_rating();}?> where you need it in your template. [!]You should remove function from wherever you’ve inserted it if you plan to remove plugin[!]

Can I reset votes?

Yes, you can by pressing “Reset votes” button on Simple Rating setting page.
Note: This only resets votes. Plugin will automatically fully remove its data upon deletion.

If I don’t want to add rating for specific post or page, can I disable it for that specific post or page?

You certainly can. Just tick the box “Disable rating” when editing/publishing post or page in question.

Can I leave ‘Vote count color’ empty?

Yes, you can. In that case, color will be inherited.

Are custom post types supported?

Yes, they are.

Is there a function to pull rating of specific post I can use in PHP?

Yes, there is such a function.

spr_get_entry_rating($post_id, $echo); 

This function returns whole html block of rating

Parameters:
$post_id (integer) (required) ID of post, page or custom post type entry
$echo (boolean) (optional) (default: false) whether result should be echoed or returned for use in PHP

Are there localizations available?

Yes, currently, next languages are available:
* English
* Ukrainian
* Russian

Can I easily translate it to my language?

Yes, you certainly can. Please read how_to_translate.txt for localization instructions.

I broke my site while trying to create my own localization. What should I do?

First of all, you should have read how_to_translate.txt more carefully. Actually, go read it now. It explains what to do in this situation (at the end of file).

1.4

• Added ability to easily translate plugin to your language. Please read how_to_translate.txt for localization instructions. At this time English, Ukrainian and Russian languages are available (just because I don’t know any other languages)

1.3.3

• Solved conflict with WordPress SEO (possibly other too) which prevented voting from working

1.3.2

• Fixed ‘NOTICE: UNDEFINED OFFSET’ which occured when WP_DEBUG was set to true and entry had no votes yet.
• Fixed notice about deprecated functions (since WordPress 3.6) which occured when WP_DEBUG was set to true when voting.
• Added function to pull rating of specific post for use in PHP (Refer to FAQ).
• Clarified use of function when using manual insertion method in FAQ and tooltip in settings so that users don’t encounter error when deactivating plugin and not removing function from whenever it’s used. (though I recommend you to remove function from all files if you plan to deactivate and remove plugin)
• Fixed bug in settings.

1.3.1

• Fixed bug with alignment. It now works properly. Thanks to alkahf for reporting.
• Fixed bug with styling when displaying rating in loops.

1.3

• Added Aggregated Rating (see 4th screenshot for example) functionality. Your rating can now be shown in search engines’ snippets.
• Added notification when settings are successfully updated .
• Added metabox which shows rating statistics.
• You can now allow guests to vote .
• Added tooltips to make configuration easier and more understandable. Thanks to Chris Bracco for tooltips style.
• Fixed bug in live preview.
• Fixed bug in widget.

1.2.1

• Added ability to show rating in the loop on the home page.
• Fixed bug with displaying in archives which could be experienced when using manual insertion.

1.2

• Added widget that lists your top rated content.
• As promised, Simple Rating now works with custom post types (Please, go to settings and re-select where to show rating).
• Added mechanism to ensure that rating will be added only once when using manual insertion method.
• Rating won’t show on archive pages (category, tag, custom post type archive, etc) if rating is disabled for that post type.
• Minified CSS and JS to save 1,34 Kb. Imagine all saved bandwidth 😉

1.1.2

• Fixed bug with “Show in loops” functionality which could be experienced when using manual insertion method.

1.1.1

• Added ability to show rating in loops (category pages for example) (requested by user alkahf).

1.1

• Added ability to disable rating for specific post or page .
• Added ability to select way to insert rating: Automatically (via content filter. Default) or Manually (insert wrapper function where you need it).
• Ability to select alignment of the rating.
• Ability to change color of vote count text.
• Added ability to make vote count bold/italic.
• Clean up on deletion of plugin.
• Added button to reset votes.
• Added link to settings on ‘Plugins’ page.

1.0.1

Bugfixes:

• Added IF NOT EXISTS condition to table creation query.
• Fixed embarrassing typo.

1.0

Initial release.