Riepilogo AI
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