Résumé IA
Souhaitez-vous créer une balise intelligente personnalisée pour améliorer la fonctionnalité de vos formulaires ? Si vous envisagez d'intégrer une balise intelligente personnalisée, telle que l'intégration d'un lien téléchargeable dans une notification par e-mail ou un message de confirmation, le processus est simple avec un extrait de code personnalisé. Dans ce guide, nous vous expliquerons comment utiliser PHP pour créer une balise intelligente sur mesure.
Les balises intelligentes servent de moyen pratique pour récupérer dynamiquement des données spécifiques dans les champs de formulaire ou les e-mails de notification. WPForms propose une pléthore de balises intelligentes intégrées, capables d'extraire des informations telles que l'URL de la page actuelle ou l'adresse e-mail d'un utilisateur connecté, entre autres. Pour une compréhension complète des balises intelligentes prédéfinies dans WPForms, veuillez consulter notre documentation.
Création de la balise intelligente personnalisée
Dans l'exemple ci-dessous, nous vous montrerons comment créer une nouvelle balise intelligente personnalisée spécifiquement conçue pour afficher une URL de lien de téléchargement une fois qu'un formulaire est complété. Le processus implique deux fonctions PHP, chacune servant un objectif distinct.
La première fonction est responsable de la création de la balise intelligente. Elle est conçue de telle sorte que seuls des changements de nom de base sont nécessaires pour la personnaliser pour toute autre balise intelligente.
La seconde fonction est là où la majeure partie du code sera implémentée. Dans l'instruction if, vous devrez ajouter tout code nécessaire pour récupérer la ou les valeurs que vous souhaitez que cette balise intelligente affiche.
Pour commencer, copiez et collez simplement les deux fonctions sur votre site Web, en veillant à personnaliser le nom de la balise intelligente si nécessaire. Si vous ne savez pas où ni comment ajouter des extraits à votre site, veuillez consulter ce tutoriel.
/**
* Register the Smart Tag so it will be available to select in the form builder.
*
* @link https://wpforms.com/developers/how-to-create-a-custom-smart-tag/
*/
function wpf_dev_register_smarttag( $tags ) {
// Key is the tag, item is the tag name.
$tags[ 'download_link' ] = 'Download Link';
return $tags;
}
add_filter( 'wpforms_smart_tags', 'wpf_dev_register_smarttag', 10, 1 );
/**
* Process the Smart Tag.
*
* @link https://wpforms.com/developers/how-to-create-a-custom-smart-tag/
*/
function wpf_dev_process_smarttag( $content, $tag ) {
// Only run if it is our desired tag.
if ( 'download_link' === $tag ) {
// Replace our link in this demo with the URL you wish to provide
$link = 'https://yoursite.com/file.pdf';
// Replace the tag with our link.
$content = str_replace( '{download_link}', $link, $content );
}
return $content;
}
add_filter( 'wpforms_smart_tag_process', 'wpf_dev_process_smarttag', 10, 2 );
Remarque : Les noms de balises intelligentes ne peuvent contenir que des lettres latines minuscules, des chiffres et un trait de soulignement uniquement.
Création du formulaire
Ensuite, créons un formulaire de newsletter simple. Lorsque les utilisateurs s'inscrivent à notre newsletter, nous visons à leur fournir un lien gratuit pour télécharger un eBook. Cela sert d'excellente illustration de l'exploitation des capacités des balises intelligentes WPForms. Une fois cette balise intelligente établie, vous pouvez l'intégrer sans effort dans toute création de formulaire future sans avoir besoin d'ajustements de code supplémentaires.
Pour toute aide sur la façon de créer un formulaire, veuillez consulter cette documentation.
Utilisation de la nouvelle balise intelligente personnalisée
Maintenant, mettons en œuvre notre balise intelligente personnalisée nouvellement créée. Dans ce tutoriel, nous intégrerons la balise intelligente pour notre lien de téléchargement dans nos notifications par e-mail.
Pour commencer, accédez au générateur de formulaires et cliquez sur Paramètres, puis sélectionnez Notifications. Dans les paramètres de Notifications, faites défiler jusqu'à la zone Message e-mail. Cliquez sur le lien Afficher les balises intelligentes et parcourez les balises intelligentes disponibles jusqu'à ce que vous trouviez la balise intelligente Lien de téléchargement. Sélectionnez-la simplement et elle sera automatiquement ajoutée au modèle de notification.
FAQ
Puis-je créer une balise intelligente pour ajouter dynamiquement la locale actuelle du site web ?
Oui, vous pouvez créer une balise intelligente personnalisée pour récupérer la locale actuelle de votre site web (par exemple, 'fr', 'de', 'en'). Voici comment vous pouvez l'implémenter :
/**
* Register the Smart Tag so it will be available to select in the form builder.
*
* @link https://wpforms.com/developers/how-to-create-a-custom-smart-tag/
*/
function wpf_dev_register_smarttag( $tags ) {
// Key is the tag, item is the tag name.
$tags[ 'page_locale' ] = 'Get Locale';
return $tags;
}
add_filter( 'wpforms_smart_tags', 'wpf_dev_register_smarttag', 10, 1 );
/**
* Process the Smart Tag.
*
* @link https://wpforms.com/developers/how-to-create-a-custom-smart-tag/
*
* WordPress get_locale(): https://developer.wordpress.org/reference/functions/get_locale/
*/
function wpf_dev_process_smarttag( $content, $tag ) {
// Only run if it is our desired tag.
if ( 'page_locale' === $tag ) {
// Stores the locale returned by the get_locale() function in the variable $locale
$locale = get_locale();
// Replace the tag with the $locale variable value.
$content = str_replace( '{page_locale}', $locale, $content );
}
return $content;
}
add_filter( 'wpforms_smart_tag_process', 'wpf_dev_process_smarttag', 10, 2 );
Ce extrait crée une nouvelle balise intelligente appelée 'Get Locale' en utilisant la fonction WordPress get_locale().
Après avoir ajouté l'extrait, vous pouvez utiliser la balise intelligente {page_locale} dans vos formulaires, notifications par e-mail ou messages de confirmation.
Et voilà ! Vous avez créé avec succès une nouvelle balise intelligente personnalisée. Souhaitez-vous pouvoir traiter cette balise intelligente personnalisée dans un champ de formulaire HTML ? Si oui, consultez notre article sur Comment traiter les balises intelligentes dans les champs HTML.