Available shortcodes
Petitioner comes with a few useful shortcodes to help you get the most out of the plugin. Here they are:
petitioner-form
Renders the full petition form for users to fill out and submit. Place inside a page or post where you want the form displayed.
Attributes:
- id (required): The ID of the petition form.
Usage:
[petitioner-form id="123"]petitioner-goal
Displays the goal number (target signatures) for a specific petition form.
Attributes:
- id (required): The ID of the petition form.
Usage:
[petitioner-goal id="123"]petitioner-submission-count
Displays the current number of submissions (signatures) for a specific petition form.
Attributes:
- id (required): The ID of the petition form.
Usage:
[petitioner-submission-count id="123"]petitioner-goal-progress-ui
Displays a visual progress UI showing how many signatures have been collected compared to the goal.
Attributes:
- id (required): The ID of the petition form.
Usage:
[petitioner-goal-progress-ui id="123"]Notes:
- Outputs a div with class “petitioner” containing the progress bar.
petitioner-letter-modal-ui
Displays a button that opens a modal window showing the letter associated with the petition.
Attributes:
- id (required): The ID of the petition form.
Usage:
[petitioner-letter-modal-ui id="123"]petitioner-submissions
Displays submissions on the frontend.
Attributes:
- id (required): The ID of the petition form.
- per_page (optional): how many submissions to show per page
- include (optional): what fields to include
- style (optional): which style to use, “simple” or “table”
Usage:
[petitioner-submissions id="123" show_pagination="true" style="simple" per_page="30" include="name,country,submitted_at"]