Descrição
O wpforms_display_submit_before é activada imediatamente antes de o elemento do botão de submissão ser apresentado.
Parâmetros
- $form_data
- (matriz) Definições/dados de formulários processados, preparados para serem utilizados posteriormente.
Fonte
wpforms/src/Frontend/Frontend.php
Mais informações
A ação é activada na div do contentor do botão de submissão do formulário, imediatamente antes do elemento do botão de submissão.
Por exemplo, pode utilizar este gancho para adicionar uma saída HTML antes do botão de submissão.
Como alternativa, pode utilizar a função wpforms_display_submit_after para apresentar algo depois do botão Enviar 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, será apresentada uma hiperligação para um vídeo imediatamente antes do 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 seu código. Removendo esta 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, pode consultar 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 );