BWL Pro Voting Manager Plugins
Documentation by
Md Mahbub Alam Khan


BWL Pro Voting Manager Plugins v1.1.5

Created: 28/04/2014
Last Edited: 28/03/2017
By: Md Mahbub Alam Khan
Get Support: Send Message
Web Site: www.bluewindlab.net

Thank you for purchasing BWL Pro Voting Manager Plugins. If you like this plugin, feel free to rate it five stars at CodeCanyon downloads section. If you encounter any problems please do not give a low rating but contact me first. So I can help you.
Thank You!


Table of Contents

  1. Quick Introduction
  2. Installation
  3. How To Use?
  4. Voting Manager Widget
  5. Shortcodes
  6. Option Panel
  7. Translate Plugin
  8. Upgrade Notes
  9. Change Log
  10. Credits
  11. Conclusion

A. Quick Introduction? - top

Finding a solution to collect votes for your posts from users? Then, BWL Pro Voting Manager is your ultimate solution that provide you all options to add a custom voting system in single post as well as custom post types single post.

Also, Plugin comes with feedback submission option that gives you a nice way to collect user feedbacks and improve your post contents.

Custom Widget option allows you to show top up voted and top down voted posts in sidebar area of your website. This plugin has an extensive option panel with useful features that allows you to customize everything of voting interface. It's very simple but much more efficient. Checkout our plugin outlook in WordPress site-


B. Installation: - top

- Steps:

  1. Go to plugins section in your wordpress admin panel and click Add New to install plugin.
  2. Now, upload the "bwl-pro-voting-manager.zip" file.
  3. Once it uploaded successfully you will get success message and then activate the plugin.
  4. After activating plugins, you will redirect in plugins section of wp-admin panel and show new installed plugins information in there.
  5. Now you are ready to use BWL Pro Voting Manager Plugin! In left sidebar menu you will see a new section like following image.

C. How to use ? - top

This plugin require almost zero configuration and coding knowledge. After completing successful installation process, you will see a voting panel just below the every single post content. Check following screenshot-

  1. Two buttons are available to collect user votes. First one is for collect Up(like) Votes and second one is for Down(dislike) Votes.
  2. In Right side you can see three rows. First row displaying Total No of Votes for current post.
  3. Second row displaying the up and down vote progress bar. You can change bar colors from option panel.
  4. Finally, third row displaying individual numbers of up and down vote casted for current post.

Feedback Form For Down Vote:

Feedback form provide a great way to collect instant comments from users and improve post contents. After submit a feedback by user plugin send feedback message to site admin email address. You can change email address from option panel. Also, You can enable/disable email notification feature.

Feedback Form comes with a nice option to protect spam. Plugin verify human by a random math CAPTCHA. If user successfully answer the CAPTCHA question, only then plugin forward feedback message to admin email and store message in DB for future use. All input form user is properly sanitized.

Voting Report Panel & Manual Vote Submission:

Voting report panel display details voting information about each post type and its corresponding posts voting status. You can also add votes / remove votes manually and download report as CSV format from report section.


D. Voting Manager Widget? - top

Plugin comes with built-in widget feature that allows you to display Top Up Voted and Top Down Voted posts in sidebar. Go to Appearance >> Widgets. You will find a widget box titled by BWL Voting Manager Widget. Drag and drop it in your right side widget container. Remember, for using this feature your theme must support widget option.

- Custom Post Types Support -

After setup all things successfully you can view voting widget in your website sidebar.

Voting and Feedback Statistics -

From admin panel post list you can easily view No of like votes, No of dislike votes and No of feedbacks submitted by users for each posts.

Bulk & Quick Edit -

You can easily reset votes and feedback data using both Quick and Bulk edit option. Also, If you want you can easily change voting interface display status.

Single Post Settings -

Plugin comes with a very powerful option to control voting interface individually. You can easily set Show/Hide/Pause/Close/Custom Interval for voting interface. Also, you can customize voting bar styles.

- Voting Box Types:

- Voting Box Location:

