Résumé IA
Description
L'action wpforms_frontend_output_after se déclenche après l'affichage d'un formulaire sur le front-end du site, uniquement si le formulaire existe et contient des champs.
Paramètres
- $form_data
- (array) Paramètres/données du formulaire traités, préparés pour une utilisation ultérieure.
- $form
- (WP_Post) Objet du type de publication du formulaire.
Source
wpforms/src/Frontend/Frontend.php
Plus d'informations
Bien que wpforms_frontend_output_after ne se déclenche que pour les formulaires valides et non vides, il s'exécute après le processus de rendu de la sortie.
Une action alternative à considérer est wpforms_frontend_output_before, car elle fonctionne de manière similaire, sauf qu'elle ne se déclenche que avant l'affichage du formulaire.
Exemples
Un exemple d'utilisation de cette action particulière pourrait être d'afficher un lien juste après le bouton Envoyer sur le formulaire.
N'oubliez pas de changer l'ID du formulaire de 731 pour qu'il corresponde à l'ID spécifique du formulaire sur lequel vous souhaitez exécuter votre code, ainsi que le répertoire des images (si vous appelez une image) pour qu'il corresponde à la structure de votre thème.
Si vous avez besoin d'aide pour trouver l'ID de votre formulaire, veuillez consulter ce tutoriel.
/**
* 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 );