Description
Le wpforms_display_submit_after se déclenche juste après l'affichage du bouton de soumission.
Paramètres
- $form_data
- (tableau) Paramètres/données de formulaire traités, préparés pour être utilisés ultérieurement.
- bouton
- (chaîne) Type de bouton, par exemple `submit`, `next`.
Source
wpforms/src/Frontend/Frontend.php
Plus d'informations
Le crochet se déclenche dans la div conteneur du bouton de soumission du formulaire, après l'affichage de l'élément bouton de soumission.
Par exemple, vous pouvez utiliser ce crochet pour ajouter le code HTML qui s'affiche après le bouton Submit (Soumettre) du formulaire.
Vous pouvez également utiliser la fonction wpforms_display_submit_before pour afficher quelque chose avant le bouton Submit.
La fonction wpforms_display_submit_before n'accepte qu'un seul paramètre, à savoir le bouton Submit. Ainsi, ce crochet particulier ne serait lié qu'au bouton Submit et non aux boutons Page suivante ou Page précédente.
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 l'icône du formulaire. Soumettre bouton.
N'oubliez pas de changer l'ID du formulaire de 5 pour qu'il corresponde à l'identifiant spécifique du formulaire sur lequel vous souhaitez exécuter votre code. Si vous supprimez cette vérification, le code sera exécuté pour tous les formulaires.
Si vous avez besoin d'aide pour trouver l'identifiant 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 );