Comment créer une URL de site Smart Tag

Introduction

Souhaitez-vous créer une URL de site Smart Tag ? Peut-être souhaitez-vous réutiliser ce Smart Tag dans vos notifications par e-mail ou vos messages de confirmation ? Dans ce tutoriel, nous vous montrerons comment créer un Smart Tag pour l'URL de votre site, mais aussi comment et où le placer dans vos notifications.

Ajout de l'extrait

Pour commencer, nous allons d'abord ajouter notre extrait de code au site. Si vous avez besoin d'aide sur comment et où ajouter des extraits de code, veuillez consulter cette documentation utile.

/**
 * Process the Smart Tag.
 *
 * @link   https://wpforms.com/developers/how-to-create-a-smart-tag-for-site-url/
 */

function wpf_dev_register_site_smarttag( $tags ) {

    // Key is the tag, item is the tag name.
    $tags[ 'site_url' ] = 'Site URL';

    return $tags;
}
add_filter( 'wpforms_smart_tags', 'wpf_dev_register_site_smarttag', 10, 1 );

/**
 * Process the Smart Tag.
 *
 * @link   https://wpforms.com/developers/how-to-create-a-smart-tag-for-site-url/
 */

function wpf_dev_process_site_url_smarttag( $content, $tag ) {

    // Only run if it is our desired tag.
    if ( 'site_url' === $tag ) {

        // Assign the site URL to the $url variable
        $url = get_site_url();

        // Replace the tag with our link.
        $content = str_replace( '{site_url}', $url, $content );

    }

    return $content;
}
add_filter( 'wpforms_smart_tag_process', 'wpf_dev_process_site_url_smarttag', 10, 2 );

Cet extrait de code a deux fonctions. La première enregistre simplement que nous allons créer un Smart Tag appelé site_url, cependant, le texte que nous verrons dans le générateur de formulaires pour ce Smart Tag particulier est URL du site.

La seconde fonction recherchera l'URL du site actuelle avec la fonction WordPress get_site_url();, puis nous la passerons dans la fonction et assignerons la variable $url à l'intérieur du Smart Tag.

Utilisation du Smart Tag

Dans le cadre de cette documentation, nous plaçons une image de remerciement dans chaque notification par e-mail que nos visiteurs reçoivent après avoir rempli notre formulaire. Pour ce faire, nous irons dans l'onglet Notifications et ajouterons ceci après le Smart Tag {all_fields} dans notre message de notification.

Ajoutez simplement votre lien HTML et la source de votre image à votre Message e-mail dans votre onglet Notifications.

<a href="{site_url}" class="form_footer_logo"><img src="{site_url}/my-image.jpg" /></a>

Et voilà ! Vous pouvez faire tellement de choses avec les Smart Tags dans WPForms. Consultez notre tutoriel sur Comment créer un Smart Tag personnalisé pour commencer à créer vos propres Smart Tags personnalisés.

FAQ

Q : Que se passe-t-il si je veux l'utiliser dans un champ de formulaire HTML ou une étiquette ?

R : Les Smart Tags peuvent être utilisés par défaut dans de nombreux domaines tels que les messages de confirmation, les notifications par e-mail, la Valeur par défaut pour certains champs de formulaire. Cependant, si vous souhaitez utiliser des Smart Tags dans les étiquettes de champ ou dans un champ de formulaire HTML, un extrait de code supplémentaire pourrait être nécessaire.

<a href="{site_url}" class="form_footer_logo"><img src="{site_url}/my-image.jpg" /></a>

Pour plus d'informations sur l'extrait de code nécessaire pour traiter les Smart Tags dans un champ de formulaire HTML, veuillez consulter ce tutoriel.

Si vous souhaitez traiter les Smart Tags dans une étiquette de champ, assurez-vous de consulter ce tutoriel.

Saviez-vous que vous pouvez également utiliser les Smart Tags comme options pour votre champ Case à cocher ? Vous pouvez consulter ce tutoriel en lisant cette documentation.

Q : Est-il possible de tronquer l'URL ?

R : Absolument ! Si vous souhaitez utiliser le permalien de l'article ou de la page actuelle pour remplir un champ, vous pouvez utiliser cet extrait de code à la place.

/**
 * Process the Smart Tag.
 *
 * @link   https://wpforms.com/developers/how-to-create-a-smart-tag-for-site-url/
 */

function wpf_dev_register_site_smarttag( $tags ) {

    // Key is the tag, item is the tag name.
    $tags[ 'permalink' ] = 'Permalink';

    return $tags;
}
add_filter( 'wpforms_smart_tags', 'wpf_dev_register_site_smarttag', 10, 1 );

/**
 * Process the Smart Tag.
 *
 * @link   https://wpforms.com/developers/how-to-create-a-smart-tag-for-site-url/
 */

function wpf_dev_process_site_url_smarttag( $content, $tag ) {

    // Only run if it is our desired tag.
    if ( 'permalink' === $tag ) {

        // Assign the site URL to the $url variable
	$url = substr( get_permalink(), strlen( home_url('/') ) );

        // Replace the tag with our link.
        $content = str_replace( '{permalink}', $url, $content );

    }

    return $content;
}
add_filter( 'wpforms_smart_tag_process', 'wpf_dev_process_site_url_smarttag', 10, 2 );

Articles associés

Références de filtre :

• wpforms_smart_tags
• wpforms_smart_tag_process