Como Criar um URL de Site com Smart Tag

Introdução

Gostaria de criar um URL de site com Smart Tag? Talvez você queira reutilizar este Smart Tag em suas notificações por e-mail ou mensagens de confirmação? Neste tutorial, mostraremos como criar um Smart Tag para o URL do seu site, mas também como e onde colocá-lo dentro de suas notificações.

Adicionando o Snippet

Para começar, vamos adicionar nosso snippet ao site primeiro. Se precisar de ajuda sobre como e onde adicionar snippets, por favor, revise esta documentação útil.

/**
 * 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 );

Este snippet tem duas funções. A primeira é apenas registrar que vamos criar um Smart Tag chamado site_url, no entanto, o texto que veremos dentro do construtor de formulários para este Smart Tag específico é URL do Site.

A segunda função procurará o URL do site atual com a função do WordPress get_site_url(); e, em seguida, passaremos isso para dentro da função e atribuiremos a variável $url dentro do Smart Tag.

Usando o Smart Tag

Para fins desta documentação, estamos colocando uma imagem de agradecimento em cada notificação por e-mail que nossos visitantes recebem após preencher nosso formulário. Para fazer isso, iremos para a aba Notificações e adicionaremos isso após o Smart Tag {all_fields} em nossa mensagem de notificação.

Basta adicionar seu link HTML e a origem da imagem à sua Mensagem de E-mail na sua aba Notificações.

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

E é isso! Há muito que você pode fazer com Smart Tags no WPForms. Confira nosso tutorial sobre Como Criar um Smart Tag Personalizado para começar a criar seus próprios Smart Tags personalizados.

Perguntas Frequentes

P: E se eu quisesse usar isso dentro de um campo de formulário HTML ou Rótulo?

R: Smart Tags podem ser usados em muitas áreas por padrão, como mensagens de confirmação, notificações por e-mail, Valor Padrão para certos campos de formulário. No entanto, se você quisesse usar Smart Tags dentro de rótulos de campo ou em um campo de formulário HTML, haverá um snippet extra que você pode precisar adicionar.

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

Para mais informações sobre o snippet necessário para processar Smart Tags dentro de um campo de formulário HTML, por favor, revise este tutorial.

Se você quiser processar Smart Tags dentro de um rótulo de campo, certifique-se de conferir este tutorial.

Você sabia que também pode usar Smart Tags como opções para o seu campo Checkbox? Você pode ver esse tutorial lendo esta documentação.

P: É possível truncar o URL?

R: Com certeza! Se você quiser usar o permalink da postagem ou página atual para preencher um campo, você pode usar este snippet em vez disso.

/**
 * 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 );

Relacionado

Referências de Filtro:

• wpforms_tags_inteligentes
• wpforms_processar_tag_inteligente