Introdução
Gostaria de criar um URL de sítio Smart Tag? Talvez gostasse de reutilizar esta Smart Tag nas suas notificações por correio eletrónico ou mensagens de confirmação? Neste tutorial, vamos mostrar-lhe como pode criar uma Smart Tag para o URL do seu site, mas também como e onde colocá-la nas suas notificações.
Adicionar 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 );
Este snippet tem duas funções. A primeira é apenas registar que vamos criar uma Smart Tag chamada site_url, no entanto, o texto que veremos dentro do construtor de formulários para esta Smart Tag em particular é Site URL.
A segunda função irá procurar o URL do site atual com a função do WordPress get_site_url(); e depois passamos isso para dentro da função e atribuímos a variável $url dentro da Smart Tag.
Utilizar a etiqueta inteligente
Para efeitos desta documentação, estamos a colocar uma imagem de agradecimento dentro de cada notificação por correio eletrónico que os nossos visitantes recebem depois de preencherem o nosso formulário. Para isso, vamos ao separador Notificações e adicionamos isto depois da etiqueta inteligente {all_fields} na nossa mensagem de notificação.
Basta adicionar o link HTML e a fonte da imagem à sua mensagem de e-mail no separador 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 tag inteligente personalizada para começar a criar suas próprias tags inteligentes personalizadas.
FAQ
P: E se eu quiser utilizar isto dentro de um campo de formulário ou etiqueta HTML?
R: As etiquetas inteligentes podem ser utilizadas em muitas áreas por predefinição, como mensagens de confirmação, notificações por correio eletrónico, valor predefinido para determinados campos de formulário. No entanto, se pretender utilizar as etiquetas inteligentes dentro de etiquetas de campo ou num campo de formulário HTML, terá de 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 dentro de um campo de formulário HTML, consulte este tutorial.
Se pretender processar etiquetas inteligentes dentro de uma etiqueta de campo, não se esqueça de consultar este tutorial.
Sabia que também pode utilizar 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: Sem dúvida! Se quiser utilizar o permalink do post ou da página atual para preencher um campo, pode utilizar este 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 );
Relacionadas
Referências de filtros: