Resumo de IA
Tem interesse em criar uma Smart Tag personalizada para otimizar a funcionalidade dos seus formulários? Se prevê a integração de uma Smart Tag personalizada, como a incorporação de um link para download numa 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 através dos passos para utilizar PHP na criação de uma Smart Tag à medida.
As Smart Tags servem como um meio conveniente para obter dinamicamente dados específicos em campos de formulário ou e-mails de notificação. O WPForms oferece uma abundância 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 utilizador com sessão iniciada, entre outras. Para uma compreensão abrangente das Smart Tags pré-definidas no WPForms, consulte a nossa documentação.
Criação da Smart Tag personalizada
No exemplo abaixo, demonstraremos como criar uma nova Smart Tag personalizada especificamente concebida 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 um propósito distinto.
A primeira função é responsável pela criação da Smart Tag. Foi concebida de forma a que apenas alterações básicas de nome sejam necessárias para a personalizar para qualquer outra Smart Tag.
A segunda função é onde a maior parte do código será implementada. Dentro da instrução if, terá de adicionar qualquer código necessário para obter o(s) valor(es) que pretende que esta Smart Tag exiba.
Para começar, basta copiar e colar ambas as funções no seu website, garantindo que personaliza o nome da Smart Tag conforme necessário. Se não tiver a certeza onde ou como adicionar trechos 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 );
Nota: Os nomes das Smart Tags podem conter apenas letras latinas minúsculas, dígitos e um sublinhado apenas.
Criação do formulário
Em seguida, vamos criar um formulário de newsletter simples. Quando os utilizadores se inscreverem na nossa newsletter, pretendemos fornecer-lhes um link de oferta para descarregar um eBook. Isto serve como uma excelente ilustração da utilização das capacidades das Smart Tags do WPForms. Assim que esta Smart Tag for estabelecida, pode incorporá-la sem esforço em quaisquer criações de formulários futuras sem a necessidade de ajustes de código adicionais.
Para qualquer assistência sobre como criar um formulário, reveja esta documentação.
Utilizar a nova Smart Tag personalizada
Agora, vamos colocar a nossa Smart Tag personalizada recém-criada em uso. Neste tutorial, vamos incorporar a Smart Tag para o nosso Link de Download nas nossas Notificações por e-mail.
Para começar, navegue para o construtor de formulários e clique em Definições, depois selecione Notificações. Dentro das definições de Notificações, percorra até à caixa de Mensagem de E-mail. Clique na ligação Mostrar Smart Tags e navegue pelas Smart Tags disponíveis até localizar a Smart Tag Link de Download. Basta selecioná-la e será automaticamente adicionada ao modelo de notificação.
FAQ
Posso criar uma Smart Tag para adicionar dinamicamente a localidade atual do website?
Sim, pode criar uma Smart Tag personalizada para obter a localidade atual do seu website (por exemplo, ‘fr’, ‘de’, ‘en’). Eis como pode implementar isto:
/**
* 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 snippet cria uma nova Smart Tag chamada ‘Get Locale’ utilizando a função get_locale() do WordPress.
Após adicionar o snippet, pode utilizar a Smart Tag {page_locale} nos seus formulários, notificações de e-mail ou mensagens de confirmação.
E é tudo! Criou com sucesso uma nova Smart Tag personalizada. Gostaria de poder processar essa Smart Tag personalizada dentro de um campo de formulário HTML? Se sim, consulte o nosso artigo sobre Como Processar Smart Tags em Campos HTML.