Kreg Wallace

<p>SpeakUp! Email Petitions allows you to easily create petition forms on your site.</p>
<p>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.</p>
<p>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.</p>
<h4>Localizations</h4>
<ul>
<li>Italian <strong>it_IT</strong> (<a href="https://wordpress.org/support/profile/macitaly">MacItaly</a>)</li>
<li>Slovenian <strong>sl_SI</strong> (<a href="http://ma-seo.com" rel="nofollow ugc">MA-SEO</a>)</li>
<li>German <strong>de_DE</strong> (Hannes Heller, Armin Vasilico, Andreas Kumlehn)</li>
<li>Russian <strong>ru_RU</strong> (<a href="te-st.ru" rel="nofollow ugc">Teplitsa</a>)</li>
<li>Dutch <strong>nl_NL</strong> (Kris Zanders)</li>
<li>Hebrew <strong>he_IL</strong> (Oren L)</li>
<li>Polish <strong>pl_PL</strong> (Damian Dzieduch)</li>
<li>Romanian <strong>ro_RO</strong> (<a href="http://webhostinggeeks.com" rel="nofollow ugc">Web Hosting Geeks</a>)</li>
<li>French <strong>fr_FR</strong></li>
<li>Spanish <strong>es_ES</strong></li>
</ul>
<p>The development version of this plugin is now on <a href="https://github.com/kregwallace/speakup-email-petitions" rel="nofollow ugc">GitHub</a>.</p>
<p>Visit the <a href="http://speakup.designkode.com/" rel="nofollow ugc">SpeakUp! Email Petitions website</a> to learn more.</p>
<h3>Emailpetition Shortcode Attributes</h3>
<p>The following attributes may be applied when using the <code>[emailpetition]</code> shortcode</p>
<h4>id</h4>
<p>The ID number of your petition (required). To display a basic petition, use this format:<br />
    [emailpetition id=”1″]</p>
<h4>width</h4>
<p>This sets the width of the wrapper <code><div></code> 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.</p>
<p>To set the petition from to display at 100% of it’s container, use:<br />
    [emailpetition id=”1″ width=”100%”]</p>
<p>A petition set to display at 500 pixels wide can be achieved using:<br />
    [emailpetition id=”1″ width=”500px”]</p>
<h4>height</h4>
<p>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.</p>
<p>A few notes on using percentages:<br />
Using a % value only works when the “Allow custom messages” feature is turned off—because the petition message will be displayed in a <code><div></code>. When “Allow custom messages” is turned on, the petition message is displayed in a <code><textarea></code>, which cannot be styled with % heights. Use px to set the height on petitions that allow message customization.</p>
<p>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.</p>
<p>Examples:<br />
    [emailpetition id=”1″ height=”500px”]<br />
    [emailpetition id=”1″ height=”100%”]</p>
<h4>progresswidth</h4>
<p>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.</p>
<p>To display the progress bar at 300 pixels wide, use:<br />
    [emailpetition id=”1″ progresswidth=”300″]</p>
<h4>class</h4>
<p>Adds an arbitrary class name to the wrapper <code><div></code> 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.</p>
<p>Examples:<br />
    [emailpetition id=”1″ class=”alignright”]<br />
    [emailpetition id=”1″ class=”style1 style2″]</p>
<h3>Signaturelist Shortcode Attributes</h3>
<h4>id</h4>
<p>The ID number of your petition (required). To display a basic signature list, use this format:<br />
    [signaturelist id=”1″]</p>
<h4>rows</h4>
<p>The number of signature rows to display in the table. This will override the default value provided on the Settings page. To display 10 rows, use:<br />
    [signaturelist id=”1″ rows=”10″]</p>
<h4>dateformat</h4>
<p>Format of values in the date column. Use any of the standard <a href="http://php.net/manual/en/function.date.php" rel="nofollow ugc">PHP date formating characters</a>. Default is ‘M d, Y’. A date such as “Sunday October 14, 2012 @ 9:42 am” can be displayed using:<br />
    [signaturelist id=”1″ dateformat=”l F d, Y @ g:i a”]</p>
<h4>prevbuttontext</h4>
<p>The text that displays in the previous signatures pagination button. Default is <.</p>
<h4>nextbuttontext</h4>
<p>The text that displays in the next signatures pagination button. Default is >.</p>
<h3>Signaturecount Shortcode</h3>
<p>Display the number (as text) of signatures collected for a given petition:</p>
<h4>id</h4>
<p>The ID number of your petition (required).<br />
    [signaturecount id=”3″]</p>


