Como Criar um URL de Site de Etiqueta Inteligente

Introdução

Gostaria de criar um URL de site com Smart Tag? Talvez queira reutilizar este Smart Tag nas 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 o colocar nas suas notificações.

Adicionar o Trecho

Para começar, vamos adicionar primeiro o nosso snippet ao site. Se precisar de ajuda sobre como e onde adicionar snippets, por favor, reveja 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 está apenas a registar 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 em particular é Site URL.

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.

Utilizar o Smart Tag

Para efeitos desta documentação, estamos a colocar uma imagem de agradecimento em cada notificação por e-mail que os nossos visitantes recebem após preencherem o nosso formulário. Para fazer isto, iremos para o separador Notificações e adicionaremos isto depois do Smart tag {all_fields} na nossa mensagem de notificação.

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

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

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

FAQ

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

R: Os Smart Tags podem ser usados em muitas áreas por defeito, como mensagens de confirmação, notificações por e-mail, Valor Padrão para certos campos de formulário. No entanto, se quisesse usar Smart Tags dentro de rótulos de campo ou num campo de formulário HTML, haverá um snippet adicional que poderá precisar de 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, reveja este tutorial.

Se quisesse processar Smart Tags dentro de um rótulo de campo, certifique-se de consultar este tutorial.

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

P: É possível truncar o URL?

R: Absolutamente! Se quiser usar o permalink do post ou página atual para preencher um campo, pode utilizar 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 Filtros:

• wpforms_smart_tags
• wpforms_smart_tag_process