Descrição
O wpforms_display_submit_after é activada logo após 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.
- botão
- (string) Tipo de botão, por exemplo, `submeter`, `próximo`.
Fonte
wpforms/src/Frontend/Frontend.php
Mais informações
O hook é ativado na div do contentor do botão de submissão do formulário, depois de o elemento do botão de submissão ser apresentado.
Como exemplo, pode utilizar este gancho para adicionar HTML que é emitido após o botão Submeter no formulário.
Como alternativa, pode utilizar a função wpforms_display_submit_before para apresentar algo antes do botão Enviar.
O wpforms_display_submit_before aceita apenas um parâmetro, que é o botão Enviar. Portanto, este hook específico só estaria ligado ao botão Submit e não através dos botões Next ou Previous page.
Exemplos
No nosso trecho de código de exemplo, vamos verificar primeiro se o ID do formulário é igual a 5. Se for o caso, será apresentada uma hiperligação para um vídeo logo após 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 seu código. Removendo essa verificação, 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 just after the submit button element is displayed.
*
* @link https://wpforms.com/developers/wpforms_display_submit_after/
*
* @param array $form_data Form data and settings.
* @param string $button Button type, e.g. `submit`, `next`.
*/
function wpf_dev_display_submit_after( $form_data, $button ) {
if ( $button !== 'submit' ) {
return;
}
// Only run on my form with ID = 5
if ( absint( $form_data['id'] ) !== 1145 ) {
return;
}
// Display a link to a YouTube video after the submit button.
_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_after', 'wpf_dev_display_submit_after', 10, 2 );