Skip to main content

Using Quant Forms

Quant provides a simple way to capture form submissions on your existing web forms.

Create a new form#

From the "Forms" section click "New form" and enter the URL to accept form submissions.

It should be the same URL your HTML form posts values to, for example if your form was <form action="/contact" action="POST"> you should use /contact here.

Configuring your form#

Basic settings#

Check the Enable QuantForms checkbox to enable forms for the route.

Optionally provide success, missing value, and generic failure messages. These may contain markup.

Enable QuantForms

Mandatory & remove fields#

Add Mandatory fields as required. Submissions will be rejected if these values are not present.

Optionally set Remove fields to strip specific form values from the result.

Notifications#

Quant currently provides two notification options: Email and Slack.

Use Disable HTML emails to remove rich-text emails. Use Include submission data to include submission values in the notification message itself. Set the email to, cc, from, subject values as desired. Optionally provide a Slack webhook in the format https://hooks.slack.com/services/a/b to receive notifications via Slack.

Spam protection#

Quant has spam protection built in, however it is recommended you also protect your forms with a honeypot to prevent spam submissions from bots.

To do this, add a field to your form that should not be filled in. For example:

<input type="hidden" name="fname">

Quant Forms honeypot

Add this to the Quant configuration under "Honeypot fields". If a form is received with this value filled out the form will be rejected with an error.

View submissions#

Your form submissions are available via the Quant Dashboard. Go to the "Forms" section, and view any submissions associated with a webform.

Submitted files will also be available for download.

Submission result messages#

Quant will inject the result of a form submission in the markup. This allows you to return a success/failure message to end users upon submission.

Simply add a container to your page with an attribute: id="quant-form-result". This is where the result messages will render upon submission. For example:

<div id="quant-form-result"></div>

Contact Form 7 support (Wordpress)#

Contact Form 7 posts values via AJAX by default. The response from Quant is not as CF7 expects, so an error is received.

To resolve simply disable the submission via javascript in Wordpress by adding the following to your wp-config.php file:

define ( 'WPCF7_LOAD_JS', false );

Push your form content from Wordpress to Quant after making this change.