do_action( 'wpforms_display_submit_before', array $form_data )

Descrição

A ação wpforms_display_submit_before é executada imediatamente antes de o elemento do botão de submissão ser exibido.

Parâmetros

$form_data

(array) Configurações/dados do formulário processados, preparados para serem usados posteriormente.

Origem

wpforms/src/Frontend/Frontend.php

Mais Informações

A ação é executada dentro da div do container do botão de submissão do formulário, logo antes do elemento do botão de submissão.

Por exemplo, pode usar este hook para adicionar saída HTML antes do botão de submissão.

Como alternativa, pode usar o wpforms_display_submit_after para exibir algo depois do botão Submeter no formulário.

Exemplos

No nosso trecho de código de exemplo, verificaremos primeiro se o ID do formulário é igual a 5. Se for, um link para um vídeo será exibido logo antes do botão Submeter do formulário.

Apenas lembre-se de alterar o ID do formulário de 5 para corresponder ao ID específico do formulário no qual pretende executar o seu código. Remover esta linha de código executaria para todos os formulários.

Se precisar de ajuda para encontrar o ID do seu formulário, pode rever este tutorial.

/**
 * Action that fires immediately before the submit button element is displayed.
 * 
 * @link  https://wpforms.com/developers/wpforms_display_submit_before/
 * 
 * @param array  $form_data Form data and settings
 */

function wpf_dev_display_submit_before( $form_data ) {
 
    // Only run on my form with ID = 5
    if ( absint( $form_data[ 'id' ] ) !== 5 ) {
            return;
        } 
 		
    // Run code or see example echo statement below.
    _e( '<div class="track-click"> <a href="https://www.youtube.com/watch?v=eiQ3viAGung" data-rel="lightbox">Click here for a special video announcement!</a>.</div>', 'plugin-domain' );

}
add_action( 'wpforms_display_submit_before', 'wpf_dev_display_submit_before', 10, 1 );