Descrizione
Il wpforms_process_filter
si attiva dopo la convalida dei campi e la formattazione dei dati.
Parametri
- $campi
- (array) Valori/proprietà dei campi di inserimento sanificati.
- $ingresso
- (array) Originale $_POST globale.
- $form_data
- (array) Impostazioni/dati del modulo elaborati, preparati per essere utilizzati in seguito.
Fonte
wpforms/includes/class-process.php
Ulteriori informazioni
Il filtro si attiva alla fine della convalida del campo e della formattazione dei dati.
Esempi
Ricordarsi di cambiare l'ID del modulo da 817 all'ID del modulo a cui si mira.
Questo esempio cercherà di vedere se c'è un campo Valutazioni in questo particolare modulo e se l'utente non lo compila, la valutazione verrà impostata come predefinita a 0.
/** * Fires after all field validation and formatting data. * * @link https://wpforms.com/developers/wpforms_process_filter/ * * @param array $fields Sanitized entry field values/properties. * @param array $entry Original $_POST global. * @param array $form_data Form data and settings. * * @return array */ function wpf_dev_process_filter( $fields, $entry, $form_data ) { $form_id = 817; // Change form ID // Bail early if form ID does not match if ( $form_data[ 'id' ] != $form_id ) { return $fields; } foreach ( $fields as $field ) { // If field type is rating and it is empty, assign a value of 0 if ( $field[ 'type' ] == 'rating' && empty( $field[ 'value' ] ) ) { $fields[$field[ 'id' ]][ 'value' ] = 0; } } return $fields; } add_filter( 'wpforms_process_filter', 'wpf_dev_process_filter', 10, 3 );
Un altro esempio potrebbe essere quando il Mostra i valori è stato implementato per salvare il file value
al posto dell'etichetta.
/** * Save choices `values` instead of `labels` for the fields with `Show values` option enabled. * * @link https://wpforms.com/developers/wpforms_process_filter/ * * @param array $fields Sanitized entry field. values/properties. * @param array $entry Original $_POST global. * @param array $form_data Form data and settings. */ function wpf_dev_process_filter_choices_values( $fields, $entry, $form_data ) { if ( ! is_array( $fields ) ) { return $fields; } foreach ( $fields as $field_id => $field ) { if ( isset( $field[ 'type' ] ) && in_array( $field[ 'type' ], [ 'checkbox', 'radio', 'select' ], true ) && ! empty( $form_data[ 'fields' ][ $field_id ][ 'show_values' ] ) ) { $value_raw = ! empty( $field[ 'value_raw' ] ) ? $field[ 'value_raw' ] : ''; $field[ 'value_raw' ] = $field[ 'value' ]; $field[ 'value' ] = $value_raw; $fields[ $field_id ] = $field; } } return $fields; }; add_filter( 'wpforms_process_filter', 'wpf_dev_process_filter_choices_values', 10, 3 );