Attention !

Cet article contient du code PHP et est destiné aux développeurs. Nous fournissons ce code à titre de courtoisie, mais nous n'offrons pas de support pour les personnalisations de code ou le développement tiers.

Pour obtenir de l'aide supplémentaire, veuillez consulter le tutoriel de WPBeginner sur l'ajout de code personnalisé.

Ignorer

Description

L'action wpforms_display_submit_after se déclenche juste après l'affichage de l'élément du bouton de soumission.

Paramètres

$form_data
(array) Paramètres/données du formulaire traités, préparés pour une utilisation ultérieure.
$bouton
(string) Type de bouton, par exemple `submit`, `next`.

Source

wpforms/src/Frontend/Frontend.php

Plus d'informations

Le hook se déclenche dans la div conteneur du bouton de soumission du formulaire, après l'affichage de l'élément du bouton de soumission.

À titre d'exemple, vous pouvez utiliser ce hook pour ajouter du HTML qui est généré après le bouton Soumettre sur le formulaire.

Alternativement, vous pourriez utiliser wpforms_display_submit_before pour afficher quelque chose avant le bouton Soumettre.

Le wpforms_display_submit_before n'accepte qu'un seul paramètre, qui est le bouton Soumettre. Par conséquent, ce hook particulier serait uniquement lié au bouton Soumettre et non aux boutons de page Suivant ou Précédent.

Exemples

Dans notre exemple de code, nous allons d'abord vérifier si l'ID du formulaire est égal à 5. Si c'est le cas, un lien vers une vidéo s'affichera juste après le bouton Soumettre du formulaire.

N'oubliez pas de changer l'ID du formulaire de 5 pour qu'il corresponde à l'ID spécifique du formulaire sur lequel vous souhaitez exécuter votre code. La suppression de cette vérification s'appliquerait à tous les formulaires.

Si vous avez besoin d'aide pour trouver l'ID de votre formulaire, vous pouvez consulter ce tutoriel.

/**
 * 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 );