Form Reform Blocks
Forms are easy to build and arrange in Form Reform. You just add blocks to the page for each input. You can extend Form Reform with your own block templates or custom input blocks.
If you are wondering what all these blocks will look like on a page, check out The Kitchen Sink.
On this Page
Input control block types
Address Lookup Input
Address Lookup input for Form Reform.
Detailed data from the address lookup will also be returned in a hidden field as JSON. This data will be available to the processing pipeline as {{place.holders}} using dot.notation to index into the data. When not provided, fallback actions may attempt to partially fill the data by parsing the entered text.
A map of address lookup data to other form input fields can be configured to automatically populate further fields in the form. Any specific address will resolve to a subset of these fields. Accuracy and provision depends on data from Google.
- Street Number [street_number]
- Route / Road [route]
- Address 1 [address1]
- Address 2 [address2]
- Town / City [town]
- State code [sc]
- State [state]
- Postal code / Zip [postal_code]
- Postal code prefix [postal_code_prefix]
- Postal code suffix [postal_code_suffix]
- Country code [cc]
- Country [country]
- Latitude [latitude]
- Longitude [longitude]
- Formatted Addr [formatted]
Options Attribute Checkbox List Input
Checkbox list from Options Attribute values for Form Reform.
Options Attribute Radioset Input
Radioset from Options Attribute values for Form Reform.
Options Attribute Select Input
Dropdown select from Options Attribute values for Form Reform.
Calendar Picker Input
Calendar picker input for Form Reform. Provides picking one or more events, days or other calendar items from a calendar by superimposing checkboxes to the calendar cells.
Because form data is returned as an array of event occurrences, the data straight from the form can be awkward to insert into messages using {{data_values}}. Consider using IterateData ... ExtendWithTextItem ... IterateDataEnd handlers, even if only one event is picked. The ExtendWithTextItem handler can then be used to incrementally extend a text string by building the formatted content of each event.
Use Form Reform Developer to dump data from the pipeline and understand the form and iteration data.
Checkbox Input
Checkbox input for Form Reform.
Checkbox List Input
Checkbox List input for Form Reform. The default view is for Bootstrap5. Set the bootstrap3_elemental or a custom template for other themes.
Checkbox List Combi Input
Checkbox List Combi input for Form Reform. The default view is for Bootstrap5. Set the bootstrap3_elemental or a custom template for other themes.
Checkbox Matrix Input
Checkbox Matrix input for Form Reform. Build a table of checkbox inputs.
Checkbox + Message Input
Checkbox input with associated rich text message for Form Reform.
Color Picker Input
Color picker input for Form Reform.
Continent Input
Continent input for Form Reform.
An Attach After Submit block template can be used with the Geolocation option to render nothing to the form and attach a geolocated continent after the form is submitted.
Country Input
Country input for Form Reform.
An Attach After Submit block template can be used with the Geolocation option to render nothing to the form and attach a geolocated country after the form is submitted.
Country State Input
Country State input for Form Reform.
An Attach After Submit block template can be used with the Geolocation option to render nothing to the form and attach a geolocated country and state/province after the form is submitted.
Custom Text Input
Text input with custom validation for Form Reform
An optional regular expression will be applied in the browser to restrict the entered text and after form submission to validate text on the server. The regular expression will be automatically wrapped in /^ ... $/ where necessary for evaluation. The regular expression must be valid for both JavaScript and PHP.
Optional further validation after submission can be specified by providing the name of a validation class. The validation class should provide a method
class_name->validate($text) which returns true/false. For testing, the class JtF\FormReform\Examples\CustomValidate will fail any text containing X.Minimum and maximum input lengths are also configurable.
Date Input
Date input for Form Reform.
DateTime Input
DateTime input for Form Reform.
Email Input
Email input for Form Reform.
Email Confirm Input
Email Confirm input for Form Reform. Two email inputs are validated to match.
Grouped Select Input
Select input for Form Reform with groups of options.
Handle Input
Handle input for Form Reform.
Handle with Dot Input
Handle with dots input for Form Reform.
ID Code Input
ID Code input for Form Reform.
The Generate ID Code form handler can be used to generate and ID code for subsequent validation. This ID code will need to be communicated to the user, for example through a Message form handler or a Send Email form handler.
On a subsequent form, the user can then enter the code into a Form Reform ID Code input block. The Form Reform ID Code input block can then be validated with the Valid Input Fields form handler or with the Validate ID Code form handler. The first is enabled for automatic validation in the Validation tab of the Form Reform ID Code input block. The alternative using the Validate ID Code form handler facilitates greater flexibility of subsequent processing.
Image Picker Input
Image picker input for Form Reform. Provides dragging images from an Omni Gallery with the capability to be configured to drag images from other galleries and sliders.
JSON as Select Input
Derive a select dropdown or nested select dropdown from JSON data.
Latitude / Longitude Input
Latitude or Longitude input for Form Reform.
Like Input
Like input for Form Reform.
Lowercase Input
Lowercase input for Form Reform.
Masked Text Input
Masked Text input for Form Reform.
Mask formatting characters:
- 9 - A decimal digit
- A - An letter
- * - A letter or decimal digit
Format characters other than the mask character will be included with the form field in the processing pipeline. Unmasked data is provided as the Input Name suffixed "_unmasked".
Minimum and maximum input lengths are also configurable. When specified, the maximum length must include the placeholder characters in the mask.
Number Input
Number input for Form Reform.
Numeric Digits Input
Numeric digits input for Form Reform.
Package Checkbox List Input
Checkbox list from Packages for Form Reform.
Package Radioset Input
Radioset from Packages for Form Reform.
Package Select Input
Dropdown select from Packages for Form Reform.
Password Input
Password input for Form Reform. For entering a password. Use "Password Confirm" for setting a password.
Password Confirm Input
Password Confirm input for Form Reform. Two passwords are validated to match.
Radio Matrix Input
Radio Matrix input for Form Reform. Build a table of radio options.
Radioset Input
Radioset input for Form Reform. The default view is for Bootstrap5. Set the bootstrap3_elemental or a custom template for other themes.
Radioset Combi Input
Radioset Combi input for Form Reform. The default view is for Bootstrap5. Set the bootstrap3_elemental or a custom template for other themes.
Range Input
Range input for Form Reform.
Rating Input
Rating input for Form Reform.
Result Picker Input
Result picker input for Form Reform. Provides picking one or more previous form submissions from a list presented by Form Reform Display, Reviews or other compatible lists.
Rich Text Input
Rich text input for Form Reform.
Whilst the rich text editor has many options, you should keep the edit controls presented to your visitors to the minimum necessary for your forms. This form control is not a word processor. Allowing images, links, tables, fonts etc. will require you to work out how these options integrate with your theme. Use of such options is not supported with Form Reform.
Select Input
Select input for Form Reform.
Select Combi Input
Select Combi input for Form Reform.
Signature Input
Signature input for Form Reform.
Whilst the the Initial Value can be set to persist a previously entered signature, for security we recommend a signature is not persisted beyond the current form submission.
When persisted a signature may not be edited, but may be cleared and re-entered if a clear button is enabled.
The signature may be saved as base64 data with the form submission. Form save handlers may be configured to redact the signature field from form data. The signature image is not added as an image in the file manager.
To use a signature, such as in an email or message, insert an html image <img src="{{form:my_signature_field}}">.
Drag & Drop File Input
Drag & Drop file upload input for Form Reform.
Files are first uploaded into a quarantine folder, then added to their final File Manager location following a successful form submission.
The Snapshot Drag & Drop Uploader provides an enhanced uploader where users can edit file title and description and even edit and annotate png and jpeg images before uploading. Uploadable file types can be configured by file extension and are not limited to just image files, any configured file type can be uploaded.
Screengrab File Input
Screengrab input for Form Reform.
Files are first uploaded into a quarantine folder, then added to their final File Manager location following a successful form submission.
The Snapshot Screengrab tool enables users to capture a screengrab from within the web site. Users can edit a file title and description and even edit and annotate the image before uploading the screengrab. The dashboard toolbar button can optionally be configured to capture pages in edit mode and any edit dialogs.
Webcam File Input
Webcam input for Form Reform.
Files are first uploaded into a quarantine folder, then added to their final File Manager location following a successful form submission.
The Snapshot Webcam tool enables users to capture images from device cameras such as a desktop webcam or the front and back cameras on a mobile phone. Users can edit a file title and description and even edit and annotate the image before uploading each image snapped. With the user facing camera in mind, the camera image can be switched between a direct image or a mirror reflection of the image.
State Input
State select input for Form Reform.
An Attach After Submit block template can be used with the Geolocation option to render nothing to the form and attach a geolocated state after the form is submitted.
Table as Select Input
Derive a select dropdown or nested select dropdown from table data by rows or by columns.
Table Picker Input
Table picker input for Form Reform. Provides picking one or more items from a table by superimposing checkboxes to the table cells.
Telephone Number Input
Telephone Number input for Form Reform.
Text Input
Text input for Form Reform.
Text Confirm Input
Text Confirm input for Form Reform. Two inputs are validated to match.
Text Area Input
Text Area input for Form Reform.
Time Input
Time input for Form Reform.
Up Down Vote Input
Up Down Vote input for Form Reform.
Uppercase Input
Uppercase input for Form Reform.
Url Input
Url input for Form Reform.
Special purpose block types
Captcha
Captcha for Form Reform.
CCM Token
CCM Token spam and CSRF trap for Form Reform.
Geofence Continent
Geofence Continent for Form Reform.
In the Redirect tab:
- When Stay on this page is selected, the geofence will be checked when the form is submitted.
- When Redirect is selected, the geofence will be checked when the page is loaded. Any geofence based redirect will be made immediately and a redirected visitor will not be given any chance to use the form.
Geofence Country
Geofence Country for Form Reform.
In the Redirect tab:
- When Stay on this page is selected, the geofence will be checked when the form is submitted.
- When Redirect is selected, the geofence will be checked when the page is loaded. Any geofence based redirect will be made immediately and a redirected visitor will not be given any chance to use the form.
Honeypot
Honeypot spam trap for Form Reform.
Message Display
Display a Form Reform response message.
Prohibit Repeated Form
Prevent form from being entered if it has already been submitted.
QR Reader Extend
Attach a QR code reader to one or more inputs.
Repeatable Group
Repeatable group control for Form Reform.
Require Form
Require another form/page to be completed before this form can be shown.
Spinner
A spinner to show while a form is submitting.
Submit Button
Submit a form created with Form Reform and manage the submit handling.
Text Suggestions
Attach a list of suggestions to one or more text inputs.