Forms Pro
A drag-and-drop form builder for Grav 2.0 inside Admin Next, with multi-step forms, conditional logic, calculators, notifications, webhooks and entries, saved as ordinary Form plugin YAML.
Forms Pro is a visual form builder that runs inside Admin Next. You build a form by dragging fields onto a canvas, set what happens when it is sent, and place it on any page with a shortcode, a Twig function or a page header. Each form is saved as one YAML file in the format the Form plugin already reads, so every Form plugin feature (validation, nonces, file uploads, process actions) keeps working underneath, and a form you edit by hand opens in the builder without losing anything.
Important
Premium products require the free License Manager plugin. Install it and add your product license before installing Forms Pro.
Requirements
| Requirement | Notes |
|---|---|
Grav >= 2.0.4 |
Forms Pro is not compatible with Grav 1.7 |
PHP >= 8.3 |
|
Form plugin >= 9.2.1 |
Processes every form and provides the captcha providers |
Email plugin >= 5.0.1 |
Sends notifications and the Send Email action |
API plugin >= 1.0.8 |
Powers the builder and the REST API |
Admin Next (admin2) >= 2.0.11 |
Where you build forms and read entries |
The shortcode also needs the Shortcode Core plugin. Without it you can still embed a form with the Twig function or a page header.
What's in the box
- A visual builder with a palette of 49 field types, nested layouts (columns, tabs, fieldsets, sections), inline editing of labels and options, undo and redo, and a property panel for every field.
- Eleven pro fields: name, address, phone, rating, slider, rich text, date picker, time picker, calculation, recipients and repeater.
- Multi-step forms with a progress bar, numbered circles or tabs, and a check on each step before the visitor moves on.
- Conditional logic: show or hide fields from rules, applied live in the browser and enforced again on the server.
- Calculations and calculator mode: fields that work out a value from a formula, and forms that are pure calculators and never submit.
- Actions and notifications: store entries, send several emails per form with merge tags and conditions, route mail to a recipient the visitor picks, call a webhook, redirect or show a message.
- Entries in Admin Next with search, filters, stars, notes, bulk actions, CSV and JSON export and file downloads.
- Spam protection with a honeypot and a challenge: a basic captcha, Google reCAPTCHA, Cloudflare Turnstile or Cap.
- A REST API and extension points, so scripts can manage forms and entries, and other plugins can add their own fields and actions.
Where to start
- Installation gets the plugin running and shows where forms and entries are stored.
- Getting started builds a contact form, puts it on a page and reads the first entry.
- The builder is the tour of the canvas, the palette and the property panel.
If you are building a calculator, go to Calculations and the Formula reference. If a form is not doing what you expect, start with Troubleshooting.
Installation
Install Forms Pro, check its requirements, see where forms and entries are stored and give your team the permissions they need.
Getting Started
Build a contact form, put it on a page, send a test message, read the entry and add an email notification.
The Builder
A tour of the Forms Pro builder in Admin Next - the forms list, the palette, canvas and property panel, nesting, undo and redo, and saving.
Field Reference
Every field in the Forms Pro palette - the keys all input fields share, the Form plugin's fields in brief, each Pro field in detail with the YAML it stores, and layout and system fields.
Multi-Step Forms
Split a long form into steps with a progress bar, numbered circles or tabs, and see how each step is checked before the visitor moves on.
Conditional Logic
Show or hide fields with rules in the Logic tab, applied live in the browser and enforced again on the server, with every operator and the YAML behind it.
Calculations
Calculation fields work out a value from other fields as visitors type. Learn the field's options, how results are rounded and stored, calculator mode, row calculations in a repeater and the formula editor.
Formula Reference
Every function, operator and rule of the Forms Pro formula language, with worked examples and a walk-through of converting a Calculated Fields Form calculator.
Actions and Notifications
What happens when a Forms Pro form is sent. Covers the Actions tab, every action, email notifications with merge tags, routing mail to a recipient the visitor picks, and sending a notification only when a condition is met.
Webhooks
Send each Forms Pro submission as JSON to another service. Covers the Webhook action's options, the payload, headers, the safety checks on the target address, timeouts, and what happens when a call fails.
Entries
Read, search, star, annotate, export and delete the submissions your Forms Pro forms collect. Covers the entries list, the entry panel, uploaded files, CSV and JSON export, and where entries are stored.
Settings Tab
The Settings tab of a Forms Pro form. Covers the title and description, calculator mode, the submit and reset buttons, error and validation behaviour, sending without a page reload, spam protection switches and the form's CSS classes.
Spam Protection
Keep bots out of Forms Pro forms with the honeypot and a challenge: Basic CAPTCHA, Google reCAPTCHA, Cloudflare Turnstile or Cap. Covers the Settings tab switch, the two halves every challenge needs, and where the keys go.
Embedding
Put a Forms Pro form on a page with the shortcode, a Twig function or a page header. Covers the Embed tab, the options of each method, several forms on one page, caching, and what a missing form looks like.
Permissions
Which accounts can see Forms Pro, build forms and read entries. Lists the four permissions and the parent key, what each allows in Admin Next and the REST API, and sample groups.
Translations
Translate Forms Pro into another language, and translate your own form labels, placeholders, options and messages. Covers the language block, where to put it, and which text visitors see in which language.
Configuration
The Forms Pro plugin settings in Admin Next and in user/config/plugins/forms-pro.yaml. Covers the built-in stylesheet, entry privacy options, the shortcode, the Call Function action, webhook limits and the storage folders.
Extending Forms Pro
Add your own field or action to Forms Pro from another Grav plugin. Covers the YAML manifest that puts it in the builder, the PHP class that runs an action, a field's Twig template, and the events for registering by code.
REST API
Read and manage Forms Pro forms and entries over HTTP. Covers authentication, the permission each endpoint needs, listing and filtering entries, updating entries, exports, file downloads, saving forms with ETags and the error format.
Troubleshooting
Fixes for the problems people meet with Forms Pro. A form that does not appear, entries or emails that do not arrive, uploads that fail, calculations that stay blank, webhooks that do not fire, and where to look in the log.