# Hreflang Manager: etiquetas hreflang multilingues e multiloja

> Apresentação O Hreflang Manager escreve as etiquetas 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…

- Página: <https://www.datafirefly.com/pt/documentation/datafireflyhreflang/>
- Idioma: pt
- Atualizado em: 2026-11-14
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/datafireflyhreflang/index.md), [en](https://www.datafirefly.com/en/documentation/datafireflyhreflang/index.md), [es](https://www.datafirefly.com/es/documentation/datafireflyhreflang/index.md), [it](https://www.datafirefly.com/it/documentation/datafireflyhreflang/index.md), [nl](https://www.datafirefly.com/nl/documentation/datafireflyhreflang/index.md), [de](https://www.datafirefly.com/de/documentation/datafireflyhreflang/index.md), [pl](https://www.datafirefly.com/pl/documentation/datafireflyhreflang/index.md)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

## Apresentação

O Hreflang Manager escreve as etiquetas `` 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.

![Visão geral do Hreflang Manager: pontuação, versões ativas e deteção de conflitos (tema, SEO, sitemaps, override)](https://www.datafirefly.com/wp-content/uploads/2026/11/visao-geral-conflitos-datafireflyhreflang-pt.webp)

Visão geral do Hreflang Manager

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

1. Em **Módulos > Gestor de módulos**, clique em **Carregar um módulo** e envie o ficheiro ZIP.
2. O módulo abre em **Parâmetros da loja > Tráfego e SEO > Hreflang Manager**.
3. 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.

![Assistente de configuração: lojas, domínios e idiomas detetados, valores hreflang e x-default propostos](https://www.datafirefly.com/wp-content/uploads/2026/11/assistente-configuracao-datafireflyhreflang-pt.webp)

Assistente de configuração

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

![Versões e mapa idioma × país → loja, com validação dos códigos hreflang durante a escrita](https://www.datafirefly.com/wp-content/uploads/2026/11/versoes-mapa-idiomas-paises-datafireflyhreflang-pt.webp)

Versões e mapa idioma × país → loja, com validação dos códigos hreflang durante a escrita

## 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 ou `es-419` sã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.

![Pré-visualização das etiquetas de uma página de produto: etiquetas esperadas e apresentadas, cada alternativa verificada](https://www.datafirefly.com/wp-content/uploads/2026/11/pre-visualizacao-etiquetas-datafireflyhreflang-pt.webp)

Pré-visualização das etiquetas de uma página de produto

![Excerto do código-fonte da secção head: etiquetas hreflang esperadas e as apresentadas pela página](https://www.datafirefly.com/wp-content/uploads/2026/11/codigo-fonte-head-datafireflyhreflang-pt.webp)

Excerto do código-fonte da secção head

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

![Auditoria hreflang das etiquetas nativas do PrestaShop: pontuação, erros, avisos e correções sugeridas](https://www.datafirefly.com/wp-content/uploads/2026/11/auditoria-pontuacao-erros-datafireflyhreflang-pt.webp)

Auditoria hreflang das etiquetas nativas do PrestaShop

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 com `xhtml: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.

![Definições: saída única, proteção contra duplicados, paginação, sitemap XML hreflang e cache](https://www.datafirefly.com/wp-content/uploads/2026/11/definicoes-sitemap-cache-datafireflyhreflang-pt.webp)

Definições

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.
