Atenção!

Este artigo contém código PHP e destina-se a desenvolvedores. Oferecemos este código como uma cortesia, mas não fornecemos suporte para personalizações de código ou desenvolvimento de terceiros.

Para orientação extra, consulte o tutorial do WPBeginner sobre como adicionar código personalizado.

Dispensar

Como Criar e Usar a Smart Tag User-Agent

Introdução

Gostaria de criar uma Smart Tag de user-agent para saber de onde vêm seus visitantes? Esses dados podem facilitar muito as decisões futuras do seu site. Neste tutorial, vamos criar uma Smart Tag que preencherá automaticamente um Campo Oculto no seu formulário para capturar a origem dos seus envios.

Um User-Agent é uma informação que você pode obter do navegador para ver qual navegador, sistema operacional, dispositivo usado (desktop/mobile) etc.

Criando a Smart Tag de User-Agent

Primeiro, vamos adicionar o trecho de código que criará uma nova Smart Tag dentro do WPForms que podemos usar no construtor.

Se precisar de ajuda para adicionar trechos de código ao seu site, consulte este tutorial.

/** 
 * Register the User-Agent Smart Tag so it will be available to select in the form builder.
 *
 * @link   https://wpforms.com/developers/how-to-create-and-use-the-user-agent-smart-tag/
 */
 
//Create the Smart Tag to be used
function wpf_dev_register_smarttag( $tags ) {
 
    $tags[ 'user_agent' ] = 'User Agent';
   
    return $tags;
}
add_filter( 'wpforms_smart_tags', 'wpf_dev_register_smarttag' );
 
//Define what the Smart Tag is
function wpf_dev_custom_smarttags( $content, $tag ) {
 
    $user_agent = ! empty( $_SERVER[ 'HTTP_USER_AGENT' ] ) ? substr( $_SERVER[ 'HTTP_USER_AGENT' ], 0, 256 ) : '';
 
   if ( $tag === 'user_agent' ) {
      $content = str_replace( '{' . $tag . '}', $user_agent, $content );
   }
   return $content;
};
add_filter( 'wpforms_smart_tag_process', 'wpf_dev_custom_smarttags', 10, 2 );

No trecho, você notará que existem duas funções diferentes. Cada uma foi comentada para que você possa entender o que elas fazem. A primeira função criará a Smart Tag, esta é apenas a criação, no entanto, é apenas na segunda função que definimos o que a Smart Tag é, que neste caso é para obter o HTTP_USER_AGENT.

Criando o formulário

Em seguida, vamos criar um novo formulário para que possamos adicionar esta nova Smart Tag. Se precisar de alguma assistência na criação de um novo formulário, revise esta documentação.

Nosso formulário terá apenas alguns campos para o Nome e Endereço de E-mail e, em seguida, adicionaremos um Campo Oculto que conterá as informações que capturamos com a Smart Tag de user-agent.

comece criando um novo formulário e adicionando seus campos a ele, que incluirão pelo menos um campo oculto para armazenar os dados do user-agent na entrada

Usando a Smart Tag de User-Agent

Depois de adicionar seu Campo Oculto, clique no link Mostrar Smart Tags para abrir uma lista de Smart Tags que você pode adicionar no campo Valor Padrão.

Encontre a Smart Tag User Agent e selecione-a para inseri-la no Valor Padrão.

Adicione a Smart Tag de user-agent ao Valor Padrão do campo oculto

Visualizando o User-Agent

Ao visualizar suas entradas, você verá dentro do Campo Oculto todas as informações do usuário que foram capturadas.

Agora você pode visualizar os dados do user-agent capturados dentro do campo oculto ao visualizar a entrada.

E é só isso! Gostaria de criar mais Smart Tags personalizadas? Dê uma olhada em nosso artigo sobre Como Criar uma Smart Tag Personalizada.

Referências de Filtro: