Sharraxaad

Plugin homepage & demo.
Documentation.
Petitioner is a WordPress plugin that allows you to create petitions and send them to the target email.

Features:

Unlimited petitions
Create and manage an unlimited number of petitions.

Drag and drop form builder
– Add/remove/reorder fields based on your needs
– Add rich text to the form for disclaimers and legal text
– Edit field’s label, placeholder, and required state

Control submission behaviour
– Show submissions on the frontend in a few different styles
– Email functionality: Automatically send petition letters to representatives via email.
– Ability to store submissions without sending emails to the rep.
– Ability to manually approve/deny petitions and set the default approval behavior (approved by default or declined)
– Option to confirm emails via email
– Customize email confirmations, petition letters, and thank you emails
– Option to edit and delete submissions
– Form submissions export: Export petition signups and submission data to a CSV file for easy reporting.

Design & layout features
– The plugin features a modern, mobile-friendly design for a seamless user experience.
– Color customizations & custom CSS options
– WYSIWYG editor: Easily edit petition letters and confirmation emails using a modern WYSIWYG editor.
– Gutenberg integration with a custom petition block!
– Several shortcodes to take your petitions to the next level
– – Form shortcode
– – Petition goal #
– – Progress bar
– – Petition letter popup
– – Current submission count
– – Submissions in multiple styles and configurations

Spam protection features
– Captcha integrations: reCAPTCHA, hCaptcha, and Cloudflare Turnstile
– Akismet integration – handle spam seamlessly without adding any js libraries
– Honeypot field
– Email confirmations
– Compatible with all of the popular SMTP plugins (uses wp_mail behind the scenes)

Development and Source Code

The source code for this plugin is publicly available on GitHub:
https://github.com/avoy18/petitioner

Sawir-shaashado

Petition on the frontend
Petition letter (frontend)
Gutenberg block
Edit page
Form builder
Advanced settings
Submissions
Settings
Integrations

Xayndaabyo

Kaabahani wuxuu bixinaya 2 xayndaab.

Petitioner Form A form for collecting petitions
Petitioner Submissions Displays submissions for a petition

SBI

How do I show the petition on my website?: Create your first petition under Petitioner -> Add new. Once you do that, you can either use a shortcode provided on the creation page or a Gutenberg block.
How do I customize the styles?: You can customize your petitions under Petitioner -> Settings. You can change the colors, conditionally display certain fields, and add custom CSS.
How do I see and export the submissions?: Simply open the edit page for the petition in question and you will see a table with all of the submissions. There will also be a button to export.
Can I request features?: Absolutely! Feel free to reach out through this contact form
What if I have more questions?: You can find a more extensive FAQ on the main website. Additionally, yu can reach out to me via this contact form

Dibu-eegisyo

tshakra 3 Agoosto, 2025 1 reply

thank you very much for your ultra fast and friendly support !

hdavelaar 7 Luulyo, 2025 1 reply

We recently added the Petitioner plugin to our website and are very happy with the results. The plugin is easy to use and straightforward to customize. One of the standout features is that you can easily translate all texts into your own language (In our case Dutch) ensuring a seamless experience for your website visitors. You can set a target number of signatures and display the progress dynamically, which really helps to engage supporters. In our experience, Petitioner is more user-friendly and versatile than SpeakOut. Highly recommended!

Akhri dhammaan 2 dibu-eegis

Ka-qaybgalayaasha & Horumariyayaasha

“Petitioner” waa softiweer il furan. Dadka soo socda ayaa wax ku biiriyay kaabahan.

Anton Voytenko

“Petitioner” waxaa lagu tarjumay 1 luqad. Way ku mahadsan yihiin turjumaannada ka-qaybqaadashadooda.

Ku tarjun “Petitioner” luqaddaada.

Ma xiisaynaysaa horumarinta?

Baadh koodka, fiiri bakhaarka SVN, ama iska qor diiwaanka horumarinta adigoo adeegsanaya RSS.

Isbeddellada

0.6.2

Allow passing images to the petition letter
Fix relative paths on images in the email templates
Allow displaying date of birth on submissions

0.6.1

Allow passing images to the WYSIWYG editor
New field: Date of Birth
Fix a bug with “Confirmed” DB value being translatable

0.6.0

Improved submissions
- Added sorting of submissions in admin
- Added ability to edit and delete submissions
Tabs now remember the state on refresh
Improved the code structure overall

0.5.3

Add a new “From name” field that allows you to customize the sender name in outgoing emails, overriding the default email format to display your preferred sender name.
Bugfix: fixed missing default from name if you don’t pass anything at all

0.5.2

Bug: fixed an issue with making checkboxed checked by default
Bug: fixed placeholders not working
Allow passing html values in labels safely

0.5.1

Bug: remove double escaping of html attributes on the form

0.5.0

New comment textarea field
Allow showing the progress bar via a shortcode even if it’s disabled in the general settings
Additional display options on the submission component, you can now show more fields. Improved the block controls and also how it handles empty values.
Bug: fixed the issue with form builder not reordering in some cases

0.4.6

Add option to edit all of the labels via the plugin settings

0.4.5

Make signee’s BCC disabled by default
Add a new filter: av_petitioner_mailer_settings

0.4.4

Add option to render submissions on the frontend
- Add a new shortcode:
  - [petitioner-submissions id="{form id}" style="{simple or table}" per_page="{number of entries per page}" show_pagination="{true or false}"]
- Add multiple styles and configurations
- Allow hiding last names through petition settings

0.4.3

Editing labels:
- Added UI for editing the thank you message on the petition (shows up after you submit the form)
- Added a filter to override other random strings
Code refactoring: made some changes to the structure
Minor UI tweaks:
- You can now close the popup with an ESC key
- Added explicit color to the close button to fix styling for some users

0.4.2

Bugfix: add the new fields to the CSV export

0.4.1

Bugfix: Ensure plugin version is always set in the database and automatically re-run database migrations if missing or old

0.4.0

Brand new drag and drop form builder
- Add/remove/reorder the form fields
- Automatic migration from the old editing experience
- Edit individual field settings
- Add rich text to the form
- Add new optional fields
Moved admin js to typescript
Add basic testing
Bug fixes: fixing the bug with the nonce field not validating on some environments

0.3.4

Bugfix: fix an occasional error related to unnecessary nonce sanitization

0.3.3

Submissions tab improvements, special thanks to @Shahraz98
- Add ability to resend confirmation emails
- Add a button to resend all confirmation emails at once (please use this with caution)
- Refactored the code & improved the submissions UI
Fix a bug with the export button
Fix a bug with the wrong number on the submission count when the confirmation behavious is auto-denied by default
Fix a minor bug with the textdomain loading too early
Add basic translations to French, Ukrainian, Russian, and Dutch

0.3.2

Bug fixes:
- Fix a bug with hCaptcha breaking forms on Firefox, special thanks to @Shahraz98
- Fix the recaptcha code running when recaptcha is used by another plugin

0.3.1

Add custom javascript event – petitionerFormSubmit
Improve readme to highlight the latest features

0.3.0

Spam protection improvements:
- Add a honeypot option for additional spam protection
- Akismet integration – handle spam seamlessly without adding any js libraries
- Integrate with Cloudflare Turnstile – a privacy first captcha
Create custom filters (petitioner_send_ty_email, petitioner_send_to_representative, petitioner_after_submission, petitioner_get_styled_message)
New shortcodes (petitioner-goal, petitioner-submission-count, petitioner-goal-progress-ui, petitioner-letter-modal-ui)
Bug fixes and UI improvements
- Better style emails visually
- Allow overriding the “from” field
- A new and improved settings page
- Add better DB schema handling
- Fix a bug with confirmed emails not sending letters to the rep
Add a translation template

0.2.6

Fix export button not showing up
Fix custom CSS not applying with custom colors
Add confirmation emails

0.2.5

Allow editing confirmation emails

0.2.4

Bug fixes after the previous release

0.2.3

Add Google reCAPTCHA and hCaptcha
Allow multiple target emails
Add optional legal disclaimer & consent checkbox
Refactor & organize editor UI

0.2.2

Added the ability to approve/deny petitions
Reworked the edit fields & submissions UI

0.2.0

Added the country field
Improved checkbox styles
Added color customizer to the settings page

0.1.4

Improved readme & docs
Improved asset enqueuing
Fixed internalization issues
Improved plugin escaping and sanitization

0.1.3

New plugin settings page

0.1.2

New Gutenberg block

0.1.1

Added more sanitization and preparing for the wp.org upload

0.1.0

Initial version of the plugin