Descrizione

Il wpforms_process_validate_checkbox lancia la validazione dell'azione Casella di controllo quando il modulo viene inviato.

Parametri

$campo_id
(int) ID del campo.
$campo_submit
(array) Valore originale del campo grezzo/non sanificato inviato per il campo.
$form_data
(array) Impostazioni/dati del modulo elaborati, preparati per essere utilizzati in seguito.

Fonte

wpforms/includes/class-process.php

Ulteriori informazioni

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

È importante notare che i valori dei campi non sono sanificati se non in un secondo momento dell'elaborazione, al punto wpforms_process_format_{$field_type}.il

Esempi

Nell'esempio riportato di seguito, la funzione controlla il campo del modulo Caselle di controllo 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 all'articolo: Come impostare un numero minimo di scelte per una casella di controllo