Hreflang Manager: etiquetas hreflang multilingues e multiloja
Instalar, configurar, pré-visualizar e auditar as etiquetas hreflang do PrestaShop, sem override.
Apresentação
O Hreflang Manager escreve as etiquetas <link rel="alternate" hreflang> das suas páginas para indicar à Google as versões linguísticas e regionais de uma mesma página. Escreve apenas um conjunto por página, exclusivamente nas páginas canónicas e indexáveis, e apenas para as versões que existem realmente.
Compatível com PrestaShop 1.7.8 a 9.x, loja única e multiloja (um ou vários domínios). A versão 2.0.0 não contém nenhum override e não modifica nenhum ficheiro do tema.

Novidades da versão 2.0
- Sem override: o módulo funciona com hooks. O override de FrontController da 1.0.0 é removido na atualização.
- Um único conjunto de etiquetas: escrito na variável do tema ou através do hook displayHeader, com uma salvaguarda que remove os duplicados.
- Versões verificadas: nada para um produto inativo, não traduzido ou ausente de uma loja; nada nas páginas 404, páginas noindex, listas filtradas e combinações.
- Back office redesenhado: assistente de configuração, mapa idioma × país → loja, pré-visualização das etiquetas, auditoria com pontuação, deteção de conflitos, modo de teste.
- Sitemap XML hreflang opcional, cache por página, compatibilidade com PrestaShop 1.7.8 e interface em 8 idiomas.
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 abre em Parâmetros da loja > Tráfego e SEO > Hreflang Manager.
- Enquanto não houver nenhuma versão configurada, o módulo não altera nada nas suas páginas. Inicie o Assistente de configuração.
A atualização a partir da 1.0.0 mantém as suas versões e os seus grupos. Os valores mal escritos são corrigidos quando a correção é inequívoca (en_UK passa a en-GB, fr_BE passa a fr-BE), é mantido um único x-default por grupo, o antigo override é removido pelo procedimento do PrestaShop e o menu passa para Tráfego e SEO. É apresentado um relatório na vista geral.
Em multiloja, instale o módulo no contexto «Todas as lojas» e verifique se está ativado em cada loja de um grupo: caso contrário, as páginas dessa loja não remetem para as outras versões e a Google ignora os pares. O detetor de conflitos assinala esta situação.
Assistente de configuração
O assistente lê as suas lojas, os respetivos domínios (HTTP ou HTTPS), o país e os idiomas ativos, e propõe um valor hreflang para cada par loja e idioma:
- um idioma vendido numa única loja recebe apenas o idioma (
fr): destina-se a todos os falantes desse idioma; - um idioma vendido em várias lojas recebe o país de cada loja (
fr-FR,fr-BE) para que a Google mostre a loja correta; - o x-default proposto é o idioma principal da loja predefinida.
Os valores são verificados durante a introdução. Nada muda nas suas páginas antes de guardar.

Versões, grupos e mapa
Cada linha é uma versão: uma loja, um idioma, um valor hreflang, uma origem pública opcional (se a loja for servida noutro domínio), um interruptor de ativação e a escolha do x-default. Uma única versão x-default por grupo.
O mapa idioma × país → loja mostra que loja serve que mercado. As versões a cinzento não são impressas (inativas, ou idioma desativado na loja).
Os grupos ligam lojas que remetem umas para as outras. O conteúdo é emparelhado por id (catálogo partilhado) ou apenas por mapeamento manual (catálogos separados). O mapeamento liga dois ids de um produto, de uma categoria, de uma página CMS, de uma marca ou de um fornecedor; funciona nos dois sentidos e mantém-se coerente em todo o grupo.

Regras aplicadas
O módulo segue as diretrizes do Google Search Central sobre versões localizadas:
- URL absolutos com o protocolo e o domínio de cada loja; espaços e caracteres não permitidos codificados.
- Autorreferência e ligações de retorno: cada versão lista todas as outras e a si própria, com o mesmo conjunto em todas as versões.
- Códigos válidos: idioma ISO 639-1, país ISO 3166-1 alfa-2 opcional, sistema de escrita ISO 15924 opcional.
en-UK, os underscores, um país isolado oues-419são recusados com uma sugestão. - Apenas versões existentes: produto ativo e visível, categoria ativa e acessível aos visitantes, página CMS ativa e indexável, marca ou fornecedor ativo, traduzidos no idioma de destino.
- Apenas páginas canónicas e indexáveis: nenhuma etiqueta nas páginas 404, páginas noindex, listas filtradas ou ordenadas, URL de combinação, carrinho, conta e pesquisa, nem quando a etiqueta canonical indica outro endereço.
- Paginação: a página 2 de uma categoria aponta para a página 2 das outras versões (configurável).
Pré-visualização das etiquetas
Introduza um URL da sua loja ou escolha um exemplo (página inicial, produto, categoria, página 2, página CMS). O módulo lê a página a partir do servidor e apresenta o diagnóstico (página canónica, noindex, versão ausente…), cada etiqueta com a respetiva verificação e, lado a lado, o head esperado e o head efetivamente impresso. Apenas podem ser lidos os domínios da sua instalação.


