ACPT v2
  • General
    • Minimum requirements
    • Download the plugin
    • Install ACPT
    • Install ACPT with Composer
    • Managing your license
    • Migrating from v1
      • Fix data loss after migration from V1
    • Settings
    • Translations
    • How to open a ticket
  • Basics
    • Custom post types
    • Taxonomies
    • Post type-Taxonomy association
    • Option pages
  • Meta fields
    • Field groups
    • The meta fields manager
      • Group settings
      • Basics
      • Advanced options
      • Conditional rendering
      • Validation rules
    • Field types
      • Address field
      • Audio field
      • Audio multiple field
      • Color field
      • Country field
      • Currency field
      • Date field
      • Datetime field
      • Date range field
      • Editor field
      • Email field
      • Embed field
      • File field
      • Gallery field
      • HTML field
      • Icon field
      • Image field
      • Length field
      • List field
      • Number field
      • Password field
      • Phone field
      • QR Code field
      • Select, checkbox, and radio
      • Rating field
      • Repeater field
      • Relational field
      • Range field
      • Table field
      • Textarea field
      • Text field
      • Time field
      • Toggle field
      • URL field
      • Video field
      • Weight field
  • Permissions manager
    • Custom post types permissions
    • Taxonomies permissions
    • Option pages permissions
    • Meta fields permissions
  • Tools
    • Custom APIs
    • Health check
    • Datasets
    • Export data
    • Import data
  • Forms
    • Manage forms
    • The form builder
    • Examples of form usage
      • Create a new post type
      • Modify an existing post type
      • Create a new term
      • Modify an existing term
      • Create a new user
      • Modify an existing user
    • Form submissions log
  • Dynamic blocks
    • Create your first block
  • Developers
    • Functions
      • register_acpt_post_type
      • delete_acpt_post_type
      • register_acpt_taxonomy
      • delete_acpt_taxonomy
      • assoc_acpt_taxonomy_to_acpt_post
      • remove_assoc_acpt_taxonomy_from_acpt_post
      • register_acpt_option_page
      • delete_acpt_option_page
      • save_acpt_form
      • delete_acpt_form
      • save_acpt_form_field
      • delete_acpt_form_field
      • get_acpt_form_object
      • get_acpt_form_field_object
      • save_acpt_meta_group
      • delete_acpt_meta_group
      • get_acpt_meta_group_objects
      • get_acpt_meta_group_object
      • save_acpt_meta_box
      • delete_acpt_meta_box
      • get_acpt_box_object
      • save_acpt_meta_field
      • delete_acpt_meta_field
      • get_acpt_meta_field_objects
      • get_acpt_meta_field_object
      • save_acpt_meta_field_value
      • delete_acpt_meta_field_value
      • get_acpt_fields
      • acpt_field_has_rows
      • acpt_field_has_blocks
      • get_acpt_field
      • get_acpt_child_field
      • get_acpt_block
      • get_acpt_block_child_field
      • acpt_field
      • is_acpt_field_visible
    • Shortcodes
  • Integrations
    • API Rest field integration
    • Breakdance
      • Build a real estate website
      • Working with nestable fields
    • Bricks builder
      • Build a real estate website
      • Working with nestable fields
      • Working with Slider (Nestable) and Gallery field
      • Working with relational fields inside query loops
      • Additional options
      • Working with text links
    • Divi
    • Elementor
      • Basic field blocks
      • Nestable field blocks
      • Dynamic tags
    • Gutenberg
      • Basic fields block
      • Relational fields block
      • Repeater fields block
      • Working with FSE
    • Oxygen builder
    • Rank Math
    • SEOPress
    • Slim SEO
    • WooCommerce
    • WP All Import/Export
    • WP Grid Builder
    • WPGraphQL
    • WPML
    • Yoast
    • Zion builder
Powered by GitBook
On this page
  • Enabling the form builder
  • Create the first form
  • Form action
  • Submission limits
  • CSS Variables
  • Use the form on your website
  1. Forms

Manage forms

How to manage forms

PreviousImport dataNextThe form builder

Last updated 4 days ago

Enabling the form builder

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.

Create the first form

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

Form action

The form action determines its behavior.

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

Ajax action

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.

Custom action

This action allows setting a custom form action.

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

Post Management action

This action allows saving ACPT meta fields.

There is no need for further configurations.

PHP action

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.

Meta fields mapping

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:

  • a Custom Post Type

  • a Taxonomy

  • an Option page

  • all users

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.

Submission limits

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

  • Anonymous user

  • Logged users

  • Specific user

  • User role

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

CSS Variables

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

Use the form on your website

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.

The path of invoked is required.

The data variable contains the response value:

Now, locate the Manage link on the forms table list to open the .

ACPT forms fully support .

AJAX action
Promise
form builder
CSS variables
Settings page