# Páginas de Marca SEO: guia completo

> As Páginas de Marca SEO (dfbrandhub) transformam as páginas de fabricante nativas do PrestaShop num verdadeiro hub de marcas: um mural de logótipos A–Z com pesquisa instantânea e uma página…

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

As Páginas de Marca SEO (dfbrandhub) transformam as páginas de fabricante nativas do PrestaShop num verdadeiro hub de marcas: um mural de logótipos A–Z com pesquisa instantânea e uma página enriquecida por marca, com faixa, H1 personalizado, descrição longa, metadados SEO dedicados e a listagem de produtos nativa do seu tema. Este guia cobre a instalação, a configuração e o enriquecimento das suas marcas.

## Instalação

No seu back-office PrestaShop, vá a **Módulos → Gestor de módulos → Carregar um módulo** e envie o ficheiro ZIP do módulo. A instalação cria automaticamente as duas tabelas de dados, o separador **Brand Hub** no menu Catálogo e as rotas de URL predefinidas.

Não são necessárias dependências: o módulo não usa Composer nem bibliotecas JavaScript externas. É compatível com PrestaShop 8.0 a 9.x e PHP 8.1 no mínimo.

Depois da instalação, o seu mural de marcas fica imediatamente acessível no endereço /marques (slug configurável). Todas as marcas ativas já lá constam, sem qualquer ação da sua parte.

Os slugs predefinidos são franceses (`marques` e `marque`). Numa loja portuguesa, altere-os na configuração para `marcas` e `marca` antes de indexar as páginas, para não fixar URL franceses. Faça-o antes de as páginas serem descobertas pelo Google: uma alteração posterior obriga a esperar pela reindexação.

## Descoberta do mural de marcas

O mural apresenta todas as suas marcas ativas sob a forma de cartões com logótipo, agrupados por letra. As marcas cujo nome começa por um caractere não alfabético são agrupadas no fim do mural, sob o símbolo cardinal. Cada cartão mostra o logótipo do fabricante (ou uma inicial elegante, se não tiver logótipo), o nome da marca e, se a opção estiver ativa, o número de produtos.

### Pesquisa instantânea

O campo de pesquisa filtra os cartões à medida que escreve, sem recarregar a página. A pesquisa ignora os acentos: escrever «bea» encontra tanto «Béaba» como «Beaba».

### Navegação alfabética

A barra alfabética mantém-se visível durante o deslocamento (sticky). Um clique numa letra faz a página deslizar suavemente até à secção correspondente. As letras sem marcas ficam a cinzento e não são clicáveis.

### Marcas em destaque

As marcas assinaladas como «em destaque» no back-office aparecem numa faixa dedicada no topo do mural, antes da ordenação alfabética. Use-a para as suas marcas estratégicas ou para as novidades.

## Enriquecer uma marca

Vá a **Catálogo → Brand Hub**. A lista mostra todos os seus fabricantes com o respetivo estado de enriquecimento: meta title personalizado, presença de faixa, estado em destaque e visibilidade. Clique em **Modificar** para abrir a ficha de enriquecimento de uma marca.

### Visibilidade e destaque

**Visível no Brand Hub**: desative para retirar a marca do mural; a página dela passa então a devolver um erro 404. **Marca em destaque**: ative para mostrar a marca na faixa das marcas em destaque.

### Faixa

Carregue uma imagem JPG, PNG ou WEBP. O formato recomendado é de 1600 × 400 píxeis. A faixa aparece em largura total no topo da página de marca. Para substituir uma faixa, basta carregar um novo ficheiro; para a eliminar, ative o interruptor de eliminação e grave.

### Conteúdos por idioma

Estão disponíveis quatro campos para cada idioma da loja:

- **H1 personalizado**: substitui o nome do fabricante como título principal da página. Deixe vazio para usar o nome da marca.
- **Meta title**: a etiqueta title da página. Deixe vazio para recorrer ao meta title do fabricante nativo.
- **Meta description**: a descrição apresentada nos resultados de pesquisa.
- **Descrição enriquecida**: um texto longo em editor rico, apresentado por baixo do cabeçalho da página de marca. Ideal para contar a história da marca e colocar as suas palavras-chave.

Todos os enriquecimentos são por loja em contexto multiloja: selecione a loja pretendida no seletor multiloja antes de editar. Uma mesma marca pode ter faixas e conteúdos diferentes consoante a loja.

## A página de marca

