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, apenas se o formulário existir e contiver campos.
Parâmetros
- $form_data
- (array) Configurações/dados do formulário processados, preparados para serem usados posteriormente.
- $form
- (WP_Post) Objeto do tipo post do formulário.
Origem
wpforms/src/Frontend/Frontend.php
Mais Informações
Enquanto wpforms_frontend_output_after só é disparada para formulários válidos e não vazios, ela executa após o processo de renderização da saída.
Uma ação alternativa a considerar é wpforms_frontend_output_before, pois funciona de forma semelhante, exceto que só é disparada antes da exibição do formulário.
Exemplos
Um exemplo de uso desta ação em particular pode ser exibir um link logo após o botão Submeter no formulário.
Apenas lembre-se de alterar o ID do formulário de 731 para corresponder ao ID específico do formulário no qual você deseja executar o seu código, bem como o diretório de imagens (se estiver a chamar uma imagem) para corresponder à estrutura do seu tema.
Se precisar de ajuda para encontrar o ID do seu formulário, reveja 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 );