Descripción

La acción wpforms_process_validate_checkbox activa la validación en el campo de formulario Casilla de verificación cuando se envía el formulario.

Parámetros

$field_id
(int) ID del campo.
$field_submit
(array) Valor original sin procesar/sanitizar del campo enviado.
$form_data
(array) Configuración/datos del formulario procesados, preparados para ser utilizados más adelante.

Origen

wpforms/includes/class-process.php

Más Información

El filtro wpforms_process_validate_checkbox se aplica a una matriz para el campo de formulario Casilla de verificación. Esta función se puede utilizar para todos los campos de formulario do_action( "wpforms_process_validate_{$field_type}", $field_id, $field_submit, $form_data ).

Es importante tener en cuenta que los valores de los campos no se sanitizan hasta más tarde en el procesamiento, en wpforms_process_format_{$field_type}.

Ejemplos

En este ejemplo que se muestra a continuación, la función comprobará el campo de formulario Casillas de verificación para un número mínimo de opciones que deben seleccionarse.

/*
 * 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 );



Referencia del artículo: Cómo establecer un número mínimo de opciones para una casilla de verificación