Breadcrumb Pro (trilho de navegação): guia completo

O Breadcrumb Pro (dfbreadcrumbpro) substitui o trilho de navegação básico do seu tema por uma navegação enriquecida: menus pendentes de categorias irmãs em cada nível, dados estruturados JSON-LD BreadcrumbList conformes às diretrizes do Google, e caminho inteligente para os produtos que pertencem a várias categorias.

Instalação

1. Vá a Módulos > Gestor de módulos > Instalar um módulo.
2. Carregue o arquivo dfbreadcrumbpro.zip e clique em Instalar.
3. O módulo regista-se automaticamente nos hooks displayHeader, displayWrapperTop e actionFrontControllerSetMedia. Não é necessária nenhuma manipulação adicional.

Compatibilidade: PrestaShop 8.0 a 9.x, PHP 7.4 a 8.3, multiloja e multilingue.

Configuração

Abra Módulos > Gestor de módulos, procure « Breadcrumb Pro » e clique em Configurar. Estão disponíveis as seguintes opções:

• Substituir o trilho de navegação do tema (ativado por defeito): oculta em CSS o trilho renderizado pelo tema (classes .breadcrumb e .breadcrumb-wrapper) para evitar qualquer duplicado visual.
• Ativar os menus pendentes (ativado por defeito): mostra as categorias irmãs num menu pendente em cada nível do trilho.
• Mostrar as subcategorias no último nível (desativado por defeito): nas páginas de categoria, o último menu lista as subcategorias da categoria atual em vez das suas categorias irmãs. Se a categoria não tiver filhos, o módulo volta automaticamente às categorias irmãs.
• Estratégia de caminho para os produtos: ver a secção dedicada abaixo.
• Ativar o JSON-LD BreadcrumbList (ativado por defeito): injeta os dados estruturados schema.org na etiqueta head.
• Mostrar a ligação Início (ativado por defeito): primeiro elemento do trilho a apontar para a página inicial.
• Separador: caráter apresentado entre os níveis (por defeito ›, 8 caracteres no máximo).
• Número máximo de elementos por menu: limite das categorias listadas em cada menu pendente (por defeito 15, de 1 a 50).

Estratégias de caminho de produto

Quando um produto pertence a várias categorias, o módulo tem de escolher que caminho apresentar. São propostas três estratégias:

Categoria por defeito

O trilho usa a categoria por defeito do produto (id_category_default), ou seja, o comportamento clássico do PrestaShop. Se essa categoria estiver desativada ou não associada à loja atual, o módulo recorre automaticamente à categoria mais profunda.

Categoria mais profunda

O trilho usa a categoria ativa mais profunda (maior level_depth) entre as do produto. É o caminho mais específico, geralmente o mais interessante para o SEO, já que maximiza o número de níveis e de palavras-chave no trilho e no JSON-LD.

Contextual (recomendada, por defeito)

O módulo memoriza a última categoria visitada pelo cliente num cookie (dfbcp_last_cat). Numa ficha de produto, se o produto pertencer a essa categoria, o trilho mostra esse caminho: a navegação reflete o percurso real do visitante. Caso contrário, o módulo recorre à categoria mais profunda.

Menus pendentes

Cada nível do trilho correspondente a uma categoria mostra um botão caret. Comportamento:

• Desktop: abertura ao passar o rato no nível ou ao clicar no caret.
• Telemóvel: abertura ao tocar no caret, trilho deslocável horizontalmente nos ecrãs pequenos.
• Fecho: clique fora do trilho ou tecla Esc.
• Acessibilidade: atributos aria-haspopup, aria-expanded e aria-current, navegação por teclado completa.
• Anti-transbordo: os menus reposicionam-se automaticamente para nunca saírem do ecrã.

As listas de categorias irmãs são guardadas em cache por pedido e respeitam o idioma e a loja atuais. A categoria ativa é destacada no menu.

JSON-LD BreadcrumbList

O módulo injeta na etiqueta head um script application/ld+json do tipo BreadcrumbList:

• posições numeradas a partir de 1;
• nome e URL para cada nível;
• último elemento (página atual) voluntariamente sem URL, em conformidade com as recomendações do Google;
• nunca emitido se o trilho tiver menos de dois níveis.

Pode verificar a validade da marcação com o teste de resultados enriquecidos do Google.

Páginas cobertas

• Categorias: caminho completo desde a raiz do catálogo.
• Fichas de produto: caminho de categoria segundo a estratégia escolhida, produto no último nível.
• Páginas CMS: árvore das categorias CMS e depois título da página.
• Marcas e fornecedores: página de lista e depois ficha.
• Outras páginas (contacto, promoções, mapa do site…): recurso genérico ao título meta da página.
• Página inicial: nenhum trilho apresentado.

Multiloja e multilingue

Todos os pedidos SQL respeitam as associações da loja atual (contexto multiloja) e o idioma do visitante: nomes de categorias, URLs reescritos e etiquetas são resolvidos no idioma certo. A tradução francesa do back-office está incluída; o português e os outros idiomas traduzem-se via Internacional > Traduções > Traduções dos módulos instalados (a ligação « Início » do trilho faz parte dessas cadeias).

Resolução de problemas

O trilho não aparece

Verifique que o seu tema expõe o hook displayWrapperTop (presente no tema Classic e na quase totalidade dos temas do mercado). Se não for o caso, ligue o módulo a um hook de apresentação equivalente via Design > Posições.

Aparecem dois trilhos de navegação

A opção « Substituir o trilho de navegação do tema » está desativada, ou o seu tema usa classes CSS não padrão. Reative a opção ou adicione uma regra CSS que vise o contentor do trilho do seu tema.

O modo contextual mostra sempre o mesmo caminho

Uma cache de página inteira ignora provavelmente o cookie dfbcp_last_cat. Passe à estratégia « Categoria mais profunda » ou exclua esse cookie da chave de cache.

O menu pendente está vazio num nível

A categoria não tem nenhuma categoria irmã ativa associada à loja atual: o caret simplesmente não é apresentado nesse caso.

Histórico de versões

• 1.0.0 (16/07/2026): publicação inicial: menus pendentes de categorias irmãs, JSON-LD BreadcrumbList, estratégias por defeito / mais profunda / contextual, cobertura de categorias, produtos, CMS, marcas e fornecedores, multiloja e multilingue.