Dashboard pages for Form Reform are split into two distinct groups.
Dashboard > Reports > Form Reform
Form submissions are accessible through the same dashboard area as core forms. The sub-path is /dashboard/reports/form_reform/.
Here the page Form Submissions provides a listing and review page for forms saved with the Save to Default form handler.
Access to add new form entries through the dashboard and edit/remove existing form entries are managed through task permissions:
Form data is serialized as JSON. The details, add and edit pages provide a syntax enabled editor for that data.
This dashboard page also provides the usual search and pagination capabilities for submitted form data, with access to search presets being managed by the task permission
Dashboard > Reports > Form Reform > Form Report Generator
The sub-path for the Form Report Generator is /dashboard/reports/form_reform/form_reform_report.
The Form Report Generator provides an interface to add, configure, edit and run reports on form results held in the default store. Unlike the dump-formatted default dashboard view, reports enable columns to be picked and shown in a cleanly tabulated format. Reports can be filtered and sorted on any submitted form data using many different comparison operators.
Reports can then be run to show paginated results in the dashboard and downloaded as CSV data.
In front end pages, reports can be run and shown using the Form Reform Display Report block and used as the data set for analysis in the Form Reform Display Analysis block.
When configuring a report in the dashboard, filters on the data may contain {{place_holders}} in the same way that form handlers can. This enables front-end display of reports to adapt to page URL query parameters and other dynamic parameters.
For example:
Lest assume you have a Form Reform form that saved data including a field for the country.
We now have a pair of pages, the first selects a country and redirects to the second page which displays the report of form submissions for that country. There is a lot more that can be done with this kind of structure for displaying form results with more complex filtering. All no-code using Form Reform and the power of the Form Report Generator.
A related front end block is the Form Reform Display Analysis block. Like the Form Reform Display Report block, this takes an already configured report as its starting point. The report data is then used as the data set to conduct an analysis of submitted form fields using analysis options such as:
Drawing on our above example, our report with countries could be used to show a Frequency Analysis of the submissions by country.
Taking it even further, this could be used with Universal Content Puller to show the submissions by country as a bar chart.
The analysis subsystem is fully plugable, enabling it to be extended through Concrete marketplace addons and by application specific analysis plugins.
Dashboard > System & Settings > Form Reform
In the dashboard page group beneath /dashboard/system/form_reform we have the Form Reform system pages.
At /dashboard/system/form_reform/plugin_list we have a list of all Form Handlers. If you add any custom handlers, visiting this page will automatically recognize them and make them available to Form Reform. This list expands to built in documentation for the form handlers.
At /dashboard/system/form_reform/global_settings we have a copy of the Submit Button edit dialogue which can be used to manage the default settings for new Submit Button blocks.
Settings for the submit button and pipeline can also be saved, exported and imported.
At /dashboard/system/form_reform/form_reform_blocks we have a list of all Form Reform blocks. This list is also available on the front end as a template for the Form Reform Documentation block.
Form Reform provides some advanced configuration settings including supplementary styling at /dashboard/system/form_reform/advanced_config. Most installations of Form Reform will not need to change these settings. Edit these at your peril!
At /dashboard/system/form_reform/analysis_plugin_list we have a list of all Analysis plugins. If you add any custom analysis plugins, visiting this page will automatically recognize them and make them available.
When developing more complex forms, the Form Reform Developer extension provides analysis of forms useful for identifying problems with forms and helping with development for form blocks and handlers. This includes dashboard pages.
The Plugin Dialogue Explorer at /dashboard/system/form_reform/plugin_dialogue_explorer renders a reference copy of all pipeline handler plugin dialogues. These won't save and may only partially work. The dialogues are simply presented for browsing and learning.
The Block Dialogue Explorer at /dashboard/system/form_reform/block_dialogue_explorer renders a reference copy of all form reform block dialogues and views. These won't save and may only partially work. Views are rendered with the dashboard theme. The examples are simply there for browsing and learning.
When the Stored Settings Manager addon is installed, a dashboard page to manage stored settings for Form Reform is provided at /dashboard/system/form_reform/stored_settings.
When the Form Reform Macros addon is installed, a dashboard page to manage macros for Form Reform is provided at /dashboard/system/form_reform/macro.
Form Reform also provides custom view templates for the Dashboard Latest Form and Dashboard Site Activity blocks. These blocks provide general information for the dashboard Welcome page and the custom templates add Form Reform to that information.
The base code for the FromReformDefault store, listing and dashboard page for showing form results were generated using Entity Designer then highly adapted for the requirements for Form Reform.
If you need a specialized template or a custom input element, you can design new templates or new block types for form elements as you would any block type.
Blocks are easy for third party addition or extension. Block templates and are the first thing any Concrete CMS developer learns to code. They are one of the easiest things to code. The underlying mechanisms are well established and reliable.
Form handlers are built about the same extensible plugin system as many of my other addons (Universal Content Puller, Omni Gallery, Extreme Clean ...).
The whole system is aimed at easy extension within Form Reform, by third party addons, by agencies and by site building developers.
Handlers can be easily added to do whatever you want with the 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.
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.
Provides blocks and dashboard utilities to List, display, summarize, generate reports and analyze form submissions from Form Reform. Additionally supports integration with Universal Content Puller.
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 handlers for querying Microsoft Dynamics, forwarding and updating form data to Microsoft Dynamics.
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.
Save submitted forms to Express objects and user attributes. Add and remove users from groups.
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 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.
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.
A growing suite of resources to assist those developing blocks, handlers and more complex forms for Form Reform.
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.