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.

Input control block types

Forms are built by adding blocks for the form inputs to a page. These blocks can be added directly to the page or using stacks, containers and layouts. A Submit Button block submits the form and configures processing of the form.

Address Lookup Input

Address Lookup input for Form Reform.

Start entering an address or postal code and be presented with matching addresses. When an address is selected, the address data can also be cross-populated to associated form controls such as latitude, longitude, address1, address2, state, country etc.. The Google Places API must be enabled on your google maps API account.

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 bay 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]

This block may be used in repeatable groups

Link to here

Options Attribute Checkbox List Input

Checkbox list from Options Attribute values for Form Reform.

Configure a checkbox list to choose from and provide values suitable for saving to an options attribute. Allows the initially selected option to be set.

This block may be used in repeatable groups

Link to here

Options Attribute Radioset Input

Radioset from Options Attribute values for Form Reform.

Configure a radioset to choose from and provide values suitable for saving to an options attribute. Allows the initially selected option to be set.

This block may be used in repeatable groups

Link to here

Options Attribute Select Input

Dropdown select from Options Attribute values for Form Reform.

Configure a select list to choose from and provide values suitable for saving to an options attribute. Allows the initially selected option to be set.

This block may be used in repeatable groups

Link to here

Checkbox Input

Checkbox input for Form Reform.

Initial state and required state are configurable. For Bootstrap5 based themes, an option allows rendering as a switch.

This block may be used in repeatable groups

Link to here

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.

Configure a list of checkbox values and labels. Options allow initial checked state to be set. An option allows the list to be shown vertically or horizontally. Checkbox lists vary between themes, so the default block template is designed for Bootstrap5 and we have a separate template for Bootstrap3. For other theme frameworks you may need to create a custom template with appropriate classes. Specific to Bootstrap5 is an option to show the items as switches instead of as checkboxes.

This block may be used in repeatable groups

Link to here

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.

Configure a list of checkbox input values and labels with an other label which opens a text box. Options allow the initial checked items to be set. An option allows the list to be shown vertically or horizontally. Checkbox lists vary between themes, so the default block template is designed for Bootstrap5 and we have a separate template for Bootstrap3. For other theme frameworks you may need to create a custom template with appropriate classes.

This block may be used in repeatable groups

Link to here

Checkbox Matrix Input

Checkbox Matrix input for Form Reform. Build a table of checkbox inputs.

Configure a column list of checkbox input values and labels and a row list of row labels. The columns and rows are then combined into a table of checkbox input groups, one group for each column.

This block may be used in repeatable groups

Link to here

Checkbox + Message Input

Checkbox input with associated rich text message for Form Reform.

Display a checkbox with a rich text message alongside. This can be useful for requiring a user to grant a permission where a complex message about things like privacy or terms with links need to be associated. Initial state and required state are configurable. For Bootstrap5 based themes, an option allows rendering as a switch.

This block may be used in repeatable groups

Link to here

Color Picker Input

Color picker input for Form Reform.

Color format, initial value and many picker options are configurable.

This block may be used in repeatable groups

Link to here

Continent Input

Continent input for Form Reform.

Configure a list of continents to select from. Options allow the initially selected continent to be by geolocation or to a default continent.

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.

This block may be used in repeatable groups

Link to here

Country Input

Country input for Form Reform.

Configure a list of countries to select from. Options allow the initially selected country to be by geolocation or to a default country.

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.

This block may be used in repeatable groups

Link to here

Country State Input

Country State input for Form Reform.

Configure a list of countries to select country and state from. Options allow the initially selected country to be by geolocation or to a default country.

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.

This block may be used in repeatable groups

Link to here

Custom Text Input

Text input with custom validation for Form Reform

Define a regular expression and/or your own validation function to restrict input to a specific format.

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.

This block may be used in repeatable groups

Link to here

Date Input

Date input for Form Reform.

Minimum and maximum dates are configurable.

This block may be used in repeatable groups

Link to here

DateTime Input

