About Petitions Manager WordPress Plugin

  • Plugin Version: 1.0.7
  • Plugin Last Update: 15/01/2020
  • Plugin Create Date: 22/09/2016
  • Premium Support: Send Message
  • Web Site: https://bluewindlab.net
  • Developed By: bluewindlab
  • Skype: bluewindlab

If you like this plugin, please spare a minute to rate it.

Plugin Overview

Petition manager is a premium and fully functional petition management WordPress plugin that allows you to create unlimited number of petitions from admin panel. You can easily enter every information for a petition from just a single place. Check petition plugin feature-

  • Create unlimited number of petitions.
  • External petition form to allow user to submit petition.
  • Review and approve petition by admin before publish online.
  • Easy to manage.
  • Report Panel & Download petition signatures in CSV format.
  • Custom section for a petition.
  • About section.
  • Introduction section.
  • Letter section.
  • Where to send section.
  • Petition featured image.
  • Petition success/victory declaration option.
  • Petition featured marked option.
  • Create unlimited petition categories.
  • Ajax powered petition sign form with Captcha security.
  • Allow sign petition only for logged in users.
  • Live signatures scroll option and animated signature counter panel.
  • Custom petition share option.
  • Extensive option panel to customize petition looks.
  • Beautiful page for single petition with comment support.
  • Multi-petitions support.
  • Fully customized visual composer petition blocks.
  • Tested up to latest WP version & Localization supported.
  • Support .po & .mo file.
screenshot

Installation Requirements

You need at least WordPress version 4.8+ installed for this plugin to work properly. It is strongly recommended that you always use the latest stable version of WordPress to ensure all known bugs and security issues are fixed. Other requirements:

  • PHP version 5.3 or greater.
  • MySQL version 5.0.15 or greater.

Installation Steps

To install a plugin, you must first upload the plugin files and then activate the plugin. The plugin files can be uploaded in two ways:

  • FTP Upload: Using your FTP client, upload the non-zipped plugin folder into the /wp-content/plugins/ folder on your server.
  • WordPress Upload: Navigate to Plugins >> Add New >> Upload. Go to browse, and select the zipped plugin folder. Hit "Install Now" and the plugin will be uploaded and installed.

Step 01: Go to WP admin dashboard and click on Plugins >> Add New.

screenshot

Step 02: Click on Upload Plugin and upload petitions-manager.zip file. Finally, click Install Now button.

screenshot

Step 03: Once plugin successfully uploaded in the server, you will get a message to activate it. Click on Activate Plugin Link and plugin will be ready to use . After activating the plugin, you will be redirected in plugins page of the WordPress admin panel, and you will get newly installed Petitions Manager WordPress Plugin in there.

screenshot

Step 04: Now you are ready to use Petitions Manager WordPress Plugin! In left sidebar menu, you will see a new section like the following screenshot.

screenshot

Operate The Plugin

Add New Petition:

Step 01: Login to WP Admin Panel.

Step 02: Navigate to Petitions >> Add New Petition page.

Step 03: Next, add the following informations to generate petition page.

  • Petition title.
  • Petition Introduction.
  • Petition About.
  • Petition Letter.
  • Petition Submitted To.
  • Petition Sign Form & Result Settings.
  • Petition Target Settings.
  • Petition Share.
  • Petition Category.
doc_img

Step 04: Finally, Click Publish/Update button, and you will see output like below-

doc_img

Add Petition Category:

Step 01: Login to WP Admin Panel.

Step 02: Navigate to Petitions >> Petitions Category page.

doc_img

External Petition Form:

You can easily display external petition form to collect petitions from users. Please check following steps to display.

Step 01: Login to WordPress Admin panel.

doc_img

Step 02: Navigate to Products > All Products.

doc_img

Step 03: Once user fill up all the information, plugin create a new account for user and send login information to user email address. Later, User edit petition information by login their account. .

doc_img

Display Custom File Name:

Step 01: Login to WordPress Admin panel.

Step 02: Navigate to Petitions > Option Panel > Advanced Settings.

Step 03: Now, turn ON Enable Display Custom File Title. Then Click Save Changes button.

doc_img

Step 04: Next, Navigate to Media > Library and you will get a new column Custom Title.

doc_img

Step 05: On mouse hover to any file title you will get option for Edit. Click Edit link. Add your own title in Custom Title input box.

doc_img

Step 06: Finally, click Update button to save your settings.

Watch Video Tutorial

Force Disable Download Files:

Step 01: Login to WP Admin Panel.

Step 02: Navigate to Petitions >> Option Panel >> Introduction Block Settings Section.

Step 03: Bottom of the page you'll get option to disable "Force Download". Turn it ON.

doc_img

Step 04: Save settings and check product page.

Petition Report

