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 );
Correlato
Riferimento all'articolo: Come impostare un numero minimo di scelte per una casella di controllo