- Voting Paused Settings:
If you want you can pause voting for any post. But users can view post voting results though voting has been paused.

- Voting Date Range Settings:
You can set custom starting and ending voting date for any posts/custom posts. This option is helpful when you run a voting contest for a specific date range. Voting interface will be automatically closed after ending date period.

-Voting Not Started Notification:

-Voting Time Expiry Notification:

E. Shortcodes? - top

Using shortcode editor, you can easily integrate voting panel any where of your website. Available shortcodes listed in below-

Display Voting Box: [bwl_pvm/]

Display Voting Box with animated progress bar: [bwl_pvm animation=1/]

Display Voting Results(Display Both Like/Dislike Counter): [bpvm_results/]

Hide Like Voting Results: [bpvm_results show_like=0/]

Hide Dislike Voting Results: [bpvm_results show_dislike=0/]

Display 5 top liked post of last 1 day :
[bpvm_filter order_type='liked' limit=5 date_filter=1 interval='1 day' /]

Display 5 top liked post of last 7 days :
[bpvm_filter order_type='liked' limit=5 date_filter=1 interval='1 week' /]

Display 5 top liked post of last 30 days :
[bpvm_filter order_type='liked' limit=5 date_filter=1 interval='1 month' /]

Display 5 top liked post of custom date interval :
[bpvm_filter post_type="post" thumb="1" interval="custom" vis="2015-10-01" vie="2015-10-21" order_type="liked" order="DESC" limit="5" /]

Display 5 top disliked post of last 1 day :
[bpvm_filter order_type='disliked' limit=5 date_filter=1 interval='1 day' /]

Display 5 top disliked post of last 7 days :
[bpvm_filter order_type='disliked' limit=5 date_filter=1 interval='1 week' /]

Display 5 top disliked post of last 30 days :
[bpvm_filter order_type='disliked' limit=5 date_filter=1 interval='1 month' /]

Display 5 top disliked post of custom date interval :
[bpvm_filter post_type="post" thumb="1" interval="custom" vis="2015-10-01" vie="2015-10-21" order_type="disliked" order="DESC" limit="5" /]

Custom Posts Lists for submit vote :
[pvm_lists ids="3,4,6,7" title_tag="h4" /]

F. Option Panel Settings? - top

General Options -

Post Type Setttings -

Theme Options -

Tipsy Options -

Voting Filter Settings -

User Role Filter Settings -

Advance Options -


G. Translate Plugin. - top

"BWL Pro Voting Manager" offers cool translation feature. So, you can easily add this plugin any kind of website. Check following steps for translate "BWL Pro Voting Manager" plugin.

  1. Inside of plugin "lang" folder you will get a file named "en_EN.po" file. To edit this file you need to install "poedit" software in your computer.
  2. Our Plugin text-domain is 'bwl-pro-voting-manager'
  3. If you are doing "localization of a plugin" for the first time, then I recommend you to check this video. http://www.youtube.com/watch?v=aGN-hbMCPMg
  4. Suppose you want to translate plugin in to "German" language. So,".po" file name will be
    "bwl-pro-voting-manager-de_DE.po". That's all.
  5. For country code check - http://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/Country-Codes.html#Country-Codes
  6. For Language code check - http://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/Usual-Language-Codes.html#Usual-Language-Codes

H. Upgrade Notes - top

Please take a backup before update all files and folder.

2017, March, 28 - v 1.1.5
- Replace all files and folders.

2016, October, 12 - v 1.1.4
- Replace all files and folders.

2016, April, 27 - v 1.1.3
- Replace all files and folders.

2016, April, 14 - v 1.1.2
- Replace all files and folders.

2016, January, 23 - v 1.1.1
- Replace all files and folders.

2015, October, 12 - v 1.1.0
- Replace all files and folders.

2015, May, 10 - v 1.0.9
- Replace all files and folders.

2015, April - v 1.0.8
- Replace all files and folders.

2015, February - v 1.0.7
- Replace all files and folders.

