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.
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.

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
- Em Módulos > Gestor de módulos, clique em Carregar um módulo e envie o ficheiro ZIP.
- O módulo cria um destino por cada par loja e idioma ativo e abre no Assistente de configuração.
- 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.
- 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.
- 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.
- Moedas: ativação da sugestão e lista dos países aos quais será proposta outra moeda.
- Aparência: estilo, cores e bandeiras, com pré-visualização em direto.
- Ativação: testar primeiro, pôr em produção ou manter em pausa.




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.

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.

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).

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.

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.

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.

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.

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.




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.