do_action( 'wpforms_display_submit_before', array $form_data )

Descrição

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

Parâmetros

$form_data

(array) Configurações/dados do formulário processados, preparados para uso posterior.

Fonte

wpforms/src/Frontend/Frontend.php

Mais Informações

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

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

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

Exemplos

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

Apenas lembre-se de alterar o ID do formulário de 5 para corresponder ao ID específico do formulário em que você deseja executar seu código. Remover esta linha de código faria com que ele fosse executado para todos os formulários.

Se você precisar de ajuda para encontrar o ID do seu formulário, você pode revisar 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 );