Resumo de IA
Descrição
A ação wpforms_frontend_output_after é disparada após um formulário ser exibido no front-end do site, somente se o formulário existir e contiver campos.
Parâmetros
- $form_data
- (array) Configurações/dados do formulário processados, preparados para uso posterior.
- $form
- (WP_Post) Objeto do tipo post do formulário.
Fonte
wpforms/src/Frontend/Frontend.php
Mais Informações
Embora wpforms_frontend_output_after só dispare para formulários válidos e não vazios, ele é executado após o processo de renderização da saída.
Uma ação alternativa a ser considerada é wpforms_frontend_output_before, pois ela funciona de forma semelhante, exceto que dispara apenas antes do formulário ser exibido.
Exemplos
Um exemplo de uso desta ação em particular pode ser exibir um link logo após o botão Enviar no formulário.
Apenas lembre-se de alterar o ID do formulário de 731 para corresponder ao ID específico do formulário em que você deseja executar seu código, bem como o diretório de imagens (se estiver chamando uma imagem) para corresponder à estrutura do seu tema.
Se precisar de ajuda para encontrar o ID do seu formulário, revise este tutorial.
/**
* Output something after your form(s).
*
* @link https://wpforms.com/developers/wpforms_frontend_output_after/
*
* @param array $form_data Form data and settings.
* @param object $form Form post type object.
*/
function wpf_dev_frontend_output_after( $form_data, $form ) {
// Optional, you can limit to specific forms. Below, we restrict output to
// form #731.
if ( absint( $form_data[ 'id' ] ) !== 731 ) {
return;
}
// Run code or see the example echo statement below.
_e( 'Click here for our Black Friday Offers! <a href="http://yourlinkurl.com/black-friday" target="_blank">Check out our Black Friday deals!</a>.', 'plugin-domain' );
}
add_action( 'wpforms_frontend_output_after', 'wpf_dev_frontend_output_after', 10, 2 );