Description

When visitors to your site submit the petition form, a copy of your message will be sent to the email address you selected. The petition message will be signed with the contact information provided by the form submitter. After signing the petition, visitors will have the option of sharing your petition page with their followers on Facebook or Twitter.

Signatures are stored in the database and can be easily exported to CSV format for further analysis. You may set a goal for the number of signatures you hope to collect and then watch as a progress bar tracks your petition’s advance toward it’s goal. Petitions may also be configured to stop accepting new signatures on a specified date.

Emailpetition Shortcode Attributes

The following attributes may be applied when using the [emailpetition] shortcode

id

The ID number of your petition (required). To display a basic petition, use this format:
[emailpetition id=”1″]

width

This sets the width of the wrapper <div> that surrounds the petition form. Format as you would a width rule for any standard CSS selector. Values can be denominated in px, pt, em, % etc. The units marker (px, %) must be included.

To set the petition from to display at 100% of it’s container, use:
[emailpetition id=”1″ width=”100%”]

A petition set to display at 500 pixels wide can be achieved using:
[emailpetition id=”1″ width=”500px”]

height

This sets the height of the petition message box (rather than the height of the entire form). Format as you would a height rule for any standard CSS selector. Values can be denominated in px, pt, em, % etc. The units marker (px, %) must be included.

A few notes on using percentages:
Using a % value only works when the “Allow custom messages” feature is turned off—because the petition message will be displayed in a <div>. When “Allow custom messages” is turned on, the petition message is displayed in a <textarea>, which cannot be styled with % heights. Use px to set the height on petitions that allow message customization.

To set the message box to scale to 100% of the height of the message it contains, use any % value (setting this to 100%, 0%, 200% or any other % value has the same result). Use px if you want the box to scale to a specific height.

progresswidth

Sets the width of the outer progress bar. The filled area of the progress bar will automatically scale proportionally with the width of the outer prgress bar. Provide a numeric value in pixels only. Do not include the px unit marker.

class

Adds an arbitrary class name to the wrapper <div> that surrounds the petition form. Typically used to assign the alignright, alignleft or aligncenter classes to the petition in order to float the petition form to one side of its container. To assign multiple classes, separate the class names with spaces.

Installation

Activate SpeakUp! Email Petitions through the “Plugins” menu in the WordPress admin.

FAQ

How do I create a new petition

Select “Add New” from the “Email Petitions” menu.

Complete the “Add New Email Petition” form with the options you desire and save your petition by clicking the “Create Petition” button.

Enter the petition’s shortcode into any page or post where you want the petition form to appear. Example:
[emailpetition id=”1″]

Can I display the petition as a widget?

Yes. Once you’ve created a petition, go to the Widgets screen and drag the “SpeakUp! Email Petitions” widget into a sidebar. In the widget’s options, enter a Title and a Call to Action and then select the petition you wish to display.

Why are some people not receiving the confirmation emails?

Some email services (like AOL, Hotmail, and a few others) do not accept mail sent from the PHP mail() function. So, people who sign your petition with an email address from one of these providers may not be able to receive a confirmation email. To get around this problem, try installing the WP Mail SMTP plugin which will redirect calls to the PHP mail() function through your webserver’s SMTP configuration.

How can I create a custom style for the petition form?

First, select “None” as your theme on the Settings screen. Then add a petition.css file to your theme folder. You can use the styles included in the plugin’s CSS folder as a starting point for your custom theme — just copy the contents of theme-standard.css or theme-basic.css into your petition.css file and make any modifications you desire.

Custom styles can also be created for the widget and signaturelists by adding petition-widget.css or petition-signaturelist.css to your theme and changing the theme for these items to “None”.

The First Name, Last Name or Email fields in the petition form display the name and email of the site administrator. What’s going on?

These fields are filled automatically for logged-in users. You are seeing the name and email info associated with your user account. Other users will see their own information in these fields. Or, if the user is not logged-in, the fields will be empty.

Is there a way to confirm a user’s email address when they sign a petition?

Yes. Simply select “Confirm signatures” when creating a petition and a confirmation email will be sent to the address used to sign the petition. By clicking the link in the confirmation email, the signer can confirm their email address. The petition message will not be sent until the signer’s email address is confirmed.

Can I run a petition without having it send email?

Yes. when you create a new petition, simply select the checkbox labelled “Do not send email (only collect signatures)” at the top of the Petition box and email will not be sent out when the petition is signed.

Is there a way to publicly display the names of people who have signed my petition?

Yes, simply place the signaturelist shortcode wherever you want the list to appear in your post (be sure to set the id value to match the id number of your petition). Example:
[signaturelist id=”1″]

Can I download a list of my petition’s signatures?

Yes. To download the signatures in CSV format, click the “Download as CSV” button at the top of the Signatures screen. If you do not see a “Download as CSV” button on this screen, you will first need to select yuor petition from the drop-down list.

I downloaded the CSV file, but when I open it in a spreadsheet application, the values aren’t in the correct columns. Can I fix this?

If the CSV file looks scrambled, try changing its filename extension from .csv to .txt and then re-opening it in your spreadsheet app. The columns should be arranged correctly. (If you wish to keep the .csv extension, once you’ve opened the .txt file, re-save it as a CSV from your spreadsheet app, which will structure the contents of the file in a version of the CSV format that it understands.)

Reviews

Instead to send the email confirmation to the user (signer),the message “thank you” is sent to the original email set in petition.I have tested many times,all the messages are collected in one email (the original),users (signers) dont receive anything,even to confirm their signature.