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, with Spanish language translation files included.
You can download the plugin from its page in the WordPress plugin directory.
Author Post Ratings is installed just like any other WordPress plugin. No configuration is required, but if you wish, you may change the plugin settings at Settings > Author Post Ratings.
If you’re not familiar with installing WordPress plugins, follow these steps to install the plugin:
- Login to your WordPress dashboard, and go to Plugins > Add New.
- In the Search box, type in ‘Author Post Ratings’, and click ‘Search Plugins’.
- Author Post Ratings should be the first item in the list. Click on ‘Install Now’.
- WordPress will download and install the plugin. Click on the ‘Activate Plugin’ link, and you’re in business!
Manual Installation Via FTP
- Download the plugin to your computer, and unzip it.
- Using an FTP program, upload the ‘author-post-ratings’ folder to your `/wp-content/plugins/` directory.
- Activate the plugin through the ‘Plugins’ menu in WordPress.
Manual Installation Via WordPress Upload
- Download the plugin ZIP file to your computer.
- In your WordPress dashboard, go to Plugins > Add New.
- Click on the ‘Upload’ link at the top.
- In the file selection box, select the plugin ZIP file on your computer, and click on ‘Install Now’.
- WordPress will upload and install the plugin. Click on the ‘Activate Plugin’ link, and you’re in business!
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 here: author-post-ratings-photoshop-files.zip.
Where do I get support for this plugin?
Please use the plugin’s support forum on WordPress extend.
Are there any functions I can use in my template files?
Yes. You can use
get_author_post_rating( $post_id ) and
the_author_post_rating( $post_id ) in your templates. Passing the post ID is optional, if you don’t include it the plugin will use
get_the_ID() to try and figure it out for itself. You can pass the current post ID, or the ID of another post if you wish.
get_author_post_rating() will return the numeric post rating, if the post has one. This value does not include the HTML markup or star images which would surround the post rating on a normal post, it just returns the rating value itself.
the_author_post_rating() will echo the post rating along with the label and star images. Optionally, you can set the second parameter to true to return the markup instead of echoing it, like this:
$rating_markup = the_author_post_rating( $post_ID, true );
This plugin is useful and I want to donate to the author.
Thank you! Please head on over to my donate page. Any donation, no matter how large or small, is greatly appreciated!
Translating the Plugin
The post rating label text can be changed in the plugin settings, so no translation is required for the frontend (public side) of the site. However, if you wish to translate the backend settings interface, the plugin is fully internationalized and ready for translation. There is a .po and a .mo file included in the plugin’s ‘languages’ directory for your convenience.
The plugin includes the following translations:
- Spanish courtesy of WebHostingHub.
- 1.1.1 (2013-11-30)
- Added Spanish language translation files, courtesy of WebHostingHub. No changes to main plugin code.
- 1.1 (2012-09-03)
- Added option to only show the rating in singular views, to hide the post rating on archive pages when the `<!–more–>` quicktag is used in place of true excerpts
- Updated readme.txt: clarified installation instructions, added documentation for new plugin setting, added translating section
- Updated screenshot of plugin settings page to show new settings field
- Changed the way the plugin handles its saved settings internally
- Updated language files
- 1.0 (2012-08-14)
- Initial release
If you need help, please do not comment on this page asking for help. Instead, open a new thread on the plugin’s support forum on WordPress extend. That way others will be more likely to see your thread and benefit from the solution, or possibly even help you themselves.