Ver Markdown

Descrição

A ação wpforms_process_validate_checkbox dispara a validação no campo de formulário Checkbox quando o formulário é enviado.

Parâmetros

$field_id
(int) ID do campo.
$field_submit
(array) Valor original bruto/não sanitizado do campo enviado para o campo.
$form_data
(array) Configurações/dados do formulário processados, preparados para uso posterior.

Fonte

wpforms/includes/class-process.php

Mais Informações

O filtro wpforms_process_validate_checkbox é aplicado a um array para o campo de formulário Checkbox. Esta função pode ser usada 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 dos campos não são higienizados até mais tarde no processamento, em wpforms_process_format_{$field_type}.o

Exemplos

Neste exemplo mostrado abaixo, a função verificará o campo de formulário Checkboxes para um número mínimo de opções a serem selecionadas.

/*
 * 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 um Checkbox

Ainda com dificuldades? Como podemos ajudar?
Última Atualização em 24 de Julho de 2023