Example - Tracking UTM tags

Jump past navigation

This example uses Form Reform UTM to provide UTM tag integration to Form Reform.

As a demonstration, this site is configured to track just one tag we have named utm_test. All other tags will be ignored and will not be recorded.

Please follow the process below:

  1. Visit the link https://c5magic.co.uk/addons/form-reform?utm_test=your+test+note and "your test note" will be remembered and available to form handlers.
     
  2. Complete any of our example forms, such as Getting Started - Your first form. When you submit the form, you will see "your test note" displayed in an extra message.
     
  3. Mess about and attach the query string "?utm_test=something+else" to the url for any page on this site. When you next submit one of the test forms you will see your new tag displayed. Your most recent tag value will be remembered for the remainder of the session.
     
  4. Open another browser or an incognito browser. Complete any of our example forms, such as Getting Started - Your first form. Because it is a new session, you will not have any utm_test tag value.

In the real world you wouldn't be showing UTM tags after a form submission. You would be making a record of the tags with the form data record, or adapting form processing, or redirecting to another page. In our example forms we just add an extra info level message to let you know the tag has been noted.

Adapting the example pipeline

You may have already noticed some extra processing in the handler pipeline of many of our examples.  Only these extra steps inserted into the pipeline are shown here. These steps are inserted at the end of the On Success processing.

We have 3 additional form processing pipeline steps.

  1. A Condition If, which tests the length of place holder {{utm:test|}}. Not the pipe'|' which means 'or use the following as a default' which is not followed by anything. This makes sure the condition tests the actual length of any utm_test tag value and not the un-processed place holder.
     
  2. A information Message to let you know the tag has been remembered and show the value of  {{utm:test}}.
     
  3. A Condition End to end the conditional processing.

Additional Pages

Reform the way you add new input controls

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.

Reform what you can do with form data

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.

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.

Why not Express forms?

Express is the built in object data system built in to Concrete CMS. Form Reform is way more powerful for forms. Express supports basic object relationships, but is not robust.

(function ($) { $(document).ready(function () { if (typeof $.fn.tooltip !== 'undefined') { var this_info = $('#jl_form_reform_e0a034a1b40aaeb9740c48f3d369be76'); this_info.find('[data-bs-toggle="tooltip"]').tooltip(); } }); })(jQuery);

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

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.

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. Create pickers and selectors from tables or JSON data sources including HTML tables, Calendars, Page Lists, Universal Content Puller and previously submitted form results.

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.

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