PS PrestaShop Iniciante

Detetar o idioma e o país do visitante (sem redirecionamento)

Instalar, configurar e testar a sugestão de idioma, moeda e loja, sem redirecionamento.

Atualizado Versão do módulo 2.0.0

Apresentação

O módulo deteta o país do visitante e os idiomas do navegador e propõe, num banner não bloqueante, a mesma página no idioma, na moeda ou na loja certos. Nunca redireciona: o visitante mantém o controlo, os rastreadores recebem a página que pediram e as suas etiquetas hreflang ficam como estão.

Compatível com PrestaShop 1.7.8 a 9.x, loja única, multiloja e multidomínio. Nada é carregado na loja quando esta tem um único idioma e uma única moeda.

Barra inferior: a um visitante português na loja francesa é proposta a mesma página em português, sem redirecionamento
Barra inferior

Novidades da versão 2.0

  • Assistente de configuração em cinco passos, com os países pré-preenchidos para cada idioma.
  • Modo de teste: o banner só aparece no seu próprio navegador, aberto com uma ligação assinada válida por 24 horas.
  • Sugestão de moeda: a um visitante que ainda vê a moeda predefinida é proposta a moeda do seu país, quando vende nessa moeda.
  • Cabeçalhos CDN de confiança: um cabeçalho só é usado depois de o escolher, opcionalmente limitado aos endereços do seu CDN.
  • Base de dados integrada fixa e verificada (impressão digital SHA-256), fontes de deteção reordenáveis, carregamento de ficheiros .mmdb.
  • Novos estilos (barra superior ou inferior, toast, caixa de diálogo acessível), verificação do contraste, bandeiras reservadas aos países.
  • Estatísticas protegidas contra repetição (token de utilização única, limite por hora) e recusas contabilizadas por país.

Instalação e atualização

  1. Em Módulos > Gestor de módulos, clique em Carregar um módulo e envie o ficheiro ZIP.
  2. O módulo cria um destino por cada par loja e idioma ativo e abre no Assistente de configuração.
  3. Após uma instalação nova, o módulo fica em modo de teste: os seus visitantes não veem nada até o pôr em produção.

A atualização a partir da 1.0, 1.1 ou 1.2 mantém os seus destinos, textos, cores e estatísticas. Duas alterações intencionais: nenhum cabeçalho CDN é usado até o confirmar em Geolocalização (um aviso indica-lhe quando é recebido um), e a sugestão de moeda permanece desativada até a ativar.

Numa configuração multiloja, instale o módulo no contexto «Todas as lojas» e verifique se está ativado em cada loja de destino: é ele que memoriza a escolha do visitante à chegada.

Assistente de configuração

O assistente reúne em cinco passos o que é preciso configurar no início. Pode ignorá-lo e voltar a abri-lo a qualquer momento a partir do respetivo separador.

  1. Deteção: número de lojas, idiomas e moedas, cabeçalho de país recebido pela loja, módulo do servidor web, ficheiro MaxMind e base de dados integrada.
  2. Idiomas e países: para cada destino, os países onde o idioma é falado são pré-preenchidos (GB, US, IE, CA, AU… para o inglês). Ajuste-os antes de guardar.
  3. Moedas: ativação da sugestão e lista dos países aos quais será proposta outra moeda.
  4. Aparência: estilo, cores e bandeiras, com pré-visualização em direto.
  5. Ativação: testar primeiro, pôr em produção ou manter em pausa.
Assistente de configuração, passo 1: lojas, idiomas e moedas ativos, fontes de deteção do país e instalação da base verificada
Assistente de configuração, passo 1
Assistente, passo 2: países pré-preenchidos para cada idioma (PT, BR, AO, MZ… para o português), editáveis antes de guardar
Assistente, passo 2
Assistente, passo 4: estilo (barra, notificação flutuante, diálogo), cores, bandeiras só para países e pré-visualização em direto
Assistente, passo 4
Assistente, passo 5: compromissos (sem redirecionamento, cache e hreflang preservados) e escolha entre testar primeiro, ativar ou deixar em pausa
Assistente, passo 5

Geolocalização

