Você tem interesse em criar uma Smart Tag personalizada para aprimorar a funcionalidade de seus formulários? Se você pretende integrar uma Smart Tag personalizada, como incorporar um link para download em uma notificação por e-mail ou mensagem de confirmação, o processo é simples com um snippet de código personalizado. Neste guia, vamos orientá-lo nas etapas para aproveitar o PHP para criar uma Smart Tag personalizada.
As Smart Tags servem como um meio conveniente de buscar dinamicamente dados específicos em campos de formulário ou e-mails de notificação. O WPForms oferece uma infinidade de Smart Tags incorporadas, capazes de extrair informações como o URL da página atual ou o endereço de e-mail de um usuário conectado, entre outras. Para uma compreensão abrangente das Smart Tags predefinidas no WPForms, consulte nossa documentação.
Criação da Smart Tag personalizada
No exemplo a seguir, demonstraremos como criar uma nova Smart Tag personalizada, projetada especificamente para exibir um URL para um link de download depois que um formulário for concluído. O processo envolve duas funções PHP, cada uma com uma finalidade distinta.
A primeira função é responsável pela criação da Smart Tag. Ela foi projetada de forma que apenas alterações básicas de nome sejam necessárias para personalizá-la para qualquer outra Smart Tag.
A segunda função é onde a maior parte do código será implementada. Dentro da função if você precisará adicionar qualquer código necessário para buscar o(s) valor(es) que deseja que essa Smart Tag exiba.
Para começar, basta copiar e colar as duas funções em seu site, certificando-se de personalizar o nome da Smart Tag conforme necessário. Se você não tiver certeza de onde ou como adicionar snippets ao seu site, consulte este tutorial.
/**
* Register the Smart Tag so it will be available to select in the form builder.
*
* @link https://wpforms.com/developers/how-to-create-a-custom-smart-tag/
*/
function wpf_dev_register_smarttag( $tags ) {
// Key is the tag, item is the tag name.
$tags[ 'download_link' ] = 'Download Link';
return $tags;
}
add_filter( 'wpforms_smart_tags', 'wpf_dev_register_smarttag', 10, 1 );
/**
* Process the Smart Tag.
*
* @link https://wpforms.com/developers/how-to-create-a-custom-smart-tag/
*/
function wpf_dev_process_smarttag( $content, $tag ) {
// Only run if it is our desired tag.
if ( 'download_link' === $tag ) {
// Replace our link in this demo with the URL you wish to provide
$link = 'https://yoursite.com/file.pdf';
// Replace the tag with our link.
$content = str_replace( '{download_link}', $link, $content );
}
return $content;
}
add_filter( 'wpforms_smart_tag_process', 'wpf_dev_process_smarttag', 10, 2 );
Observação: os nomes de Smart Tag podem conter apenas letras latinas minúsculas, dígitos e um sublinhado.
Criando o formulário
Em seguida, vamos criar um formulário de boletim informativo simples. Quando os usuários se inscrevem em nosso boletim informativo, nosso objetivo é fornecer a eles um link gratuito para baixar um eBook. Isso serve como uma excelente ilustração do aproveitamento dos recursos das Smart Tags do WPForms. Depois que essa Smart Tag for estabelecida, você poderá incorporá-la sem esforço em qualquer criação de formulário futura sem a necessidade de ajustes adicionais no código.
Para obter ajuda sobre como criar um formulário, consulte esta documentação.
Usando a nova Smart Tag personalizada
Agora, vamos colocar em prática nossa Smart Tag personalizada recém-criada. Neste tutorial, incorporaremos a Smart Tag do nosso link de download em nossas notificações por e-mail.
Para começar, navegue até o construtor de formulários e clique em Settings (Configurações) e, em seguida, selecione Notifications (Notificações). Nas configurações de Notificações, role para baixo até a caixa Mensagem de e-mail. Clique no link Show Smart Tags e navegue pelas Smart Tags disponíveis até localizar a Smart Tag Download Link. Basta selecioná-la, e ela será automaticamente adicionada ao modelo de notificação.
PERGUNTAS FREQUENTES
Posso criar uma Smart Tag para adicionar dinamicamente a localidade atual do site?
Sim, você pode criar uma Smart Tag personalizada para recuperar a localidade atual do seu site (por exemplo, "fr", "de", "en"). Veja como você pode implementar isso:
/**
* Register the Smart Tag so it will be available to select in the form builder.
*
* @link https://wpforms.com/developers/how-to-create-a-custom-smart-tag/
*/
function wpf_dev_register_smarttag( $tags ) {
// Key is the tag, item is the tag name.
$tags[ 'page_locale' ] = 'Get Locale';
return $tags;
}
add_filter( 'wpforms_smart_tags', 'wpf_dev_register_smarttag', 10, 1 );
/**
* Process the Smart Tag.
*
* @link https://wpforms.com/developers/how-to-create-a-custom-smart-tag/
*
* WordPress get_locale(): https://developer.wordpress.org/reference/functions/get_locale/
*/
function wpf_dev_process_smarttag( $content, $tag ) {
// Only run if it is our desired tag.
if ( 'page_locale' === $tag ) {
// Stores the locale returned by the get_locale() function in the variable $locale
$locale = get_locale();
// Replace the tag with the $locale variable value.
$content = str_replace( '{page_locale}', $locale, $content );
}
return $content;
}
add_filter( 'wpforms_smart_tag_process', 'wpf_dev_process_smarttag', 10, 2 );
Esse snippet cria uma nova Smart Tag chamada 'Get Locale' (Obter localidade) usando o recurso WordPress get_locale() função.
Depois de adicionar o snippet, você pode usar o comando {page_locale} Smart Tag em seus formulários, notificações por e-mail ou mensagens de confirmação.
E é isso! Você criou com sucesso uma nova Smart Tag personalizada. Você gostaria de poder processar essa Smart Tag personalizada em um campo de formulário HTML? Nesse caso, dê uma olhada em nosso artigo sobre Como processar Smart Tags em campos HTML.