Está interessado em criar uma Smart Tag personalizada para melhorar a funcionalidade dos seus formulários? Se você pretende integrar uma Smart Tag personalizada, como incorporar um link para download em uma notificação por email 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 para obter dinamicamente dados específicos em campos de formulários ou e-mails de notificação. O WPForms oferece uma infinidade de Smart Tags embutidas, 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 outros. Para uma compreensão abrangente das Smart Tags pré-definidas no WPForms, consulte a nossa documentação.
Criar a Smart Tag personalizada
No exemplo abaixo, demonstraremos como criar uma nova Smart Tag personalizada especificamente concebida para apresentar um URL para uma hiperligação de transferência após a conclusão de um formulário. 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. Foi concebida de forma a que apenas sejam necessárias alterações básicas de nome para a personalizar para qualquer outra etiqueta inteligente.
A segunda função é onde a maior parte do código será implementada. Dentro da função if terá de adicionar qualquer código necessário para obter o(s) valor(es) que pretende que esta Smart Tag apresente.
Para começar, basta copiar e colar ambas as funções no seu site, certificando-se de personalizar o nome da Smart Tag conforme necessário. Se não tiver a 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 );
Nota: Os nomes das etiquetas inteligentes só podem conter letras latinas minúsculas, dígitos e um sublinhado.
Criar o formulário
Em seguida, vamos criar um formulário de boletim informativo simples. Quando os utilizadores se inscrevem na nossa newsletter, o nosso objetivo é fornecer-lhes um link gratuito para descarregar um livro eletrónico. Isto serve como uma excelente ilustração do aproveitamento das capacidades das Smart Tags do WPForms. Uma vez estabelecida esta Smart Tag, pode incorporá-la sem esforço em quaisquer futuras criações de formulários sem a necessidade de ajustes adicionais no código.
Para obter ajuda sobre como criar um formulário, consulte esta documentação.
Utilizar a nova etiqueta inteligente personalizada
Agora, vamos colocar 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 email.
Para começar, navegue até ao criador de formulários e clique em Definições e, em seguida, selecione Notificações. Nas definições de Notificações, desloque-se para baixo até à caixa Mensagem de correio eletrónico. Clique no link Mostrar Smart Tags e navegue pelas Smart Tags disponíveis até localizar a Smart Tag Link de download. Basta seleccioná-la e esta será automaticamente adicionada ao modelo de notificação.
FAQ
Posso criar uma Smart Tag para adicionar dinamicamente a localidade atual do sítio Web?
Sim, pode criar uma Smart Tag personalizada para obter a localidade atual do seu Web site (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' usando o WordPress get_locale() função.
Depois de adicionar o snippet, pode utilizar a função {page_locale} Smart Tag nos seus formulários, notificações por correio eletrónico ou mensagens de confirmação.
E pronto! Criou com êxito 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 etiquetas inteligentes em campos HTML.