Documentation / Administrator Guide / Integrations / Forms Integration

Forms Integration

Note: This functionality is part of Staatic Premium Edition.

Introduction

Staatic Forms provides a dynamic backend to handle all of your site’s form submissions. All form submissions are verified by Akismet automatically to prevent spam.

Staatic forms supports the following use cases:

  • Simple forms;
  • Forms with nested fields (using [] notation);
  • Forms that accept attachments;
  • JavaScript forms.

Currently the following use cases are not (yet) supported:

  • Multi-page forms.

Enabling form handling

In order to be able to receive form submissions, the relevant forms need to be integrated with Staatic Forms. This can be done automatically (depending on the way forms are setup on your WordPress site), or manually in case you need full control.

Automatic integration

Automatic form integration is available for the following WordPress form plugins:

To enable automatic integration, head over to the WordPress Admin and click Staatic > Settings > Integration. Make sure Enable forms integration with popular WordPress plugins is checked.

Note: automatically integrated forms will have a Honeypot field added to them to reduce the amount of spam.

Manual integration

In case you cannot use automatic integration, or when you need full control over the available form handling options, you can manually integrate your forms with Staatic Forms.

Within the HTML code of the form, make sure the <form> tag has a name attribute with the name of the form, as well as the data-staatic attribute with any value, for example:

<form name="Contact Form" data-staatic="true">
    <input type="text" name="name" placeholder="Your name">
    <input type="email" name="email" placeholder="Your email address">
    <input type="submit" value="Submit">
</form>

The following additional <form> attributes are available:

Redirect URL (data-staatic-redirect-url)

By default when a form is submitted, a thank-you page is shown. To redirect users to your site, use the data-staatic-redirect-url attribute with the URL to redirect as a value.

Example:

<form
    name="Contact Form"
    data-staatic="true"
    data-staatic-redirect-url="https://example.com/thank-you/"
>
    ...
</form>

Honeypot (data-staatic-honeypot)

To reduce the amount of spam, add a hidden field to the page containing the form and use the data-staatic-honeypot attribute with the value of the hidden field.

Example:

<form
    name="Contact Form"
    data-staatic="true"
    data-staatic-honeypot="honeypot_123"
>
    ...
    <input type="hidden" name="honeypot_123" style="display: none;">
</form>

Note: make sure to hide the honeypot field using a more sophisticated approach as many bots will be able to identify this honeypot field easily.

Setting up notifications

In order to get notified of new form submissions, you can set up one or more notification settings.

  1. Go to the WordPress Admin and click Staatic > Settings > Integration.
  2. Click Add form notification.
  3. Select the Form that this notification setting applies to, or select Any form to apply it to all forms.
  4. Choose the Notification type, which can be either Email or Webhook.
  5. Depending on the Notification type, enter the Email address or Webhook URL to receive the notifications.
  6. Click Save Changes.

Note: when choosing Email as the Notification type, only Verified submissions will be sent. Make sure to check Managing form submissions once in a while to check for spam.

Managing forms

Forms identified by Staatic can be managed in the WordPress Admin by going to Staatic > Forms.

Viewing & modifying identified forms

Within the Forms section of Staatic you will see a list of all forms identified and managed by Staatic. When hoovering over the name of the form, click Details to view the details of the form.

When viewing the form Details, you will be able to adjust some of the form’s properties, including:

  • Name

    The name of the form for identification purposes.

  • Response Type

    • Show Thank You Page

      Whether to show a simple Thank-You page when the form is submitted.

    • Redirect to External URL

      Whether to redirect to a specific URL when the form is submitted.

  • Honeypot field

    The name of the honeypot field to trap bots.

  • reCAPTCHA secret

    In case your forms has reCAPTCHA protection enabled, enter the reCAPTCHA secret here to enable verification.

Managing form submissions

Form submissions handled by Staatic can be managed in the WordPress Admin by going to Staatic > Forms. When hoovering over the name of the form, click Submissions to view the submissions of the form.

Here you will be able to see all verified submissions as well as submissions that were identified as spam.

This part of the documentation is still Work in Progress.