Introdução
Você gostaria de criar um URL de site de Smart Tag? Talvez você queira reutilizar essa Smart Tag em suas notificações por e-mail ou mensagens de confirmação? Neste tutorial, mostraremos como você pode criar uma Smart Tag para o URL do seu site e também como e onde colocá-la em 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, não deixe de consultar 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 );
Esse snippet tem duas funções. A primeira é apenas registrar que vamos criar uma Smart Tag chamada site_url; no entanto, o texto que veremos dentro do construtor de formulários para essa Smart Tag específica é Site URL.
A segunda função procurará o URL do site atual com a função get_site_url() do WordPress e, em seguida, passaremos isso para dentro da função e atribuiremos a variável $url dentro da Smart Tag.
Usando a Smart Tag
Para os fins desta documentação, estamos colocando uma imagem de agradecimento dentro de cada notificação por e-mail que nossos visitantes recebem depois de preencherem nosso formulário. Para fazer isso, vamos até a guia Notifications (Notificações) e adicionaremos isso após a tag inteligente {all_fields} em nossa mensagem de notificação.
Basta adicionar o link HTML e a fonte da imagem à mensagem de e-mail na guia 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 as Smart Tags no WPForms. Confira nosso tutorial sobre Como criar uma Smart Tag personalizada para começar a criar suas próprias Smart Tags personalizadas.
PERGUNTAS FREQUENTES
P: E se eu quiser usar isso em um campo de formulário HTML ou em um rótulo?
R: As Smart Tags podem ser usadas em muitas áreas por padrão, como mensagens de confirmação, notificações por e-mail, valor padrão para determinados campos de formulário. Entretanto, se você quiser usar as Smart Tags dentro de rótulos de campo ou em um campo de formulário HTML, será necessário adicionar um snippet extra.
<a href="{site_url}" class="form_footer_logo"><img src="{site_url}/my-image.jpg" /></a>
Para obter mais informações sobre o snippet necessário para processar as Smart Tags em um campo de formulário HTML, consulte este tutorial.
Se você quiser processar as Smart Tags dentro de um rótulo de campo, não deixe de conferir este tutorial.
Você sabia que também pode usar as Smart Tags como opções para seu campo Checkbox? Você pode ver esse tutorial lendo esta documentação.
P: É possível truncar o URL?
R: Sem dúvida! Se quiser usar o permalink do post ou da página atual para preencher um campo, você pode utilizar esse snippet.
/**
* 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: