Descrição
O wpforms_display_submit_after é acionada logo após 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.
- Botão
- (string) Tipo de botão, por exemplo, `submit`, `next`.
Fonte
wpforms/src/Frontend/Frontend.php
Mais informações
O gancho é acionado na div do contêiner do botão de envio do formulário, depois que o elemento do botão de envio é exibido.
Por exemplo, você pode usar esse gancho para adicionar o HTML que é exibido após o botão Enviar no formulário.
Como alternativa, você poderia usar o wpforms_display_submit_before para exibir algo antes do botão Enviar.
O wpforms_display_submit_before aceita apenas um parâmetro, que é o botão Submit. Portanto, esse hook específico só estaria vinculado ao botão Submit e não aos botões Next ou Previous page.
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 após o 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. A remoção dessa verificação seria executada para todos os formulários.
Se precisar de ajuda para encontrar o ID do formulário, consulte 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 );