Auditoria
A auditoria lê uma amostra de páginas dos seus próprios domínios (página inicial, produtos, categorias com página 2, páginas CMS, marcas, fornecedores, outras páginas), cada uma em todas as suas versões, e verifica: resposta 200, indexável, etiqueta canonical, valores, URL absolutos, autorreferência, ligações de retorno, duplicados, x-default e um único conjunto por página. Apresenta uma pontuação, os erros e avisos agrupados por regra com a correção a aplicar, o histórico das auditorias e uma exportação CSV.
Executada com o módulo em «Desativado», a auditoria avalia as etiquetas nativas do PrestaShop: a captura abaixo mostra esse resultado numa loja de demonstração (ligações de retorno em falta nas páginas 2, x-default ausente).

A auditoria não recorre a nenhum serviço externo e lê apenas os endereços declarados nas suas lojas. Se o servidor não conseguir aceder ao seu próprio domínio (Docker, NAT, DNS local), o pedido passa pela interface local do servidor com o mesmo nome de anfitrião.
Conflitos e outras fontes
A vista geral lista o que pode produzir etiquetas hreflang além do módulo, sem nunca alterar as respetivas definições:
- o tema (o Classic, o Hummingbird e a maioria dos temas imprimem
$urls.alternative_langs); - o DataFirefly All in One SEO, se a opção «Gerir hreflang» estiver ativa: a salvaguarda mantém um único conjunto e um botão executa o Hreflang Manager em último lugar;
- os sitemaps do DataFirefly Sitemap ou da suite SEO que contenham alternativas;
- os outros módulos que contenham código hreflang, o antigo override da 1.0.0, um módulo desativado numa loja do grupo, as lojas servidas em HTTP.
O botão Verificar as páginas iniciais agora lê a página inicial de cada loja como um visitante e conta as etiquetas e os duplicados.
Definições
- Estado: ativo, modo de teste (visitantes e motores de pesquisa mantêm as etiquetas de origem, apenas a pré-visualização e a auditoria veem as novas) ou desativado.
- Onde imprimir as etiquetas: automático (variável do tema se o tema a imprimir, caso contrário hook displayHeader), variável do tema ou hook.
- Salvaguarda contra duplicados e remoção das etiquetas do PrestaShop onde o módulo não as imprime (404, noindex, listas filtradas…).
- Paginação, respeito pela etiqueta canonical, outras páginas com versões (mais vendidos, novidades, promoções, contacto, lojas físicas, listas de marcas e de fornecedores) e páginas de módulos autorizadas (module/controller).
- Sitemap XML hreflang: opcional, um por loja, no endereço
/module/datafireflyhreflang/sitemap. Cada endereço lista todas as suas versões comxhtml:link, incluindo ele próprio. Declare-o no Google Search Console ou no robots.txt. - Cache: as alternativas de uma página são calculadas uma vez e depois lidas numa única consulta; são recalculadas quando um produto, uma categoria, uma página CMS, uma marca ou um fornecedor é guardado, e integralmente quando uma versão, um grupo, um idioma ou uma loja é alterado.

Se o DataFirefly Sitemap ou a suite SEO também incluírem hreflang no respetivo sitemap, declare apenas um desses sitemaps à Google, ou verifique se indicam o mesmo.
Segurança e permissões
- Cada modificação exige a permissão «Editar» no separador Hreflang Manager e o token de segurança do back office; um perfil só de leitura pode consultar, pré-visualizar e exportar.
- A pré-visualização e a auditoria recusam qualquer endereço fora dos domínios da loja (sem acesso a um URL arbitrário).
- Os URL impressos no head são escapados; a exportação CSV neutraliza as células que começam por
=,+,-ou@.
Desinstalação
A desinstalação elimina as 6 tabelas do módulo (versões, grupos, lojas dos grupos, mapeamento, cache, auditorias), as respetivas definições e o separador. Não há ficheiros do tema nem overrides a limpar.
Resolução de problemas
Nenhuma etiqueta numa página
Abra a pré-visualização nesse URL: o diagnóstico indica o motivo (página noindex, filtrada, de combinação, canonical para outro endereço, versão única, idioma sem versão, modo de teste…).
Etiquetas duplicadas
Ative a salvaguarda contra duplicados e consulte «Conflitos e outras fontes»: um módulo ou o tema imprime as suas próprias etiquetas.
Ligações de retorno em falta na auditoria
Uma versão está inativa apenas de um lado, o módulo está desativado numa loja do grupo, ou uma cache de página completa serve uma página antiga. Limpe a cache do módulo (Definições) e a da loja.