Cada marca tem a sua página no endereço /marque/id-slug (configurável). Apresenta a faixa, o logótipo, o H1, a descrição enriquecida e, a seguir, a listagem dos produtos da marca.

### Listagem de produtos nativa

A listagem herda do controlador nativo do PrestaShop: a paginação, as opções de ordenação e a navegação por facetas (ps_facetedsearch ou equivalente) funcionam exatamente como nas suas páginas de categoria, com o aspeto do seu tema. Não é necessária qualquer configuração.

### Cadeia de recurso do SEO

Nenhuma página fica vazia. Para cada metadado, o módulo aplica o primeiro valor disponível: metadado enriquecido do Brand Hub, depois metadado do fabricante nativo e, por fim, um título construído automaticamente no formato «Nome da marca: nome da loja».

## Configuração do módulo

A partir de **Módulos → Gestor de módulos → Páginas de Marca SEO → Configurar**, ou através do botão dedicado no separador Brand Hub:

- **Slug do mural**: o segmento de URL do mural de marcas (predefinição: marques).
- **Slug das páginas de marca**: o prefixo das páginas de marca (predefinição: marque).
- **Título do mural** e **meta description do mural**: por idioma, com valores predefinidos localizados.
- **Dados estruturados JSON-LD**: ativa a injeção da marcação Brand e CollectionPage.
- **Contadores de produtos**: mostra o número de produtos em cada cartão do mural.
- **Barra de pesquisa**: mostra ou oculta a pesquisa instantânea no mural.
- **Modo takeover**: redireciona em 301 as páginas de fabricante nativas para as páginas do Brand Hub.

Depois de alterar os slugs de URL, limpe a cache do PrestaShop (Parâmetros avançados → Desempenho) para que as novas rotas sejam tidas em conta de imediato.

## SEO e dados estruturados

### JSON-LD

Quando a opção está ativa, o módulo injeta uma marcação Brand em cada página de marca (nome, URL, logótipo, descrição) e uma marcação CollectionPage com ItemList no mural, listando todas as marcas apresentadas. Pode verificar o resultado com o teste de resultados enriquecidos do Google.

### Canónicos e redirecionamentos 301

Cada página de marca declara o seu URL canónico. Se uma página for chamada com um slug errado ou obsoleto, o módulo redireciona em 301 para o URL canónico: não há qualquer possibilidade de conteúdo duplicado.

### Modo takeover

Quando ativo, este modo redireciona em 301 todos os URL de fabricante nativos (controller=manufacturer) para os equivalentes no Brand Hub. As suas ligações antigas, as ligações externas e as posições no Google são preservadas e transferidas para as novas páginas enriquecidas. Quando está inativo, os dois sistemas coexistem.

## Multiloja e multi-idioma

O módulo é totalmente compatível com multiloja: visibilidade, destaque, faixa e conteúdos são guardados por loja. Os slugs de URL e as opções de configuração também se definem por loja. Do lado dos idiomas, todos os campos editoriais (H1, metadados, descrição) existem para cada idioma ativo.

Os valores predefinidos do mural são fornecidos em francês, inglês, espanhol, alemão e italiano, não em português. Preencha manualmente o título e a meta description do mural no idioma português, caso contrário o visitante verá o texto do idioma de recurso.

## Resolução de problemas

### O mural mostra uma página 404

Limpe a cache do PrestaShop e confirme que a reescrita de URL está ativa (Parâmetros da loja → Tráfego e SEO → URL simplificado). Confirme também que nenhuma outra rota já reserva o slug configurado.

### Uma marca não aparece no mural

Três verificações: o fabricante está ativo em Catálogo → Marcas, está associado à loja atual e o seu interruptor «Visível no Brand Hub» está ativo no separador Brand Hub.

### A faixa não aparece

Confirme que o ficheiro respeita os formatos aceites (JPG, PNG, WEBP) e o tamanho máximo de carregamento do seu servidor. A pasta modules/dfbrandhub/views/img/banners/ tem de permitir escrita.

### As facetas não aparecem na página de marca

Na configuração do seu módulo de navegação por facetas, confirme que as páginas de fabricante estão incluídas no âmbito de indexação e relance a indexação dos filtros.

## Desinstalação

A desinstalação elimina as tabelas do módulo, o separador do back-office, a configuração e as faixas carregadas. Os fabricantes nativos do PrestaShop não são, como é evidente, afetados. Ao eliminar um fabricante individual, o módulo limpa automaticamente os seus dados enriquecidos e a sua faixa.
