formcierge_before_submission_save

Filter

Since v1.0.0

Filter the submission data array before it is written to the database. Use to transform, enrich, or remove field values. Return the modified data array.

Parameters

$data array Associative array of field_id => value pairs.

$form_id int The form ID.

Defined in

includes/Controllers/SubmissionController.php

Basic Usage

add_filter( 'formcierge_before_submission_save', function ( $data, $form_id ) {
    $data['server_ip'] = $_SERVER['REMOTE_ADDR'] ?? '';
    return $data;
}, 10, 2 );

Real-World Examples

Strip HTML from all text fields

add_filter( 'formcierge_before_submission_save', function ( $data, $form_id ) {
    return array_map( function ( $value ) {
        return is_string( $value ) ? wp_strip_all_tags( $value ) : $value;
    }, $data );
}, 10, 2 );