SpeakUp! Email Petitions

SpeakUp! Email Petitions makes it easy to add petitions to your website and rally your…

Steve Grunwell

Buckeye Interactive

<p>In May 2013 the White House released an API for We The People, a petition application designed to give citizens a direct line to the White House. The White House has committed to issue an official, public response to petitions that cross a particular signature threshold.</p>
<p>This plugin allows WordPress site owners to search and embed petitions from We The People into WordPress. Perhaps you’re writing an opinion piece on a petition and want real-time statistics on signatures and any response from the White House. Maybe you’re a supporter of a particular issue and want to feature it on your sidebar to help promote awareness. The ease of WordPress with the totally customizable templates of the We The People plugin give you the power to share what’s important to you.</p>
<h4>Special thanks</h4>
<p>Special thanks goes out to the White House web team for building and opening the We The People API for the general public and for inviting Buckeye Interactive to the National Day of Civic Hacking to premiere this plugin.</p>
<h3>Usage</h3>
<p>The plugin includes a number of different ways to embed petitions from We The People:</p>
<h4>Shortcodes</h4>
<p>The simplest way to get started is through WordPress shortcodes. The syntax is as easy as: <code>[wtp-petition id="123"]</code>.</p>
<p>Petitions IDs aren’t especially easy to uncover from the We The People site so the We The People plugin includes a TinyMCE button to help you. Clicking the  button will open an overlay that will let you search the We The People petitions by title to find your issue. You may also limit your search results to open petitions.</p>
<h4>Widget</h4>
<p>To add a We The People petition to a WordPress dynamic sidebar go to Appearance > Widgets and drag a “WTP Petition” widget into the desired sidebar. Like the TinyMCE button the widget allows you to search for your desired petition by title and show only open petitions.</p>
<h4>$GLOBALS[‘we-the-people’] global variable (advanced)</h4>
<p>If you’re a developer and need more complete access to the We The People API you can use the <code>api()</code> method available through the <code>$GLOBALS['we-the-people']</code> global variable. The <code>api()</code> method accepts two arguments: the API method to call (‘retrieve’ or ‘index’ in version 1.*) and an array of arguments to pass to the API.</p>
<p><strong>Note:</strong> Before version 2.0, the plugin used a global <code>$we_the_people</code> variable. If you did customizations to We The People templates you’ll want to be sure to update this reference.</p>
<p>Full API documentation is available <a href="https://petitions.whitehouse.gov/developers" rel="nofollow ugc">on the We The People API page</a>. More developer-oriented documentation can be found in <a href="https://github.com/buckii/we-the-people-wordpress" rel="nofollow ugc">this plugin’s GitHub repository</a>.</p>
<h4>Styling the petition display</h4>
<p>We The People has a built-in petition template but makes it easy to override in your theme. It may be easiest to copy templates/wtp-petition.php into your theme to get started but a very basic custom template might look something like this:</p>
<pre><code><div id="wtp-petition-<?php echo $petition->id; ?>" class="wtp-petition">
  <h2 class="petition-title"><?php echo $petition->title; ?></h2>
  <p>
    <strong><?php printf( __( '%d signatures.', 'my-theme' ), $petition->signaturesNeeded ); ?></strong>
    <a href="<?php echo $petition->url; ?>" title="<?php echo esc_attr( __( 'Sign this petition on We The People', 'we-the-people' ) ); ?>" class="sign-btn" rel="external"><?php _e( 'Sign this petition' ); ?></a>
  </p>
</div>
</code></pre>
<p>We The People uses the following order to determine which template to use when displaying a petition:</p>
<p><strong>Shortcodes:</strong></p>
<ol>
<li>wtp-petition-{id}.php (child theme)</li>
<li>wtp-petition.php (child theme)</li>
<li>wtp-petition-{id}.php (parent theme)</li>
<li>wtp-petition.php (parent theme)</li>
<li>templates/wtp-petition.php (plugin)</li>
</ol>
<p><strong>Widgets:</strong></p>
<ol>
<li>wtp-petition-widget-{id}.php (child theme)</li>
<li>wtp-petition-widget.php (child theme)</li>
<li>wtp-petition-widget-{id}.php (parent theme)</li>
<li>wtp-petition-widget.php (parent theme)</li>
<li>templates/wtp-petition-widget.php (plugin)</li>
</ol>

We The People

Easily embed White House petitions from We The People into your WordPress site via shortcodes and widgets.

SpeakUp! Email Petitions vs We The People