DateTime input for Form Reform.

Minimum and maximum dates/times are configurable.

This block may be used in repeatable groups

Link to here

Email Input

Email input for Form Reform.

Options set strength of validation and for checking against an MX record.

This block may be used in repeatable groups

Link to here

Email Confirm Input

Email Confirm input for Form Reform. Two email inputs are validated to match.

Options set strength of validation and for checking against an MX record.

This block may be used in repeatable groups

Link to here

Grouped Select Input

Select input for Form Reform with groups of options.

Configure a list of select values and labels divided into groups. Options allow the initially selected option to be set.

This block may be used in repeatable groups

Link to here

Handle Input

Handle input for Form Reform.

Restrict input to lowercase_decimal_and_underscore_handle. Minimum and maximum input lengths are configurable.

This block may be used in repeatable groups

Link to here

Hidden Input

Hidden input for Form Reform.

An Attach After Submit block template can be used to render nothing to the form and attach the data after the form is submitted. This provides a secure option for some types of fixed data, but cannot be used to maintain data from previous form inputs

This block may be used in repeatable groups

Link to here

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.

Configure an image picker to connect with an Omni Gallery or other gallery, slider or carousel of images. Images in the gallery can then be dragged onto the image picker input element to be selected for the form.

This block may be used in repeatable groups

Link to here

JSON as Select Input

Derive a select dropdown or nested select dropdown from JSON data.

JSON as Select Input sources data from Universal Content Puller JSON data and other sources.

This block cannot be used inside repeatable groups

Link to here

Latitude / Longitude Input

Latitude or Longitude input for Form Reform.

Configure a pair of these inputs, one for latitude and one for longitude. Minimum, maximum and step values are configurable within the limits of latitude or longitude. This facilitates flexible layout of the latitude/longitude inputs.

This block may be used in repeatable groups

Link to here

Like Input

Like input for Form Reform.

This block may be used in repeatable groups

Link to here

Lowercase Input

Lowercase input for Form Reform.

Restrict input to lowercase text. Minimum and maximum input lengths are configurable.

This block may be used in repeatable groups

Link to here

Masked Text Input

Masked Text input for Form Reform.

Define a mask to restrict inputs to a specific format

Mask formatting characters:

9 - A decimal digit
A - An letter
* - A letter or decimal digit

Any other character will be inserted directly in the text. Alphanumeric characters in the mask may cause issues.

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.

This block may be used in repeatable groups

Link to here

Number Input

Number input for Form Reform.

Minimum, maximum and step values are configurable.

This block may be used in repeatable groups

Link to here

Numeric Digits Input

Numeric digits input for Form Reform.

Restrict input to numeric digits. Minimum and maximum input lengths are configurable. Note: this is not the same as a number input!

This block may be used in repeatable groups

Link to here

Password Input

Password input for Form Reform. For entering a password. Use "Password Confirm" for setting a password.

Minimum and maximum password lengths are configurable. Password inputs are not saved with form data. If you use a password input, you also need to implement a handler that uses that input for whatever you are applying a password to.

This block may be used in repeatable groups

Link to here

Password Confirm Input

Password Confirm input for Form Reform. Two passwords are validated to match.

This block may be used in repeatable groups

Link to here

Radio Matrix Input

Radio Matrix input for Form Reform. Build a table of radio options.

Configure a column list of radio input values and labels and a row list of row labels. The columns and rows are then combined into a table of radio input groups, one group for each column.

This block may be used in repeatable groups

Link to here

Radioset Input

Radioset input for Form Reform. The default view is for Bootstrap5. Set the bootstrap3_elemental or a custom template for other themes.

Configure a list of radio input values and labels. Options allow the initial selected item to be set. An option allows the list to be shown vertically or horizontally. Radioset lists vary between themes, so the default block template is designed for Bootstrap5 and we have a separate template for Bootstrap3. For other theme frameworks you may need to create a custom template with appropriate classes.

This block may be used in repeatable groups

Link to here

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.

