Confirmations Object

Introduction

The Confirmations object is an associative array containing the properties for all the confirmations which exist for a form. When a new form is created a single confirmation, named Default Confirmation, is created. There is no limit to the number of additional confirmations you can create but they must have conditional logic configured.

See the Configuring Confirmations article for a tutorial showing how you can configure confirmations in the admin.

$form['confirmations'] = array(
    '5acf8e9cf310a' => array(
        'id'          => '5acf8e9cf310a',
        'name'        => 'Default Confirmation',
        'isDefault'   => true,
        'type'        => 'message',
        'message'     => 'Thanks for contacting us! We will get in touch with you shortly.',
        'url'         => '',
        'pageId'      => '',
        'queryString' => '',
    ),
);

Usage

The confirmations are part of the Form Object and so are most commonly accessed like so:

$confirmations = rgar( $form, 'confirmations' );

Confirmation Properties

PropTypeDescription
idstringThe confirmation ID.
A 13 character unique ID generated by the PHP uniqid function.
namestringThe confirmation name.
isDefaultbooleanIndicates if this is the default confirmation created on form creation or one of the automatically created confirmations for the save and continue feature.
typestringDetermines the type of confirmation to be used.
Possible values:
message: displays a simple message
page: redirects to a WordPress post or page
redirect: redirects to an external URL
messagenull|stringOnly used when type is message.
The message to be displayed when the form submission completes.
disableAutoformatnull|booleanOnly used when type is message.
Determines if the formatting of new lines in the message as paragraphs should be disabled.
pageIdnull|integer|stringOnly used when type is page.
The ID of the post or page to redirect to when the form submission completes.
urlnull|stringOnly used when type is redirect.
The URL to redirect to when the form submission completes.
queryStringnull|stringOnly used when type is page or redirect.
The query string to be appended to the redirect URL.
Merge tags supported.
conditionalLogicnull|arrayNot used when isDefault is true or when event is defined.
An associative array containing the conditional logic rules.
See the Conditional Logic Object for more details.
eventnull|stringThe non-submission event the confirmation is to be used for.
Possible values:
null or an empty string to indicate the confirmation is used on form submission completion.
form_saved: displayed when the save and continue later link is used.
form_save_email_sent: displayed when the email link form in the form_saved confirmation message triggered sending of the resume email notification.
isActivenull|booleanNot used when isDefault is true or when event is defined.
Indicates the confirmation status, active or inactive.
Default: true