Atualizar dinamicamente a cadeia de caracteres do placeholder na caixa de pesquisa com base na localidade

Visão geral

A caixa de pesquisa em sua Central de Ajuda pode especificar uma cadeia de placeholders como "Pesquisar em nossos documentos". Você pode alterar dinamicamente a cadeia de caracteres do placeholder com base na localidade do usuário com JavaScript ou jQuery. O exemplo a seguir usa jQuery.

Condições

• Se u modelo da Central de Ajuda usa a palavra-chave{{search}}auxiliar da linguagem de modelos da Central de Ajuda
• Você tem acesso ao HTML do placeholder de entrada de pesquisa da sua Central de Ajuda
• Você tem permissões suficientes para editar e personalizar o tema da sua Central de Ajuda
• Você tem uma instância da Central de Ajuda em diversos idiomas
• Você espera que os clientes visitem sua instância da Central de Ajuda de vários locais e idiomas
• Você está utilizando uma linguagem de script para verificar a localidade na URL da Central de Ajuda e atualizar o HTML

Procedimento

Este artigo tem o objetivo de demonstrar uma opção para verificar a localidade da Central de Ajuda e exibir o placeholder de entrada da pesquisa no idioma correto.

No momento, as URLs da Central de Ajuda mostram as localidades de maneira uniforme. Isso torna possível fazer referência à localidade a partir da própria URL usando uma linguagem de script como JavaScript e atualizar dinamicamente o placeholder de entrada da pesquisa.

O jQuery não é fornecido por padrão. Importe uma biblioteca jQuery se desejar usar instruções jQuery em um tema no lugar de Vanilla JavaScript. Consulte ConsulteImportação ou atualização do jQuerypara obter mais informações.

Observação: Como esse código personalizado é uma dica para ajudar nos fluxos de trabalho, esse código não é oficialmente garantido ou suportado pela Zendesk

// THIS SCRIPT IS CHECKING FOR EN-US, ES, AND PT-BR LOCALES
// IF NONE OF THESE THREE ARE FOUND, THE SCRIPT WILL USE SYSTEM STRING

// GET CURRENT BROWSER LOCATION URL
var currLoc = window.location.href;
// SPLIT GUIDE URL BY FORWARD SLASHES 
// AND ASSIGN ALL PIECES TO AN ARRAY INDEX
var currLocArr = currLoc.split("/");

// CHECK IF USER IS AUTHENTICATED TO SHOW NAME IN PLACEHOLDER
// IF NOT AUTHENTICATED THEN SHOW DIFFERENT STRING 
if (HelpCenter.user.name !== null){
 if (currLocArr[4].includes("en-us")){
 $("form.search input[type=search]").attr('placeholder',"Hi, "+ HelpCenter.user.name+", how can we help?");
 } else if (currLocArr[4].includes("es")){
 $("form.search input[type=search]").attr("placeholder", "Hola, "+ HelpCenter.user.name+", cómo podemos ayudarle?");
 } else if (currLocArr[4].includes("pt-br")){
 $("form.search input[type=search]").attr("placeholder", "Olá, " + HelpCenter.user.name+", como podemos ajudá-lo");
 } else {
 console.log("locale not available for search input placeholder for authenticated user - reverting back to system string")
 }
} else if (HelpCenter.user.name === null){
 if (currLocArr[4].includes("en-us")){
 $("form.search input[type=search]").attr('placeholder',"Hi there! How can we help?");
 } else if (currLocArr[4].includes("es")){
 $("form.search input[type=search]").attr("placeholder", "Hola! Cómo podemos ayudarle?");
 } else if (currLocArr[4].includes("pt-br")){
 $("form.search input[type=search]").attr("placeholder", "Olá! Como podemos ajudá-lo");
 } else {
 console.log("locale not available for search input placeholder for unauthenticated user - reverting back to system string")
 }
} else {
 console.log("something went wrong with the script");
}

O script primeiro verifica se o usuário está autenticado. Se estiverem, o nome e o sobrenome serão incluídos no placeholder de entrada da pesquisa. Se eles não forem autenticados, seu nome não será incluído na cadeia de caracteres do placeholder de entrada da pesquisa.

Atualize o script para adicionar os locais que deseja incluir ou excluir em sua instância da Central de Ajuda.

Esteja ciente de que há outras técnicas a serem consideradas em um processo como esse. Por exemplo, você pode usar as configurações de idioma do navegador, também conhecidas como idioma do navegador, para detectar localidades do usuário na Central de Ajuda.

Para detectar se um usuário está autenticado ou não, você também pode considerar o uso do ponto de extremidade Exibir usuário autenticado no momento com uma chamada AJAXou Obter , em vez de usar o objeto Central de Ajuda.

Aviso sobre a tradução: este artigo foi traduzido por um software de tradução automática para oferecer a você uma compreensão básica do conteúdo. Medidas razoáveis foram tomadas para fornecer uma tradução precisa, no entanto, a Zendesk não garante a precisão da tradução.

Em caso de dúvidas relacionadas à precisão das informações contidas no artigo traduzido, consulte a versão oficial do artigo em inglês.