Giter Site home page Giter Site logo

post-voting's Introduction

Post Voting

INACTIVE NOTICE: This plugin is unsupported by WPMUDEV, we've published it here for those technical types who might want to fork and maintain it for their needs.

Translations

Translation files can be found at https://github.com/wpmudev/translations

About

Give users a way to throw your content a thumbs-up. Post Voting Plugin lets you track the content your users love...and hate.

icon-vote-735x470

Add Digg functionality to WordPress.

One-Click Feedback

Capture user feedback by letting them cast a vote with a click. Use a simple thumbs up or down, +1 or 5 star rating system. Track site and network-wide voting from the included dashboard Voting Statistics screen.

Voting with Style

Choose from 6 voting icon styles to perfectly fit the look and feel of your site. Automatically insert voting icons above or below your post or use shortcodes for custom integration.

5-star-735x470

Integrate a trackable 5 star rating system.

Built For Multisite

Post Voting plugin is fully Multisite compatible including global vote sharing, the ability to share top-voted posts from across your network and network-wide stat tracking.

vote-post-type-735x470

Limit voting to the post types of your choice.

Custom Fit

Post Voting Plugin looks amazing out-of-the-box with any well coded WordPress theme. Plus, our full shortcode library and 3 built-in widgets provide a simple way to create a completely custom look and feel.

Usage

For help with installing plugins please see our Plugin installation guide

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 site-by-site (say if you wanted to make it a Pro Sites premium plugin), or visit Network Admin -> Plugins and Network Activate the plugin.

Getting Started

Once activated, you'll see a new menu item in your dashboard: Settings > Post Voting.

Post Voting Menu

Let's get started by configuring the settings. Click to go to Settings > Post Voting. You'll see a couple of tabs at the top of the page, one for Settings and one for Shortcodes.

Voting Settings

The default settings are the most commonly used and will suit most scenarios. We'll go through the options one by one to see what they do.

Post Voting - Settings

The Allow post voting option lets you enable or disable the plugin's features. Tick the Allow voting for unregistered users option to allow logged out users (visitors) to vote. This can be very handy for engaging your site's visitors but could also possibly lead to less than optimal voting stats. The Use IP check option is incredibly helpful when allowing visitors to vote, it will track votes by IP and disallow more than one vote per item from the same IP. Encourage signups using the Show login link for visitors option. The Do NOT show voting for these types option lets you choose which post types to not to show voting options on. If you have an e-commerce solution for example, you could allow voting on the Products post type but not on regular Posts. The Voting box position option lets you choose where you want the voting options to appear. The available options are as follows:

  • Before the post
  • After the post
  • Both before and after the post
  • Manually position the box using shortcode or widget

Choose from a number of included voting images with the Appearance option. You can choose to disable negative votes by ticking the Prevent negative voting option. This can help to avoid abuse from users who might try and take advantage by down-voting others. The Voting on Front Page option lets you show the voting options within each post on your blog front page. Otherwise, the plugin will just display the voting options within single post listings. When used in Multisite, the Prevent Site Admins from making changes? option will be present which lets you limit the options to the Network Admin page. Site Admins wouldn't be able to change these options.

Add-ons

Just below all the general settings is an Add-ons sub-section where you'll find some nifty add-ons that you can activate/deactivate to extend the plugin's features. The add-ons currently included with the plugin are as follows:

Allow daily voting

Activate this add-on to allow your visitors to vote once a day, instead of voting once for all.

Five-star rating

Activating this add-on will convert up/down voting into 5-star rating system.

You can simply click the Activate or Deactivate links under the add-on names.

Post Voting - Add-ons - Activate

Be sure to click the Save Changes button to save the settings once done.

Post Voting - Save Changes

Shortcodes

Let's take a quick look at the Shortcodes tab. Post Voting provides extensive shortcodes and template tags to help you use and integrate it with your site. Here you'll find detailed instructions on how to use them.

Post Voting - Shortcodes

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.
  • [wpdpv_vote_down] - will display just the "Vote down" link.
  • [wpdpv_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! [wdpv_vote post_id="25"]

The following shortcode can also be used to display a list of posts with highest number of votes. [wdpv_popular] There are 2 parameters that can used with this one: limit and network. For example:

  • [wpdpv_popular] - will display the 5 highest rated posts on the current blog.
  • [wpdpv_popular limit="3"] - will display the 3 highest rated posts on the current blog.
  • [wpdpv_popular network="yes"] - will display the 5 highest rated posts on the entire network.
  • [wpdpv_popular limit="10" network="yes"] - will display the 10 highest rated posts on the entire network.

There are a number of template tags detailed in the Shortcodes tab as well. These provide an easy way to integrate the plugin with your theme, especially great for theme developers or those looking for extensive customization features.

Let the users vote!

Here are a few examples of how users will see the voting options in the front end.

Post Voting - Example

Example of default voting options with Twenty Twelve theme

Post Voting - Example - Star Rating

Example of voting options when using Star Rating add-on in Twenty Fourteen theme

Voting Stats

Voting Stats for all posts can be checked in Dashboard > Voting Stats in the site admin dashboard.

Post Voting - Voting Stats

Widgets

Post Voting also provides a number of widgets, these can be added via Appearance > Widgets.

Post Voting Widgets

1. Top voted Posts on Network (for Multisite)

2. Top voted Posts

3. Voting Widget

Post Voting - Top voted Posts Widget

Top voted Posts widget in front-end using Twenty Twelve theme

post-voting's People

Contributors

aristath avatar igmoweb avatar spoygg avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.