Vous souhaitez créer une étiquette intelligente personnalisée pour améliorer la fonctionnalité de vos formulaires ? Si vous envisagez d'intégrer une balise intelligente personnalisée, par exemple un lien de téléchargement dans une notification par courriel ou un message de confirmation, le processus est simple grâce à un extrait de code personnalisé. Dans ce guide, nous allons vous guider à travers les étapes de l'utilisation de PHP pour créer une balise intelligente personnalisée.
Les Smart Tags sont un moyen pratique de récupérer dynamiquement des données spécifiques dans les champs de formulaire ou les emails de notification. WPForms offre une pléthore de Smart Tags intégrés, capables d'extraire des informations telles que l'URL de la page courante ou l'adresse email d'un utilisateur connecté, entre autres. Pour une compréhension complète des Smart Tags prédéfinis dans WPForms, veuillez vous référer à notre documentation.
Création d'une étiquette intelligente personnalisée
Dans l'exemple ci-dessous, nous allons montrer comment créer une nouvelle balise intelligente personnalisée spécialement conçue pour afficher l'URL d'un lien de téléchargement une fois le formulaire rempli. Le processus implique deux fonctions PHP, chacune servant un objectif distinct.
La première fonction est responsable de la création de l'étiquette intelligente. Elle est conçue de manière à ce que seuls des changements de nom de base soient nécessaires pour l'adapter à n'importe quelle autre étiquette intelligente.
C'est dans la deuxième fonction que l'essentiel du code sera mis en œuvre. Dans la fonction if vous devrez ajouter le code nécessaire pour récupérer la ou les valeurs que vous souhaitez que cette balise intelligente affiche.
Pour commencer, il suffit de copier et de coller 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ù ou comment ajouter des snippets à votre site, consultez 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 des étiquettes intelligentes ne peuvent contenir que des lettres latines minuscules, des chiffres et un trait de soulignement.
Création du formulaire
Ensuite, créons un formulaire de newsletter simple. Lorsque les utilisateurs s'inscrivent à notre newsletter, nous souhaitons leur fournir un lien gratuit pour télécharger un livre électronique. Ceci est une excellente illustration de l'exploitation des capacités des Smart Tags de WPForms. Une fois que cette balise intelligente est établie, vous pouvez l'incorporer sans effort dans n'importe quelle création de formulaire future sans avoir besoin d'ajuster le code.
Pour obtenir de l'aide sur la création d'un formulaire, veuillez consulter cette documentation.
Utilisation de la nouvelle étiquette intelligente personnalisée
Utilisons maintenant notre Smart Tag personnalisée nouvellement créée. Dans ce tutoriel, nous allons incorporer la balise intelligente de notre lien de téléchargement dans nos notifications par courriel.
Pour commencer, accédez au générateur de formulaires et cliquez sur Paramètres, puis sélectionnez Notifications. Dans les paramètres des notifications, faites défiler vers le bas jusqu'à la boîte de message électronique. 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. Il suffit de la sélectionner pour qu'elle soit automatiquement ajoutée au modèle de notification.
FAQ
Puis-je créer une balise intelligente pour ajouter dynamiquement les paramètres régionaux du site web ?
Oui, vous pouvez créer une balise intelligente personnalisée pour récupérer la localisation actuelle de votre site web (par exemple, 'fr', 'de', 'en'). Voici comment vous pouvez mettre cela en œuvre :
/**
* 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 snippet crée une nouvelle balise intelligente appelée "Get Locale" en utilisant la balise WordPress get_locale() fonction.
Après avoir ajouté le snippet, vous pouvez utiliser la commande {page_locale} Smart Tag dans vos formulaires, notifications par courriel ou messages de confirmation.
Et c'est tout ! Vous avez créé avec succès une nouvelle étiquette intelligente personnalisée. Souhaitez-vous pouvoir traiter cette étiquette intelligente personnalisée dans un champ de formulaire HTML? Si c'est le cas, jetez un coup d'œil à notre article sur Comment traiter les Smart Tags dans les champs HTML.