About Petitions Manager WordPress Plugin

  • Plugin Version: -
  • Recent Update: -
  • 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

To collect user petitions, you can easily display an external petition form. Please follow the steps listed below to display the petition.

Step 01 Login to the WordPress admin panel.

doc_img

Step 02 Navigate to Products > All Products.

doc_img

Step 03 Once the user fills up all the information, the plugin creates a new account for the user and sends login information to the user's email address. Later, User edit petition information by login their account. .

Step 04 Users can edit their petition information by logging into their account. Later, User edit petition information by login their account. .

doc_img

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 the Download Report button to get the full report in CSV format.

Remove petition data

Step 01 Navigate to Petitions >> Petition Report Section. Next, select the petition from Petitions drop down list.

doc_img

Step 02 Now, click on the Reset Data button.

doc_img

Step 03 You will see a confirmation window. Click the Ok button to reset the data.

doc_img

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 issues, contact me via the 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.1.3 to 1.1.4

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

Change Log

Source & Credit Notes

  1. jQuery Plugin
  2. Font Awesome
Back To Top