Descrição

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

Parâmetros

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

Fonte

wpforms/includes/class-process.php

Mais informações

O wpforms_process_validate_checkbox é aplicado a uma matriz para Caixa de seleção campo de formulário. Essa 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 observar que os valores de campo não são higienizados até o final do processamento, em wpforms_process_format_{$field_type}.o

Exemplos

No 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 uma caixa de seleção

Ainda está preso? Como podemos ajudar?
Última atualização em 24 de julho de 2023