2014, November, 06 - v 1.0.6
- Replace all files and folders.

2014, September, 22 - v 1.0.5
- Replace all files and folders.

2014, June, 19 - v 1.0.4
- Replace all files and folders.

2014, May, 11 - v 1.0.3
- Replace all files and folders.

2014, May, 12 - v 1.0.2
- Replace all files and folders.

2014, May, 07 - v 1.0.1
- Replace all files and folders.

2014, April, 29 - v 1.0.0
- Initial release


I. Change Log - top

2017, March, 28 - v 1.1.5
- Added option to display voting counter in percentage format.
- Improved plugin performance.
- Checked compatibility with WordPress latest version.
- Improved Language File
- Improved Documentation

2016, October, 12 - v 1.1.4
- Added option to automatic show voting interface in blog/category/tags/archive page.
- Improved voting report table.
- Improved Language File
- Improved Documentation

2016, April, 27 - v 1.1.3
- Fixed date interval voting filter issue.
- Improved voting report section.
- Improved Language File
- Improved Documentation

2016, April, 14 - v 1.1.2
- Added the option to download voting data in CSV format.
- Added option to set voting box location(After/Before the post)
- Fixed share button display issue.
- Fixed user role based voting issue.
- Fixed post filter display limit issue.
- Improved Language File
- Improved Documentation

2016, January, 23 - v 1.1.1
- Added Extensive Voting Report Panel.
- Added Manual Voting Feature.
- Improved Option Panel.
- Improved Language File
- Improved Documentation

2015, October, 12 - v 1.1.0
- Improved voting interval for posts.
- Improved custom filters for display top liked/top disliked post in a date range.
- Fixed share button display issue.
- Improved Language File
- Improved Documentation

2015, May, 10 - v 1.0.9
- Improved Shortcode Editor.
- Added RTL Feature.
- Improved Language File
- Improved Documentation

2015, April - v 1.0.8
- Added shortcode to display like/dislike results in anywhere..
- Fixed update notification issue.
- Improved Language File
- Improved Documentation

2015, February - v 1.0.7
- Added share buttons on submit votes.
- Added date range feature for voting.
- Added show/hide votes counter options in widget area.
- Added Maximum no of vote submission from same IP feature.
- Added user role based voting feature.
- Improved JS and CSS scripts.
- Improved Plugin option panel.
- Improved Language File
- Improved Documentation

2014, November, 06 - v 1.0.6
- Added TinyMCE integrated shortcode editor.
- Added Option to Disable Voting Bar.
- Update Top up/down voted posts filter interface.
- Update Language File
- Update Documentation

2014, June, 29 - v 1.0.4
- Add date filtering feature in shortcode.
- Add Gallery Post Type Voting Support.
- Support WooCommerce Product Voting.
- Disable Feedback From Option.
- Add update notification feature.
- Improved Language File
- Improved Documentation

2014, May, 11 - v 1.0.3
- Improved Shortcode Feature
- Introduced Tooltip on voting buttons.
- Added Tooltip customize Feature In Admin Panel
- Improved Language File
- Improved Documentation

2014, May, 12 - v 1.0.2
- Added Shortcode Feature
- Support Custom Post Type.
- Reset Like/Dislike Voting.
- Integrated Bulk edit of voting option.
- Added Advanced Option In Option Panel
- Improved Language File
- Improved Documentation

2014, May, 07 - v 1.0.1
- Initial release
- Added custom image upload option for voting icons
- 7 Predefined Voting Icons.
- Disabled Down Voting option
- Integrated Bulk edit of voting option.
- Integrated Voting Closed Option.
- Improved Language File
- Improved Documentation

2014, April, 29 - v 1.0.0
- Initial release


J. Credits - top

- Ideas & Coded By Md. Mahbub Alam Khan

- Color Picker By http://www.eyecon.ro/colorpicker

K. Conclusion: - top

Once again, thank you so much for purchasing BWL Pro Voting Manager Plugins.

Md. Mahbub Alam Khan

Go To Table of Contents