Resumo de IA
Você tem interesse em criar uma Smart Tag personalizada para aprimorar a funcionalidade dos seus formulários? Se você imagina 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 trecho de código personalizado. Neste guia, vamos guiá-lo pelas etapas para usar o PHP na criação de uma Smart Tag sob medida.
As Smart Tags servem como um meio conveniente para buscar dinamicamente dados específicos em campos de formulário ou e-mails de notificação. O WPForms oferece uma infinidade de Smart Tags integradas, capazes de extrair informações como o URL da página atual ou o endereço de e-mail de um usuário logado, entre outros. Para uma compreensão abrangente das Smart Tags predefinidas no WPForms, consulte nossa documentação.
Criando a Smart Tag personalizada
No exemplo abaixo, demonstraremos como criar uma nova Smart Tag personalizada projetada especificamente para exibir um URL para um link de download assim que um formulário for concluído. O processo envolve duas funções PHP, cada uma servindo a um propósito distinto.
A primeira função é responsável por criar a Smart Tag. Ela é 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 instrução if, você precisará adicionar qualquer código necessário para buscar os valores que você gostaria que esta Smart Tag exibisse.
Para começar, basta copiar e colar ambas as funções em seu site, garantindo a personalização do nome da Smart Tag conforme necessário. Se você não tem certeza de onde ou como adicionar trechos ao seu site, confira 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 das Smart Tags podem conter apenas letras latinas minúsculas, dígitos e um sublinhado apenas.
Criando o formulário
Em seguida, vamos criar um formulário de newsletter simples. Quando os usuários se inscreverem em nossa newsletter, nosso objetivo é fornecer a eles um link de cortesia para baixar um eBook. Isso serve como uma excelente ilustração do aproveitamento dos recursos das Smart Tags do WPForms. Assim que esta Smart Tag for estabelecida, você poderá incorporá-la sem esforço em quaisquer criações futuras de formulários, sem a necessidade de ajustes adicionais de código.
Para qualquer assistência sobre como criar um formulário, revise esta documentação.
Usando a nova Smart Tag personalizada
Agora, vamos colocar nossa Smart Tag personalizada recém-criada em uso. Neste tutorial, incorporaremos a Smart Tag para nosso Link de Download em nossas Notificações por e-mail.
Para começar, navegue até o construtor de formulários e clique em Configurações, depois selecione Notificações. Dentro das configurações de Notificações, role para baixo até a caixa Mensagem de E-mail. Clique no link Mostrar Smart Tags e navegue pelas Smart Tags disponíveis até localizar a Smart Tag Link de Download. Simplesmente selecione-a, e ela será adicionada automaticamente 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 );
Este trecho cria uma nova Smart Tag chamada ‘Get Locale’ usando a função get_locale() do WordPress.
Após adicionar o trecho, você pode usar a Smart Tag {page_locale} 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 dentro de um campo de formulário HTML? Se sim, confira nosso artigo sobre Como Processar Smart Tags em Campos HTML.