=== Plugin Name ===
Contributors: philip.newcomer
Author: Philip Newcomer
Author URI: http://philipnewcomer.net
Donate link: http://philipnewcomer.net/donate/
Tags: rating, author, stars
Version: 1.0
Stable tag: 1.0
Requires at least: 3.1
Tested up to: 3.4.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Allows a post author to assign a simple 1-5 star rating to a post, page, or custom post type, which will then be displayed on the post.

== Description ==

There are plenty of plugins available which allow site *visitors* to rate posts, but I didn't find any that gave the post *author* that functionality, so I wrote this plugin. *Author Post Ratings* adds a meta box to the post edit screen, allowing you to chose a 1-5 star rating for the post, or to leave it unrated. The plugin will automatically add the post rating (using stars, and an optional label) to the top or bottom of the post. If you wish, you can disable that functionality altogether and use a shortcode to insert the post rating anywhere in the post you choose. The plugin supports ratings for posts, pages, and custom post types, all of which can be individually enabled or disabled in the plugin settings. It is also fully internationalized.

== Installation ==

To manually install the plugin, follow these steps:

1. Unzip the plugin, and upload the 'author-post-ratings' folder to your `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Optional: Go to Settings->Author Post Ratings and configure the plugin settings

== Frequently Asked Questions ==

= How do I customize the CSS of the post rating output? =

You can edit `author-post-ratings.css` in the plugin folder.

= I don't like the star graphics that come with the plugin, or I want to use a different color. Can I change them? =

Sure, just replace the two images in the `author-post-ratings/images/` directory with your own star images. You can also download the Photoshop source files for the supplied star images from the [plugin homepage][plugin homepage URL].

= Where do I get support for this plugin? =

Please use the plugin's support forum here on WordPress extend.

= Are there any functions I can use in my template files? =

Yes. You can use `get_author_post_rating()` and `the_author_post_rating()` in your templates. These functions are explained in more detail on the [plugin homepage][plugin homepage URL].

= This plugin is useful and I want to donate to the author. =

Bless you. Please head on over to my [donate page](http://philipnewcomer.net/donate/). Any donation, no matter how large or small, is greatly appreciated!

[plugin homepage URL]: http://philipnewcomer.net/wordpress-plugins/author-post-ratings/

== Screenshots ==

1. The post rating meta box which can be enabled for posts, pages, or custom post types
2. A post with an author post rating displayed in the Twenty-Eleven theme
3. The plugin settings

== Changelog ==

= 1.0 =
* Initial Release