Action: Redirect

Features Modules Forms Action: Redirect

Redirect Action

The Redirect Action is a template to create a redirection on form submission.

Dynamic Form

Add actions on form submission

Click the "Add action" button below to start creating your layout
0 Custom action
Documentation
Action

Set a unique action slug.

0 Email action
0 Option action
Documentation
Action

(Optional) Target this action using hooks.

Save
Load

Fill inputs with values

0 Post action
Documentation
Action

(Optional) Target this action using hooks.

Save
Click to initialize TinyMCE
Load

Fill inputs with values

0 Redirect action
Documentation
Action

(Optional) Target this action using hooks.

The URL to redirect to. See "Cheatsheet" tab for all available template tags.

0 Term action
Documentation
Action

(Optional) Target this action using hooks.

Save
Click to initialize TinyMCE
Load

Fill inputs with values

0 User action
Documentation
Action

(Optional) Target this action using hooks.

Save
Click to initialize TinyMCE
Load

Fill inputs with values

1 Redirect action
Documentation
Action

(Optional) Target this action using hooks.

The URL to redirect to. See "Cheatsheet" tab for all available template tags.

Add action

Redirect Settings

Setting nameDescription
Action nameAlias name allowing to use targeted hook
Action URLThe URL to redirect to.

Validation

By default, there is no validation for this Action. You can use the acf/validate_value hook to validate each fields individually.

To validate the whole form, you can use the acfe/form/validate_redirect hook and throw errors with the acfe_add_validation_error() function. Usage example:

/**
 * Redirect Action: Validation
 * 
 * @array  $form    Form settings array
 * @array  $action  Action settings array
 */
 
action('acfe/form/validate_redirect',                    $form, $action);
action('acfe/form/validate_redirect/form=my-form',       $form, $action);
action('acfe/form/validate_redirect/action=my-redirect', $form, $action);
add_action('acfe/form/validate_redirect/form=my-form', 'my_redirect_validation', 10, 2);
function my_redirect_validation($form, $action){
    
    // get current post id
    // where the form is displayed
    $post_id = $form['post_id'];
    
    // get field input value
    $my_field = get_field('my_field');
    
    // check field value
    if($my_field === 'Company'){
        
        // add validation error
        acfe_add_validation_error('my_field', 'The value Company is not allowed');
        
    }
    
}

Prepare

The preparation phase is triggered after the form validation and before its submission. Returning false will stop the Action and go to the next one. Usage example:

/**
 * Redirect Action: Prepare
 * 
 * @array  $action  Action settings array
 * @array  $form    Form settings array
 *
 * @return array|false
 */
 
filter('acfe/form/prepare_redirect',                    $action, $form);
filter('acfe/form/prepare_redirect/form=my-form',       $action, $form);
filter('acfe/form/prepare_redirect/action=my-redirect', $action, $form);
add_filter('acfe/form/prepare/redirect/form=my-form', 'my_redirect_prepare', 10, 2);
function my_redirect_prepare($action, $form){
    
    // if user isn't logged in
    // do not redirect
    if(!is_user_logged_in()){
        return false;
    }
    
    // return normally
    return $action;
    
}

Redirect URL

Change the redirection URL. Usage example:

/**
 * Redirect Action: URL
 * 
 * @string  $url     Redirect URL
 * @array   $form    Form settings array
 * @array   $action  Action settings array
 *
 * @return string|false
 */

filter('acfe/form/submit_redirect_url',                    $url, $form, $action);
filter('acfe/form/submit_redirect_url/form=my-form',       $url, $form, $action);
filter('acfe/form/submit_redirect_url/action=my-redirect', $url, $form, $action);
add_filter('acfe/form/submit_redirect_url/form=my-form', 'my_redirect_url', 10, 3);
function my_redirect_url($url, $form, $action){

    // get field input value
    $my_field = get_field('my_field');
    
    // check field value
    // and change redirect url
    if($my_field === 'Company'){
        $url = home_url('thank-you');
    }

    // get previous post action output (if any)
    $post_action = acfe_form_get_action('post');

    // check previous post action exists
    if(!empty($post_action)){
    
        // check the post title of the created post
        // and change redirect url
        if($post_action['post_title'] === 'Post Title'){
            $url = home_url('thank-you');
        }

    }

    // do not redirect
    // return false;
    
    // return normally
    return $url;
    
}
Index
Redirect Action
Redirect Settings
Validation
Prepare
Redirect URL
Functions
acfe_add_validation_error()
Hooks
acfe/form/validate_redirect
acfe/form/prepare_redirect
acfe/form/submit_redirect_url
Field Groups Field Settings Fields Modules
Block Types PRO Classic Editor PRO Developer Mode PRO Forms PRO
Integration PRO Cheatsheet Helpers Hooks Action: Custom Action: E-mail Action: Option PRO Action: Post Action: Redirect Action: Term Action: User
Options Pages PRO Performance Mode PRO Post Types PRO Rewrite Rules PRO Scripts PRO Settings UI PRO Taxonomies PRO Templates PRO
WordPress Hooks & Helpers