Visualizza Markdown

Descrizione

L'azione wpforms_process_validate_checkbox attiva la convalida sul campo modulo Checkbox quando il modulo viene inviato.

Parametri

$field_id
(int) ID del campo.
$field_submit
(array) Valore originale non sanificato inviato per il campo.
$form_data
(array) Impostazioni/dati del modulo elaborati, preparati per l'uso successivo.

Origine

wpforms/includes/class-process.php

Maggiori Informazioni

Il filtro wpforms_process_validate_checkbox viene applicato a un array per il campo modulo Checkbox. Questa funzione può essere utilizzata per tutti i campi modulo do_action( "wpforms_process_validate_{$field_type}", $field_id, $field_submit, $form_data ).

È importante notare che i valori dei campi non vengono sanificati fino a un momento successivo nell'elaborazione, in wpforms_process_format_{$field_type}.il

Esempi

In questo esempio mostrato di seguito, la funzione controllerà il campo modulo Checkbox per un numero minimo di scelte da selezionare.

/*
 * Check the Checkboxes field for minimum number of choices.
 *
 * @link https://wpforms.com/developers/wpforms_process_validate_checkbox/
 *
 * @param int     $field_id        Field ID.
 * @param array   $field_submit    Unsanitized field value submitted for the field.
 * @param array   $form_data       Form data and settings.
*/

function wpf_checkbox_validation( $field_id, $field_submit, $form_data ) {
 
    $field_submit  = (array) $field_submit;
 
    $count_choices = count( $field_submit );
    if ( $count_choices < 2 ) {
        wpforms()->process->errors[ $form_data[ 'id' ] ][ $field_id ] = __( 'Please select at least 2 options', 'plugin-domain' );
 
    }
 
}
add_action( 'wpforms_process_validate_checkbox', 'wpf_checkbox_validation', 10, 3 );

Riferimento articolo: Come impostare un numero minimo di scelte per una checkbox

Ancora bloccato? Come possiamo aiutarti?
Ultimo aggiornamento il 24 lug 2023