Configure a list of radio input values and labels with an other label which opens a text box. Options allow the initial selected item to be set. An option allows the list to be shown vertically or horizontally. Radioset lists vary between themes, so the default block template is designed for Bootstrap5 and we have a separate template for Bootstrap3. For other theme frameworks you may need to create a custom template with appropriate classes.

This block may be used in repeatable groups

Link to here

Range Input

Range input for Form Reform.

For restricted ranges of numbers to show in a range slider. Minimum, maximum and step values are configurable.

This block may be used in repeatable groups

Link to here

Rating Input

Rating input for Form Reform.

Rate by selecting from a list of icons from zero to a maximum (default 0 to 5 stars). Minimum, maximum, icons and icon colours are configurable. Rating values are stored as floating point decimals from 0 to 1. Behind the scenes this is a radioset.

This block may be used in repeatable groups

Link to here

Rich Text Input

Rich text input for Form Reform.

Minimum and maximum input lengths are configurable.

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.

This block cannot be used inside repeatable groups

Link to here

Select Input

Select input for Form Reform.

Configure a list of select values and labels. Options allow the initially selected option to be set.

This block may be used in repeatable groups

Link to here

Select Combi Input

Select Combi input for Form Reform.

Configure a list of select values and labels with an other label which opens a text box. Options allow the initially selected option to be set.

This block may be used in repeatable groups

Link to here

Drag & Drop File Input

Drag & Drop file upload input for Form Reform.

Integrates the SnapShot Drag & Drop file uploader with a Form Reform input control.

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.

The Drag & Drop uploader tool has no specific security requirements. The Drag & Drop uploader tool is available, subject to browser support

This block may be used in repeatable groups

Link to here

Screengrab File Input

Screengrab input for Form Reform.

Integrates the SnapShot Screengrab tool with a Form Reform input control.

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.

The Screen Capture tool requires a site to be https:// or on a localhost. The Screen Capture tool is available, subject to browser support

This block cannot be used inside repeatable groups

Link to here

Webcam File Input

Webcam input for Form Reform.

Integrates the SnapShot Webcam tool with a Form Reform input control.

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.

The Webcam tool requires a site to be https:// or on a localhost. The Webcam tool is available, subject to browser support

This block may be used in repeatable groups

Link to here

State Input

State select input for Form Reform.

Configure a list of States to select from. Options allow the initially selected state to be by geolocation or to a default state.

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.

This block may be used in repeatable groups

Link to here

Table as Select Input

Derive a select dropdown or nested select dropdown from table data by rows or by columns.

Table as Select Input sources data from Universal Content Puller tables and can be configured to work with other tables.

This block cannot be used inside repeatable groups

Link to here

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.

Table Picker Input sources data from Universal Content Puller tables and can be configured to work with other tables.

This block cannot be used inside repeatable groups

Link to here

Telephone Number Input

Telephone Number input for Form Reform.

Minimum and maximum input lengths are configurable.

This block may be used in repeatable groups

Link to here

Text Input

Text input for Form Reform.

Minimum and maximum input lengths are configurable.

This block may be used in repeatable groups

Link to here

Text Confirm Input

Text Confirm input for Form Reform. Two inputs are validated to match.

Minimum and maximum input lengths are configurable.

This block may be used in repeatable groups

Link to here

Text Area Input

Text Area input for Form Reform.

Minimum and maximum input lengths are configurable.

This block may be used in repeatable groups

Link to here

Time Input

Time input for Form Reform.

Minimum and maximum times are configurable.

This block may be used in repeatable groups

Link to here

Up Down Vote Input

Up Down Vote input for Form Reform.

Register an up or down vote by clicking an icon. Icons and icon colours are configurable. Behind the scenes this is a radioset.

This block may be used in repeatable groups

Link to here

Uppercase Input

Uppercase input for Form Reform.

Restrict input to UPPERCASE TEXT. Minimum and maximum input lengths are configurable.

This block may be used in repeatable groups

Link to here

Url Input

Url input for Form Reform.

