Descrição

O wpforms_process_validate_checkbox dispara a validação na ação Caixa de verificação campo do formulário quando o formulário é submetido.

Parâmetros

$field_id
(int) ID do campo.
$field_submit
(array) Valor de campo original em bruto/não higienizado apresentado para o campo.
$form_data
(matriz) Definições/dados de formulários processados, preparados para serem utilizados posteriormente.

Fonte

wpforms/includes/class-process.php

Mais informações

O wpforms_process_validate_checkbox é aplicado a uma matriz para Caixa de verificação campo de formulário. Esta função pode ser utilizada para todos os campos de formulário do_action( "wpforms_process_validate_{$field_type}", $field_id, $field_submit, $form_data ).

É importante notar que os valores de campo não são higienizados até mais tarde no processamento, em wpforms_process_format_{$field_type}.o

Exemplos

Neste exemplo apresentado abaixo, a função verifica o campo de formulário Checkboxes para um número mínimo de opções a selecionar.

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



Referência do artigo: Como definir um número mínimo de opções para uma caixa de seleção