Manage forms

How to manage forms

First, you need to enable the form builder to use it.

Go to the and find the "Content settings" section, enable the form builder, and you are good to go.

To create a new template, navigate to the form list.

Click on the Create form button. A modal appears:

Showing three fields:

Name - The form name
Label - The form label
Action - Choose the action between Ajax, Custom, Post Management or PHP
Successful outcome message - In case of success, this message will be displayed in a green alert
Redirect after submission - In case of success, redirect to a specific page. Leave black for redirect on the same page

The form action determines its behavior.

Depending on the action, a few different fields will appear.

This action allows running a custom AJAX script to handle submitted form data.

Your custom code is directly executed in the response of the AJAX call.

// data contains the Promise response
console.log(data);

and can be directly used in your JS code.

This action allows setting a custom form action.

You must also choose the form method (POST or GET).

This action allows saving ACPT meta fields.

There is no need for further configurations.

This action allows running a custom PHP script to handle submitted form data.

ACPT rewrites $_POST and $_FILES global super variables, to be used in your script:

<?php
// $_POST and $_FILES store form data already sanitized
// by HandleFormSubmissionCommand class
$data = $_POST;
$files = $_FILES;

In the example code,$data now contains an array of form fields' sanitized values.

Whatever action you choose, you need to specify the list of meta fields (coming from a group already saved) to populate the form builder.

You can choose between:

The list of associated meta fields will appear immediately after.

You can select what fields you want to use in your form.

Optionally, you can specify the form target: a specific post, taxonomy, page, or user.

Once you are done, click on Save.

You can set one or more submission rules. The possible rules are:

For every rule, you need to specify the submission limit.

If you want to change the default CSS variables' values, expand the variable table and set a value for dark and light color schemes.

After a form is created, a shortcode is automatically generated.

For example:

[acpt_form id="2db51086"]

Use this shortcode to display the form where you need it.

Last updated 25 days ago