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

Descrição

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

Parâmetros

$form_data

(array) Configurações/dados do formulário processados, preparados para uso posterior.

$button

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

Fonte

wpforms/src/Frontend/Frontend.php

Mais Informações

O hook é disparado dentro da div do container do botão de envio do formulário, após o elemento do botão de envio ser exibido.

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

Como alternativa, você pode usar o wpforms_display_submit_before para exibir algo antes do botão Enviar.

Exemplos

Em nosso trecho de código de exemplo, primeiro verificaremos 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 Enviar do formulário.

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

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