Start by reading Installing plugins section in our comprehensive
WordPress and WordPress Multisite Manual if you are new to WordPress.
1. Download the plugin file
2. Unzip the file into a folder on your hard drive
3. Upload /wpmu-dev-post-votes/ folder to /wp-content/plugins/ folder on your site
4. Login to your admin panel for WordPress or Multisite and activate the plugin:
- On regular WordPress installs – visit Plugins and Activate the plugin.
- For WordPress Multisite installs – Activate it blog-by-blog (say if you wanted to make it a Pro Sites premium plugin), or visit Network Admin -> Plugins and Network Activate the plugin.
Once activated, the default voting options are added to your posts.
1. To customize the location of the voting icons, their appearance and who can vote simply visit Settings > Post Voting.
2. Voting Stats for all posts can be checked in Dashboard > Voting Stats in the site admin dashboard.
3. Top Rated Posts widget, Top Voted posts on network widget and Voting Widget can be added via Appearance > Widgets.
4. Instructions for using the extensive shortcodes and template tags are located at the bottom of Settings > Post Voting in your site’s admin.
But to help get you started, here are a few usage examples. The following shortcodes can be used in any post, page or text widget:
- wdpv_vote – will display all parts of voting gadget – “Vote up” link, “Vote down” link and results.
- wdpv_vote_up – will display just the “Vote up” link.
- wdpv_vote_down – will display just the “Vote down” link.
- wdpv_vote_result – will display just the voting results.
You can include the post_id parameter in the above shortcodes if you want to display the voting widget for a particular post. For example, to prompt your users to vote for a post with an ID of 25, simply add a text widget to your sidebar with this in it:
Vote for this post!
The following shortcode can also be used to display a list of posts with highest number of votes.
There are 2 parameters that can used with this one: limit and network. For example:
- wdpv_popular – will display the 5 highest rated posts on the current blog.
- wdpv_popular limit=”3″ – will display the 3 highest rated posts on the current blog.
- wdpv_popular network=”yes” – will display the 5 highest rated posts on the entire network.
- wdpv_popular limit=”10″ network=”yes” – will display the 10 highest rated posts on the entire network.
Note that any shortcodes you use must be wrapped in square brackets “[ ]“. We simply omitted them here to prevent the shortcodes from executing on this page. :)