O idioma do navegador é sempre conhecido. O país serve para sugerir uma loja ou uma moeda. Estão disponíveis quatro fontes; prevalece a primeira que conhece o país e é o utilizador que define a ordem com as setas:

  • Cabeçalho do CDN (Cloudflare, CloudFront, Vercel, App Engine, Fastly ou X-Country-Code);
  • Módulo do servidor web (mod_geoip, mod_maxminddb, geoip2 do nginx);
  • Ficheiro MaxMind GeoLite2 ou GeoIP2, na localização do PrestaShop ou no caminho que indicar;
  • Base de dados integrada, instalada a partir do módulo.

O endereço IP só é usado para a pesquisa, em memória: nunca é guardado nem enviado a terceiros.

Qualquer pessoa pode enviar um cabeçalho como X-Country-Code. Escolha um apenas se todos os pedidos passarem por esse CDN e, de preferência, indique os endereços do CDN em Aceitar apenas a partir destes endereços. São comparados com o endereço que se liga ao servidor web, nunca com X-Forwarded-For.

Base de dados integrada

O botão Instalar a base transfere uma versão fixa da base geo-whois-asn-country do projeto ip-location-db (cerca de 7,5 MB, IPv4 e IPv6) a partir do jsDelivr, ou do unpkg em alternativa. Antes de substituir o ficheiro, o módulo verifica o tamanho exato e a impressão digital SHA-256; um ficheiro que não corresponda é rejeitado e a base atual é mantida. O ficheiro fica guardado em var/dflocalesuggest/, protegido do acesso web. A cópia anterior pode ser restaurada.

Estes dados são publicados sob a licença CC BY 4.0 (dados dos registos de internet NRO): a atribuição é obrigatória se voltar a publicar os dados. Como a distribuição npm do projeto já não é atualizada, é indicada a data dos dados: para maior precisão, prefira o cabeçalho do seu CDN ou um ficheiro MaxMind atualizado.

Fonte personalizada e carregamento de ficheiros

Em A sua própria base pode indicar o endereço HTTPS de um ficheiro .mmdb com a respetiva impressão digital SHA-256 (ou o endereço do ficheiro .sha256 publicado pela fonte); um ficheiro não verificado nunca é instalado. A atualização agendada é executada pelo cron do seu servidor com o endereço secreto apresentado, nunca por um visitante. Sem ligações de saída, carregue diretamente um ficheiro .mmdb.

Geolocalização: fontes por ordem, cabeçalho CDN de confiança limitado aos endereços do CDN, base integrada fixada com impressão SHA-256
Geolocalização

Correspondências

Cada linha é um par loja e idioma que o banner pode sugerir: etiqueta apresentada, países (códigos ISO, vazio = todos), idiomas do navegador (de, de-at, en-gb…) e ordem de desempate por arrastar e largar. Sugerir países preenche os destinos sem países e Adicionar os pares em falta cria as linhas das novas lojas ou idiomas.

A tabela Moedas lista os países cuja moeda está ativa nas suas lojas. Para cada um: automático (a moeda definida no país no PrestaShop ou, caso contrário, a moeda usada nesse país), uma moeda específica ou nunca sugerir.

Correspondências: pares loja e idioma com os seus países e idiomas do navegador, e moeda sugerida para cada país
Correspondências

Aparência

No computador: barra inferior, barra superior, toast à esquerda ou à direita, ou caixa de diálogo. No telemóvel: cartão flutuante, barras ou caixa de diálogo. Todos os estilos flutuam sobre a página: nada se mexe quando aparecem. A caixa de diálogo pede uma resposta antes de continuar; reserve-a para lojas em que estar na loja errada sai caro.

  • Cores: cinco temas e quatro cores livres. O contraste é calculado em direto e assinalado abaixo de 4,5:1.
  • Bandeiras: «Apenas países» (predefinição) mostra uma bandeira para uma loja ou uma moeda, nunca para um idioma.
  • Lembrete compacto, atraso de apresentação e durante quanto tempo «Ficar aqui» é memorizado (30 dias por predefinição, no armazenamento local do navegador, sem cookie).
Aparência: barra, notificação flutuante ou diálogo no computador e telemóvel, temas de cores, verificação de contraste e pré-visualização
Aparência

Textos

O banner é redigido no idioma sugerido: um visitante alemão lê-o em alemão na sua loja francesa. Uma sugestão apenas de moeda é redigida no idioma da página. Cada idioma tem as suas mensagens de idioma, loja e moeda, com as variáveis {language}, {country}, {store}, {currency} e {currency_name}. Um campo vazio usa o texto integrado.

Textos do banner por idioma: mensagens de idioma, loja e moeda, variáveis {language}, {country}, {store} e {currency}
Textos do banner por idioma