Step 01: Navigate to Petitions >> Petition Report Section. Next, select the Petition from Petitions drop down list. You will get all files downloaded information in report table.

doc_img

Step 02: You can also filter petition sign data based on custom date range. Check Custom date range check box and set Start & End date. Finally, click Generate Report button.

doc_img

Step 03: Click Download Report button to get the full report in CSV format.

Plugin Shortcodes

Available shortcodes listed in below -

  • Display External Form: 

     [bptm_external_form /]

Petition Form Template

Customize Petition Form Template:

Note:

You need basic PHP coding knowledge to customize the FORM. However, if you face any issue contact with me via support page. I'll be happy to assist you. https://themeforest.net/user/xenioushk

Step 01: Go to wp-content/plugins/petitions-manager/petition_templates folder.

Step 02: Copy the petition_templates folder and paste in to currently activated theme folder.

Step 03: We assume "appeal" is our currently activated theme. Next, go to the wp-content/themes/appeal/petition_templates folder and open the sign_form.php file. Go to line no 114 and you will get the code like following screenshot.

doc_img

Example Shortcode: 

$shorcode_string = '[bpsff cc="2" ft="input" fn="bpt_user_name" fp="' . __('Your Name', 'bwl_ptmn') . '" fr=1 fer="' . __('Name Required', 'bwl_ptmn') . '" /]';
$shorcode_string .= '[bpsff cc="2" ft="input" fn="bpt_user_email" fp="' . __('Your Email', 'bwl_ptmn') . '" fr=1 fer="' . __('Invalid Email.', 'bwl_ptmn') . '" /]';
$shorcode_string .= '[bpsff cc="2" ft="input" fn="zipcode"  fc="bpcf zipcode" fp="' . __('Zipcode', 'bwl_ptmn') . '" fr=1 /]';
$shorcode_string .= '[bpsff rs=0 cc="1" ft="input" fn="bpt_user_address" fp="' . __('ADDRESS', 'bwl_ptmn') . '" fr=1 fer="' . __('Address Required', 'bwl_ptmn') . '" sts="' . $opt_address_status . '"/]';
$shorcode_string .= '[bpsff cc="2" ft="input" fn="city"  fc="bpcf" fp="' . __('CITY', 'bwl_ptmn') . '" fr=1 /]';
$shorcode_string .= '[bpsff cc="2" ft="input" fn="state"  fc="bpcf" fp="' . __('STATE', 'bwl_ptmn') . '" fr=1 /]';
$shorcode_string .= '[bpsff cc="2" ft="country" sts="' . $opt_country_status . '"/]';
$shorcode_string .= '[bpsff cc="2" ft="captcha" fn="captcha" fr=1 fer="' . __('Invalid Captcha.', 'bwl_ptmn') . '" sts="' . $captcha_status . '" /]';
$shorcode_string .= '[bpsff rs=0 cc="1" ft="textarea" fn="bpt_user_msg" fp="' . __('Optional Message', 'bwl_ptmn') . '" sts="' . $opt_msg_status . '"/]';

Important Note:

  • If you want add custom fields, you must add the fc="bpcf" value in to the shortcode. Please check the CITY field in the example code.
  • For Zip Code field, you must add the fc="bpcf zipcode" value in to the shortcode. Please check the ZipCode field in the example code.
  • cc: column class (Example Value: 1,2,3,4,6 )
  • ft: field type (Example: input,textarea,submit )
  • fn: field name (Example: bpt_user_name)
  • fp: field placeholder text (Example: Your Name)
  • fr: field required (Set the value as 0 if you want to mark the field as optional)
  • fer: field error message (Add an error message of a particular filed)

Plugin Option Panel

General Options:

  • Load Font Awesome: Plugin uses Font Awesome icons to display navigation icon. So, If the theme already loaded the icons, turn this option OFF.
  • Login Required: Restrict and allow attachment downloads only for the logged in users.
  • Enable Pagination: Turn this option ON, if you would like to display a bulk amount of attachment files. That will save space and keep the site layout clean. Additionally, you can set the number of attachment plugin show per page.
doc_img

Introduction Block Settings:

Plugin provides all the required options to customize the Attachment tab according to your requirements. Here goes the detail of all options.

doc_img
  • Hide Introduction Block: You can add custom title of Attachment Tab. Default: Attachment
  • Background Color: Plugin allows you to set the attachment tab in a convenient position. For example, use a small number (1,2 or 3) to set tab at the First position and set big number(100, 200, 300) to display attachment tab at the last position.
  • Background Opacity: Turn this option ON and plugin will hide the Attachment Tab automatically, if there is no file available to download for any product.
  • Mix Color With Background Image: Total number of attachment will display beside the Tab title.
  • Set A Background Image: Turn it ON to hide the size of attachment.
  • Set A Background Image: Turn it ON to hide the type of attachment.
  • Hide Download Counter: Turn it ON to hide total downloaded amount of attachment.
  • Deactivate Force Download: Turn it ON to display attachment in new window.
  • Hide File Type Icon: Turn it ON to hide attachment type icon.
