wpforms_process_validate_payment-single - Documentação do Desenvolvedor WPForms

do_action( 'wpforms_process_validate_payment-single', string|int $field_id, mixed $field_submit, array $form_data )

Ver Markdown

Descrição

A ação wpforms_process_validate_payment-single é disparada para cada campo de pagamento de Item Único enquanto o WPForms valida um formulário enviado, antes que qualquer valor de campo seja formatado e antes que a entrada seja salva.

parâmetro	tipo	descrição
`$field_id`	string\|int	ID do campo como uma string numérica.
`$field_submit`	misto	Valor do campo enviado (dados brutos). Para este campo, é a string de valor da solicitação, ou uma string vazia quando nada foi postado para o campo.
`$form_data`	array	Dados e configurações do formulário.

Mais Informações

O WPForms_Process::process() percorre cada campo em $form_data['fields'] e chama do_action( "wpforms_process_validate_{$field_type}", $field_id, $field_submit, $this->form_data ) para cada um. Este hook é a instância para o tipo de campo payment-single. Ele é disparado em cada envio de um formulário que contém o campo, quer o visitante o tenha preenchido ou não. O arquivo fica em includes/, então ele é disparado no Lite e no Pro.

Este hook é uma instância de do_action( "wpforms_process_validate_{$field_type}", $field_id, $field_submit, $form_data ). Outras instâncias são wpforms_process_validate_payment-checkbox para o campo Itens de Caixa de Seleção e wpforms_process_validate_email para o campo Email.

A classe do campo registra seu próprio validate() neste hook na prioridade 10 com três argumentos. Ele adiciona o erro de campo obrigatório. Em seguida, a menos que o filtro wpforms_forms_fields_payment_single_field_validate_amount retorne false, ele verifica o valor: um item de preço fixo deve postar um valor igual ao preço configurado, e um item Definido pelo Usuário não pode postar um valor negativo ou um valor abaixo da configuração de Preço Mínimo do campo.

$field_submit é a string bruta postada. Execute-a através de wpforms_sanitize_amount() antes de compará-la como um número. Para rejeitar o envio, escreva uma mensagem em wpforms()->obj( 'process' )->errors[ $form_data['id'] ][ $field_id ]. O filtro wpforms_process_initial_errors é executado nos erros coletados após o loop; a Lógica Condicional o utiliza para descartar erros de campos ocultos.

Fonte

wpforms/includes/class-process.php

Exemplo

Aplique um valor mínimo em um campo de Item Único Definido pelo Usuário que carrega a classe CSS set-minimum, e interrompa o envio com um erro abaixo do campo quando o valor for menor.

/**
 * Enforce a minimum amount on a User Defined Single Item field.
 *
 * @link https://wpforms.com/developers/wpforms_process_validate_payment-single/
 *
 * @param string|int $field_id     Field ID.
 * @param mixed      $field_submit Submitted field value (raw data).
 * @param array      $form_data    Form data and settings.
 */
function wpf_dev_process_validate_payment_single( $field_id, $field_submit, $form_data ) {

    // Only run on my form with ID = 143, remember to change this to match your form ID.
    if ( absint( $form_data['id'] ) !== 143 ) {
        return;
    }

    // Only run on fields that have the CSS class "set-minimum" in the field's Advanced tab.
    $classes = explode( ' ', $form_data['fields'][ $field_id ]['css'] ?? '' );

    if ( ! in_array( 'set-minimum', $classes, true ) ) {
        return;
    }

    $minimum_amount = 5;

    if ( (float) wpforms_sanitize_amount( $field_submit ) < $minimum_amount ) {
        wpforms()->obj( 'process' )->errors[ $form_data['id'] ][ $field_id ] = sprintf(
            /* translators: %s - minimum amount. */
            esc_html__( 'Minimum amount is %s.', 'wpforms' ),
            wpforms_format_amount( $minimum_amount, true )
        );
    }
}
add_action( 'wpforms_process_validate_payment-single', 'wpf_dev_process_validate_payment_single', 10, 3 );