do_action( 'wpforms_display_submit_after', array $form_data, string $button )

Descrição

A ação wpforms_display_submit_after é executada logo após o elemento do botão de submissão ser exibido.

Parâmetros

$form_data

(array) Configurações/dados do formulário processados, preparados para serem usados posteriormente.

$button

(string) Tipo de botão, por exemplo, `submit`, `next`.

Origem

wpforms/src/Frontend/Frontend.php

Mais Informações

O hook é executado dentro da div do contentor do botão de submissão do formulário, após o elemento do botão de submissão ser exibido.

Como exemplo, pode usar este hook para adicionar HTML que é gerado após o botão Submeter no formulário.

Como alternativa, pode usar o wpforms_display_submit_before para exibir algo antes do botão Submeter.

Exemplos

No nosso exemplo de código, vamos primeiro verificar se o ID do formulário é igual a 5. Se for, um link para um vídeo será exibido logo após o botão Submeter do formulário.

Lembre-se de alterar o ID do formulário de 5 para corresponder ao ID específico do formulário no qual pretende executar o seu código. Remover essa verificação faria com que fosse executado para todos os formulários.

Se precisar de ajuda para encontrar o ID do seu formulário, pode rever 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 );