doc_img

About Block Settings:

Plugin provides all the required options to customize the Attachment tab according to your requirements. Here goes the detail of all options.

doc_img
  • Attachment Tab Title: You can add custom title of Attachment Tab. Default: Attachment
  • Attachment Tab Position: Plugin allows you to set the attachment tab in a convenient position. For example, use a small number (1,2 or 3) to set tab at the First position and set big number(100, 200, 300) to display attachment tab at the last position.
  • Hide Tab Automatically: Turn this option ON and plugin will hide the Attachment Tab automatically, if there is no file available to download for any product.
  • Display Attachment Counter: Total number of attachment will display beside the Tab title.
  • Hide File Size: Turn it ON to hide the size of attachment.
  • Hide File Type: Turn it ON to hide the type of attachment.
  • Hide Download Counter: Turn it ON to hide total downloaded amount of attachment.
  • Deactivate Force Download: Turn it ON to display attachment in new window.
  • Hide File Type Icon: Turn it ON to hide attachment type icon.
doc_img

Send To Block Settings:

Plugin provides all the required options to customize the Attachment tab according to your requirements. Here goes the detail of all options.

doc_img
  • Attachment Tab Title: You can add custom title of Attachment Tab. Default: Attachment
  • Attachment Tab Position: Plugin allows you to set the attachment tab in a convenient position. For example, use a small number (1,2 or 3) to set tab at the First position and set big number(100, 200, 300) to display attachment tab at the last position.
  • Hide Tab Automatically: Turn this option ON and plugin will hide the Attachment Tab automatically, if there is no file available to download for any product.
  • Display Attachment Counter: Total number of attachment will display beside the Tab title.
  • Hide File Size: Turn it ON to hide the size of attachment.
  • Hide File Type: Turn it ON to hide the type of attachment.
  • Hide Download Counter: Turn it ON to hide total downloaded amount of attachment.
  • Deactivate Force Download: Turn it ON to display attachment in new window.
  • Hide File Type Icon: Turn it ON to hide attachment type icon.
doc_img

Letter Block Settings:

Plugin provides all the required options to customize the Attachment tab according to your requirements. Here goes the detail of all options.

doc_img
  • Attachment Tab Title: You can add custom title of Attachment Tab. Default: Attachment
  • Attachment Tab Position: Plugin allows you to set the attachment tab in a convenient position. For example, use a small number (1,2 or 3) to set tab at the First position and set big number(100, 200, 300) to display attachment tab at the last position.
  • Hide Tab Automatically: Turn this option ON and plugin will hide the Attachment Tab automatically, if there is no file available to download for any product.
  • Display Attachment Counter: Total number of attachment will display beside the Tab title.
  • Hide File Size: Turn it ON to hide the size of attachment.
  • Hide File Type: Turn it ON to hide the type of attachment.
  • Hide Download Counter: Turn it ON to hide total downloaded amount of attachment.
  • Deactivate Force Download: Turn it ON to display attachment in new window.
  • Hide File Type Icon: Turn it ON to hide attachment type icon.
doc_img

Sign & Result Block Settings:

Plugin provides all the required options to customize the Attachment tab according to your requirements. Here goes the detail of all options.

  • Attachment Tab Title: You can add custom title of Attachment Tab. Default: Attachment
  • Attachment Tab Position: Plugin allows you to set the attachment tab in a convenient position. For example, use a small number (1,2 or 3) to set tab at the First position and set big number(100, 200, 300) to display attachment tab at the last position.
  • Hide Tab Automatically: Turn this option ON and plugin will hide the Attachment Tab automatically, if there is no file available to download for any product.
  • Display Attachment Counter: Total number of attachment will display beside the Tab title.
  • Hide File Size: Turn it ON to hide the size of attachment.
  • Hide File Type: Turn it ON to hide the type of attachment.
  • Hide Download Counter: Turn it ON to hide total downloaded amount of attachment.
  • Deactivate Force Download: Turn it ON to display attachment in new window.
  • Hide File Type Icon: Turn it ON to hide attachment type icon.
doc_img

Share Block Settings:

Plugin provides all the required options to customize the Attachment tab according to your requirements. Here goes the detail of all options.

  • Attachment Tab Title: You can add custom title of Attachment Tab. Default: Attachment
  • Attachment Tab Position: Plugin allows you to set the attachment tab in a convenient position. For example, use a small number (1,2 or 3) to set tab at the First position and set big number(100, 200, 300) to display attachment tab at the last position.
  • Hide Tab Automatically: Turn this option ON and plugin will hide the Attachment Tab automatically, if there is no file available to download for any product.
  • Display Attachment Counter: Total number of attachment will display beside the Tab title.
  • Hide File Size: Turn it ON to hide the size of attachment.
  • Hide File Type: Turn it ON to hide the type of attachment.
  • Hide Download Counter: Turn it ON to hide total downloaded amount of attachment.
  • Deactivate Force Download: Turn it ON to display attachment in new window.
  • Hide File Type Icon: Turn it ON to hide attachment type icon.