Regras

  • Idioma dentro de uma loja: decide o idioma do navegador; o país só serve para desempatar.
  • Entre lojas: prevalece o país (a loja que envia para o visitante, com os seus preços) ou prevalece o idioma.
  • Moeda: decide o país, apenas enquanto o visitante ainda vê a moeda predefinida.
  • Respeito pelos visitantes multilingues, ocultação para clientes com sessão iniciada, páginas sem banner (carrinho e finalização da compra por predefinição), espera pelo banner de consentimento, limite por hora das estatísticas, eventos do Google Tag Manager.
Regras: prioridade idioma do navegador e país, sem redirecionamento para robôs, cache preservada, espera do banner de consentimento
Regras

Testar antes de pôr em produção

O Simulador mostra, para uma página, um país e idiomas de navegador, o banner resultante, a respetiva ligação e a pontuação de cada destino. Fornece uma ligação de pré-visualização válida durante uma hora. Em modo de teste, abra uma vez a ligação de teste apresentada nas Estatísticas: o banner passa a aparecer nesse navegador durante 24 horas com a deteção real, e nada é contabilizado. Os visitantes não veem nada.

Simulador: visitante de Portugal com navegador em português na página francesa, banner obtido e pontuação de cada destino
Simulador

Estatísticas

Banners mostrados (uma vez por visita e sugestão), aceites, recusados, taxas de aceitação e de recusa, atividade diária, classificações por país, por destino e por tipo de sugestão, em 7, 30 ou 90 dias ou um ano, com exportação CSV. Cada banner é contabilizado uma única vez; os rastreadores e os pedidos repetidos são ignorados. Não é guardado nenhum endereço IP, cookie ou identificador de cliente.

Estatísticas de 30 dias (dados de demonstração): banners mostrados, aceites, recusados, por país, por destino e por tipo de sugestão
Estatísticas de 30 dias (dados de demonstração)

Do lado do visitante

  • Sem redirecionamento, nem para visitantes nem para rastreadores: a Google desaconselha redirecionar com base no idioma ou no endereço IP. Os rastreadores nunca veem o banner, que inclui data-nosnippet.
  • A ligação sugerida é a mesma página no outro idioma ou loja, idêntica à alternativa hreflang da página.
  • O HTML da página é o mesmo para todos; a sugestão chega num pedido separado que nunca fica em cache. O módulo funciona atrás de uma cache de página completa.
  • A barra e o toast não captam o foco; Escape fecha o banner; a caixa de diálogo mantém o foco no seu interior e devolve-o à página ao fechar.
Sugestão de moeda: a um visitante dos Estados Unidos que lê português é proposto ver os preços em dólares (USD)
Sugestão de moeda
Diálogo acessível: foco no botão principal, navegação por teclado dentro do diálogo, Esc ou clique fora para ficar
Diálogo acessível
No telemóvel: cartão flutuante em baixo, botões em largura total com pelo menos 44 px, sem deslocamento horizontal
No telemóvel
Multiloja e multidomínio: a um visitante do Reino Unido na loja francesa é proposta a UK Store, no seu próprio domínio
Multiloja e multidomínio

Para programadores

Eventos DOM em document: dfls:shown, dfls:accept, dfls:dismiss (com idioma, loja, país, tipo e moeda). Opção dataLayer para o Google Tag Manager. O hook PHP actionDflocalesuggestResponse recebe a resposta por referência; apenas são mantidos os URL das suas lojas.

Resolução de problemas

O banner não aparece

Verifique o estado (em pausa, em teste ou em produção), se pelo menos dois destinos são válidos ou se está ativa uma segunda moeda, se a página não está excluída e se este navegador ainda não recusou nem aceitou uma sugestão (limpe o armazenamento local do site). O simulador indica porque é que um destino é ignorado.

O país continua «Desconhecido»

É normal a partir de um IP local ou privado, ou sem nenhuma fonte de deteção. Abra o separador Geolocalização: mostra qual a fonte ativa e o país detetado para si.

A transferência da base de dados falha

A mensagem indica a causa: ligação de saída bloqueada (permita HTTPS para cdn.jsdelivr.net e unpkg.com, ou carregue o ficheiro), pasta sem permissão de escrita, extensão cURL em falta ou impressão digital não correspondente.

Esta página foi útil?

Ainda com dúvidas? Contacte o suporte