Este artigo faz parte da série Adapte seu banner para cada versão do seu site.
Antes de seguir o guia abaixo, certifique-se de ter consultado o artigo de apresentação geral Escolha o método adequado para carregar o banner Axeptio correto.
Através do idioma do navegador:
// Modifique o valor 000000000000000 pelo seu id
window.axeptioSettings = { clientId: '000000000000000', cookiesVersion: { type: "browser_locale", cases: {
default: "-en", "fr-FR": "-fr",
"it-IT": "-it", } }};(function(d, s) { var t = d.getElementsByTagName(s)[0], e = d.createElement(s); e.async = true; e.src = "//static.axept.io/sdk.js"; t.parentNode.insertBefore(e, t);})(document, "script");
Através de uma função personalizada:
Por exemplo, com base no parâmetro "lang" da página
// Modifique o valor 000000000000000 pelo seu id
window.axeptioSettings = {
clientId: '000000000000000',
cookiesVersion: {
type: "custom_function",
config: {
function: () => {
return document.documentElement.lang;
}
},
cases: {
default: "-en",
"fr-FR": "-fr",
"it-IT": "-it",
}
}
};
(function(d, s) {
var t = d.getElementsByTagName(s)[0], e = d.createElement(s);
e.async = true; e.src = "//static.axept.io/sdk.js";
t.parentNode.insertBefore(e, t);
})(document, "script");
O nome da versão a ser informado para cada caso (nos exemplos acima: "-en", "-fr", "-it") pode ser encontrado aqui:
Caso especial de sites sem recarga: gerenciar a atualização dinâmica da configuração do Axeptio
Caso especial de sites sem recarga: gerenciar a atualização dinâmica da configuração do Axeptio
Em alguns sites modernos, como aplicativos de página única (SPA) onde a alteração de idioma não recarrega a página, o banner Axeptio permanece congelado no idioma inicial.
Para gerenciar esse caso, é possível usar uma função JavaScript do SDK Axeptio que permite alterar o idioma do widget instantaneamente, sem recarregar a página.
Esta manipulação requer um pouco de código e é destinada a um público com conhecimentos técnicos. Para a maioria dos sites clássicos onde o idioma está vinculado à URL e causa uma recarga, esta etapa não é necessária.
No local onde você altera seu idioma em Javascript, você precisará adicionar a função Axeptio axeptioSDK.setCookiesVersion() para alterar a versão do widget dinamicamente.
Esta função recebe como parâmetro o identificador da versão a ser carregada.
Por exemplo, tenho aqui três versões:
Os identificadores das minhas três versões são "it-version", "fr-version" e "en-version".
Se traduzir meu site para italiano, precisarei apenas chamar a função axeptioSDK.setCookiesVersion('it-version').