Options add a ping to validate the actual URL.

This block may be used in repeatable groups

Link to here

Special purpose block types

Captcha

Captcha for Form Reform.

The captcha block inserts a captcha as configured through Captcha Setup and validates that captcha when the form is submitted.

This block cannot be used inside repeatable groups

Link to here

CCM Token

CCM Token spam and CSRF trap for Form Reform.

A security token to validate the page a form is associated with. Tokens are valid for 24 hours, hence this block should not be used on forms/pages that are cached for longer than 24 hours.

This block cannot be used inside repeatable groups

Link to here

Geofence Continent

Geofence Continent for Form Reform.

Visitors are geolocated by IP address and any not matching the continent location rules will fail validation. Options allow matching for inclusion/exclusion, exempting administrators, considering a failed check as spam and redirect on page load.

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.

Do not rely on this as a sole spam check. IP addresses and hence geolocation can be forged.

This block cannot be used inside repeatable groups

Link to here

Geofence Country

Geofence Country for Form Reform.

Visitors are geolocated by IP address and not matching the country location rules will fail validation. Options allow matching for inclusion/exclusion, exempting administrators, considering a failed check as spam and redirect on page load.

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.

Do not rely on this as a sole spam check. IP addresses and hence geolocation can be forged.

This block cannot be used inside repeatable groups

Link to here

Honeypot

Honeypot spam trap for Form Reform.

Just leave it there and the dumb spammers will show themselves by trying to fill it in.

This block may be used in repeatable groups

Link to here

Message Display

Display a Form Reform response message.

Messages are generated by the submit handling pipeline. This block is a placeholder for displaying those messages following submission of a form.

This block cannot be used inside repeatable groups

Link to here

Prohibit Repeated Form

Prevent form from being entered if it has already been submitted.

Checks one or more form stores for completion of the form by name, page, store and time. If the form has already been completed, a message is shown and an optional redirect made. Any check that redirects will skip further checks. For multiple checks, multiple instances of this block can be added to the page. Users with edit permission are never redirected.

This block cannot be used inside repeatable groups

Link to here

Repeatable Group

Repeatable group control for Form Reform.

Provides an in-page toolbar for a repeatable group. A repeatable group can to use a container, layout, stack or any other grouping of input blocks as a repeatable group of inputs and manage the repetition of that group.

This block may be used in repeatable groups

Link to here

Require Form

Require another form/page to be completed before this form can be shown.

Checks one or more form stores for completion of another form by name, page, store and time. If the other form has not completed, a message shown and an optional redirect made to the other form page. Any check that redirects will skip further checks. For multiple checks, multiple instances of this block can be added to the page. Users with edit permission are never redirected.

This block cannot be used inside repeatable groups

Link to here

Spinner

A spinner to show while a form is submitting.

The spinner can be configured to overlay the whole page or only the form or only the form control. Alternative spinners are available as block templates.

This block cannot be used inside repeatable groups

Link to here

Submit Button

Submit a form created with Form Reform and manage the submit handling.

The Submit Button submits a form with all user-entered data from the form input blocks and manages the processing of that data by configuring a pipeline of Form Handlers.

This block cannot be used inside repeatable groups

Link to here

Text Suggestions

Attach a list of suggestions to a text input.

The list of suggestions will then be offered for the attached text input. When Suggestions are attached to a control repeated in a group this block could be placed inside a repeatable group, but it is better to place it outside the group - it will still attach to all repetitions of an input.

This block may be used in repeatable groups

Link to here

Additional Pages

Marketplace Page

Design Concept (pdf)

Reform where you can save form data

Saving form data with Form Reform is simply a handler in the processing pipeline. You can save to multiple locations or just one location.

If you need to save data elsewhere, such as to a dedicated table, a table provided through another addon, to another database, send it to an API, forward it to another server, or anywhere you can imagine, you can adapt or develop a form handler to do so.

The complexity of the code depends on where you are saving or sending the data, but wrapping that into a form handler plugin for Form Reform is straight forward.

The Form Reform handler plugin system is designed for easy extension.

Form Reform

Reform the way forms are built. Build a form out of blocks. Take control of how form submissions are processed and how the submitted data is stored. Easy to extend. Easy to reconfigure. Tangible data. Easy to add your own integrations.

Form Reform Display

List and display form submissions from Form Reform.

Form Reform UTM

Not just Form Reform and not just UTM! Capture and hold incoming UTM (or other) tags and make the tag values available to Form Reform and/or Conditional Redirect as {{place_holders}}. You don't need Form Reform to use this.

Form Reform Dynamics

Form handlers for querying Microsoft Dynamics, forwarding and updating form data to Microsoft Dynamics.

Snapshot

A suite of advanced image capture and upload tools. Enhanced drag and drop file uploading. Make screengrabs from within Concrete CMS. Capture images directly from device webcams. Edit images before uploading.

Form Reform Attributes, Express and Users

Save submitted forms to Express objects and user attributes. Add and remove users from groups.

Form Reform Image Picker

Form Reform Image Picker provides an image picking input block for Form Reform. The Image Picker Input is preconfigured to connect to most Omni Gallery gallery and slider display widgets, the core gallery block, and thumbnail showing templates for the core page list block. Advanced settings allow the Image Picker Input to be configured to pick images from other galleries and sliders.

Form Reform Data Picker

Form Reform Data Picker provides data picking input blocks for Form Reform. The Table Picker Input is preconfigured to connect to Universal Content Puller table display widgets. Advanced settings allow the Table Picker Input to be configured to pick data from other HTML tables.

Form Reform Macros

Extends Form Reform with form handler macros. Provides a new dashboard page at System & Settings > Form Reform > Form Reform Macros to manage macros, and form handlers to run macros.

Form Reform Developer

A growing suite of resources to assist those developing blocks, handlers and more complex forms for Form Reform.

Learn with a simple form

While you may have plans to implement some much more complex forms using Form Reform, we strongly recommend you start with a simple form such as our contact form example in order to review the basic principles of using Form Reform before you move onto anything bigger.

Start by submitting the form at Getting Started - Your First Form a few times, even making some deliberate mistakes.
Watch our Getting Started with Form Reform video to see how the form is built.
Read through the rest of Getting Started - Your First Form for more details of how this form is built.
Create a test page on your site to build your own version of Getting Started - Your First Form and experiment.
Develop your test page with some of the concepts introduced by our further examples and experiment with some of the other form inputs.

Form Reform Blocks

On this Page

Input control block types

Address Lookup Input

Options Attribute Checkbox List Input

Options Attribute Radioset Input

Options Attribute Select Input

Checkbox Input

Checkbox List Input

Checkbox List Combi Input

Checkbox Matrix Input

Checkbox + Message Input

Color Picker Input

Continent Input

Country Input

Country State Input

Custom Text Input

Date Input

DateTime Input

Email Input

Email Confirm Input

Grouped Select Input

Handle Input

Hidden Input

Image Picker Input

JSON as Select Input

Latitude / Longitude Input

Like Input

Lowercase Input

Masked Text Input

Number Input

Numeric Digits Input

Password Input

Password Confirm Input

Radio Matrix Input

Radioset Input

Radioset Combi Input

Range Input

Rating Input

Rich Text Input

Select Input

Select Combi Input

Drag & Drop File Input

Screengrab File Input

Webcam File Input

State Input

Table as Select Input

Table Picker Input

Telephone Number Input

Text Input

Text Confirm Input

Text Area Input

Time Input

Up Down Vote Input

Uppercase Input

Url Input

Special purpose block types

Captcha

CCM Token

Geofence Continent

Geofence Country

Honeypot

Message Display

Prohibit Repeated Form

Repeatable Group

Require Form

Spinner

Submit Button

Text Suggestions

Additional Pages

Reform the way you add new input controls

Reform what you can do with form data

Reform where you can save form data

Learn with a simple form