doc_img

Advanced Settings:

Plugin provides all the required options to customize the Attachment tab according to your requirements. Here goes the detail of all options.

  • Attachment Tab Title: You can add custom title of Attachment Tab. Default: Attachment
  • Attachment Tab Position: Plugin allows you to set the attachment tab in a convenient position. For example, use a small number (1,2 or 3) to set tab at the First position and set big number(100, 200, 300) to display attachment tab at the last position.
  • Hide Tab Automatically: Turn this option ON and plugin will hide the Attachment Tab automatically, if there is no file available to download for any product.
  • Display Attachment Counter: Total number of attachment will display beside the Tab title.
  • Hide File Size: Turn it ON to hide the size of attachment.
  • Hide File Type: Turn it ON to hide the type of attachment.
  • Hide Download Counter: Turn it ON to hide total downloaded amount of attachment.
  • Deactivate Force Download: Turn it ON to display attachment in new window.
  • Hide File Type Icon: Turn it ON to hide attachment type icon.
doc_img

Plugin Filters:

From the version 1.0.8, plugin introduced filter feature. It allows you to add/change plugin deafult texts and apply your own content. Moreover, you will not loose your modified text upon update the plugin files.

How to Use Filter:

To apply filter on the plugin texts, please follow the steps described in below properly.

Step 01: Go to wp-content/themes/your-theme/functions.php file, and open it.

Step 02: Now, we want to modify the default no-reply email address. So, we will use bptm_sender_no_reply_email filter that will set the no-reply email address.

Step 03: Next, add the following lines of code in the functions.php file and save the file. 


add_filter('bptm_sender_no_reply_email', 'cb_bptm_sender_no_reply_email');

function cb_bptm_sender_no_reply_email( $content ) {
    
    return 'no-reply@bluewindlab.net';
    
}

Plugin All Filters:

  • bptm_sender_no_reply_email

    applied to the no reply sender email address of sign form. Default: no-reply@site.com

  • bptm_sign_err_msg

    applied to the sign form required field error message. Default: One or more fields have an error.

  • bptm_sign_thanks_msg

    applied to the sign form required field thank you message. Default: Thanks for your sign!

Support & Miscellaneous

Petitions Manager WordPress Plugin comes with Six (06) months of premium support directly from the developer. We are committed to assisting our buyers, and most of the time, it takes less than 24 hours to reply to the support message. If you face any particular issue regarding the plugin, the developer will assist you in fixing the problem.

Plugin Translation

Petitions Manager WordPress Plugin Documentation WordPress Plugin offers cool translation feature. So, beside the English language, you can easily translate the plugin texts for other languages too. Check following steps to translate Petitions Manager WordPress Plugin Documentation WordPress plugin.

Step 01: To translate the plugin texts, please download and install Poedit software in your computer. Here goes the download link- https://poedit.net/download

Step 02: Next, navigate to /wp-content/plugins/petitions-manager/lang/. You will get a file named default.po.

Step 03: Our Plugin text-domain is 'bwl_ptmn'. Now, we want to translate our theme text in to Dutch language. So, copy default.po file and rename it as bwl_ptmn-de_DE.po

Step 04: Now, open that newly created 'bwl_ptmn-de_DE.po' file using Poedit software. You will get all the plugin texts in there and you just need to add appropriate translated text in Translation box.

Step 05: Finally, save the file and you will get 'bwl_ptmn-de_DE.mo' file inside languages folder.

Note:

Not sure about country and language code? Get your Country Code and Language code.

FAQ & Troubleshooting

Upgrade Notes

Important Note:

If you modified any files of plugin, please take a backup before update all files and folder. We highly recommend to take backup of language files.

Upgrading from 1.0.6 to 1.0.7

  • Replace all files and directories in your plugins/petitions-manager folder.

Change Log

2020, January, 17 - v 1.0.8
- Added: Users sign verification option.
- Added: Manual sign insert option.
- Added: Customizable email template option.
- Added: Email default text filter option.
- Updated: Plugin Options Panel.
- Updated: Plugin language file.
- Updated: Plugin documentation.

2020, January, 20 - v 1.0.7
- Added: Petition form fields customization option.
- Updated: Plugin Options Panel.
- Updated: Plugin language file.
- Updated: Plugin documentation.

Source & Credit Notes

  1. jQuery Plugin
  2. Font Awesome
Back To Top