Forms Overview
How Protuno turns any HTML form inside a Proton widget into a managed form, with submission storage, email notifications, webhook delivery, and built-in spam protection.
Protuno's form system works on a simple idea: any HTML <form> element inside a Proton widget can become a fully managed form by adding a single attribute. No separate form plugin, no drag-and-drop form builder, no shortcodes. You write the form in HTML, add data-atom-form, and Protuno handles the rest.
How It Works
When Protuno sees a <form data-atom-form="key"> element on the page, it intercepts the form submission and routes it through its own secure processing endpoint. From that point, it can:
- Store the submission in your WordPress database, visible in Protuno → Form Submissions
- Send an email notification to one or more addresses with the submitted data
- Fire a webhook to a URL you specify, for CRM integrations, Zapier, Make, or any service that accepts POST data
These three actions, save_db, email, webhook, can be used independently or in any combination. Configuration happens in Protuno → Settings, not in the HTML, which means sensitive details like email addresses and webhook URLs are never exposed in the page source.
Security Built In
Every Protuno form gets two spam protections automatically, you do not need to configure them:
Nonce: A one-time token tied to the user's session is included in every form. The server verifies the nonce before processing any submission. This blocks CSRF attacks and prevents form submissions from outside your site.
Honeypot: A hidden field is added to every form that no real user can see or fill in. Bots that fill in all fields trigger the honeypot and are rejected silently. No CAPTCHA needed for basic spam protection.
What Gets Stored
For each form submission, Protuno captures:
| Field | What it stores |
|---|---|
| Form Name | The key you put in data-atom-form |
| Page | The URL of the page the form was submitted from |
The email address from the submission (if a field is named email) | |
| All Fields | Every named input field and its value |
| Status | Read or Unread |
| Submitted At | Date and time of submission |
The Form Submissions Dashboard
Go to Protuno → Form Submissions to view everything that has been submitted across all your forms. You can:
- Filter by form name
- Filter by read/unread status
- Open any submission to see the full field data
- Export to CSV
Supported Form Scenarios
| Scenario | Supported |
|---|---|
| Contact forms | Yes |
| Lead capture / newsletter signup | Yes |
| Multi-field data collection | Yes |
| File upload fields | Planned |
| Multi-step forms | Possible with JavaScript |
| WooCommerce checkout | No, use WooCommerce's own checkout |
Frequently Asked Questions
Do I need a separate form plugin to use Protuno forms? No. Protuno's form system is built into the plugin. You do not need Contact Form 7, WPForms, Gravity Forms, or any other form plugin to build and manage forms in Proton widgets.
Can I have multiple forms on the same page?
Yes. Each form has its own key (the value you put in data-atom-form). Multiple forms on the same page work independently.
Can I use forms in Theme Builder templates? Yes. A form in a Proton widget inside a header, footer, or any other template works exactly the same as a form on a regular page.
Are form emails sent through WordPress mail functions?
Yes. Email notifications use wp_mail(), which means they route through whatever mail configuration your WordPress site uses, including any SMTP plugin you have installed.