Descrição
O wpforms_display_submit_before é acionada imediatamente antes de o elemento do botão de envio ser exibido.
Parâmetros
- $form_data
- (array) Configurações/dados de formulários processados, preparados para serem usados posteriormente.
Fonte
wpforms/src/Frontend/Frontend.php
Mais informações
A ação é acionada na div do contêiner do botão de envio do formulário, logo antes do elemento do botão de envio.
Por exemplo, você pode usar esse gancho para adicionar uma saída HTML antes do botão de envio.
Como alternativa, você pode usar o wpforms_display_submit_after para exibir algo após o botão Enviar no formulário.
Exemplos
Em nosso trecho de código de exemplo, verificaremos primeiro se o ID do formulário é igual a 5. Se for o caso, um link para um vídeo será exibido logo antes do botão Enviar botão.
Lembre-se apenas de alterar o ID do formulário de 5 para corresponder ao ID do formulário específico no qual você deseja executar o código. Removendo essa linha do código, o código será executado para todos os formulários.
Se precisar de ajuda para encontrar o ID do formulário, consulte 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 );