Anton Voytenko

<p><a href="https://getpetitioner.com" rel="nofollow ugc">Plugin homepage & demo</a>.<br />
<a href="https://getpetitioner.com/docs/" rel="nofollow ugc">Documentation</a>.<br />
Petitioner is a WordPress plugin that allows you to create petitions and send them to the target email.</p>
<h3>Features:</h3>
<p><strong>Unlimited petitions</strong><br />
Create and manage an unlimited number of petitions.</p>
<p><strong>Drag and drop form builder</strong><br />
– Add/remove/reorder fields based on your needs<br />
– Add rich text to the form for disclaimers and legal text<br />
– Edit field’s label, placeholder, and required state</p>
<p><strong>Control submission behaviour</strong><br />
– Show submissions on the frontend in a few different styles<br />
– Email functionality: Automatically send petition letters to representatives via email.<br />
– Ability to store submissions without sending emails to the rep.<br />
– Ability to manually approve/deny petitions and set the default approval behavior (approved by default or declined)<br />
– Option to confirm emails via email<br />
– Customize email confirmations, petition letters, and thank you emails<br />
– Option to edit and delete submissions<br />
– Form submissions export: Export petition signups and submission data to a CSV file for easy reporting.</p>
<p><strong>Design & layout features</strong><br />
– The plugin features a modern, mobile-friendly design for a seamless user experience.<br />
– Color customizations & custom CSS options<br />
– WYSIWYG editor: Easily edit petition letters and confirmation emails using a modern WYSIWYG editor.<br />
– Gutenberg integration with a custom petition block!<br />
– Several shortcodes to take your petitions to the next level<br />
– – Form shortcode<br />
– – Petition goal #<br />
– – Progress bar<br />
– – Petition letter popup<br />
– – Current submission count<br />
– – Submissions in multiple styles and configurations</p>
<p><strong>Spam protection features</strong><br />
– Captcha integrations: reCAPTCHA, hCaptcha, and Cloudflare Turnstile<br />
– Akismet integration – handle spam seamlessly without adding any js libraries<br />
– Honeypot field<br />
– Email confirmations<br />
– Compatible with all of the popular SMTP plugins (uses wp_mail behind the scenes)</p>
<h3>Development and Source Code</h3>
<p>The source code for this plugin is publicly available on GitHub:<br />
<a href="https://github.com/avoy18/petitioner" rel="nofollow ugc">https://github.com/avoy18/petitioner</a></p>


Petitioner

Create and manage petitions with Petitioner, send them to the target email, and export submissions to CSV.

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.

Petitioner vs We The People