Breadcrumb Navigation Pro — Komplettanleitung

Breadcrumb Navigation Pro (dfbreadcrumbpro) ersetzt die einfache Breadcrumb Ihres Themes durch eine erweiterte Navigation: Dropdown-Menüs mit Geschwisterkategorien auf jeder Ebene, JSON-LD-BreadcrumbList-Daten konform mit den Google-Richtlinien und ein intelligenter Pfad für Produkte in mehreren Kategorien.

Installation

1. Gehen Sie zu Module > Modul-Manager > Ein Modul hochladen.
2. Laden Sie das Archiv dfbreadcrumbpro.zip hoch und klicken Sie auf Installieren.
3. Das Modul registriert sich automatisch an den Hooks displayHeader, displayWrapperTop und actionFrontControllerSetMedia. Weitere Schritte sind nicht nötig.

Kompatibilität: PrestaShop 8.0 bis 9.x, PHP 7.4 bis 8.3, Multistore und mehrsprachig.

Konfiguration

Öffnen Sie Module > Modul-Manager, suchen Sie nach „Breadcrumb Navigation Pro“ und klicken Sie auf Konfigurieren. Folgende Optionen stehen zur Verfügung:

• Theme-Breadcrumb ersetzen (standardmäßig aktiviert) — blendet die vom Theme gerenderte Breadcrumb (Klassen .breadcrumb und .breadcrumb-wrapper) per CSS aus, um visuelle Dopplungen zu vermeiden.
• Dropdown-Menüs aktivieren (standardmäßig aktiviert) — zeigt die Geschwisterkategorien in einem Dropdown auf jeder Ebene.
• Unterkategorien auf der letzten Ebene anzeigen (standardmäßig deaktiviert) — auf Kategorieseiten listet das letzte Dropdown die Unterkategorien der aktuellen Kategorie statt ihrer Geschwister. Hat die Kategorie keine Kinder, fällt das Modul automatisch auf die Geschwister zurück.
• Pfadstrategie für Produkte — siehe den eigenen Abschnitt weiter unten.
• JSON-LD BreadcrumbList aktivieren (standardmäßig aktiviert) — injiziert die schema.org-Daten in den Head der Seite.
• Startseiten-Link anzeigen (standardmäßig aktiviert) — erstes Element des Pfads, das auf die Startseite verweist.
• Trennzeichen — zwischen den Ebenen angezeigtes Zeichen (Standard ›, maximal 8 Zeichen).
• Maximale Einträge pro Dropdown — Obergrenze der pro Dropdown gelisteten Kategorien (Standard 15, von 1 bis 50).

Produkt-Pfadstrategien

Gehört ein Produkt zu mehreren Kategorien, muss das Modul entscheiden, welcher Pfad angezeigt wird. Drei Strategien stehen zur Auswahl:

Standardkategorie

Der Pfad verwendet die Standardkategorie des Produkts (id_category_default), also das klassische PrestaShop-Verhalten. Ist diese Kategorie deaktiviert oder nicht dem aktuellen Shop zugeordnet, fällt das Modul automatisch auf die tiefste Kategorie zurück.

Tiefste Kategorie

Der Pfad verwendet die tiefste aktive Kategorie (größte level_depth) unter den Kategorien des Produkts. Das ist der spezifischste Pfad und in der Regel der interessanteste für SEO, da er die Zahl der Ebenen und Keywords im Pfad und im JSON-LD maximiert.

Kontextuell (empfohlen, Standard)

Das Modul merkt sich die zuletzt vom Kunden besuchte Kategorie in einem Cookie (dfbcp_last_cat). Gehört das Produkt auf einer Produktseite zu dieser Kategorie, zeigt der Pfad diesen Weg an: Die Navigation spiegelt den tatsächlichen Verlauf des Besuchers wider. Andernfalls fällt das Modul auf die tiefste Kategorie zurück.

Dropdown-Menüs

Jede Pfadebene, die einer Kategorie entspricht, zeigt eine Caret-Schaltfläche. Verhalten:

• Desktop — öffnet beim Überfahren der Ebene oder beim Klick auf das Caret.
• Mobil — öffnet beim Tippen auf das Caret, der Pfad scrollt auf kleinen Bildschirmen horizontal.
• Schließen — Klick außerhalb des Pfads oder Escape-Taste.
• Barrierefreiheit — Attribute aria-haspopup, aria-expanded und aria-current, vollständige Tastaturnavigation.
• Überlaufschutz — die Menüs positionieren sich automatisch neu, damit sie nie über den Bildschirmrand hinausragen.

Die Listen der Geschwisterkategorien werden pro Request gecacht und berücksichtigen Sprache und Shop. Die aktive Kategorie wird im Menü hervorgehoben.

JSON-LD BreadcrumbList

Das Modul injiziert im Head ein application/ld+json-Skript vom Typ BreadcrumbList:

• Positionen ab 1 nummeriert;
• Name und URL für jede Ebene;
• letztes Element (aktuelle Seite) bewusst ohne URL, wie es die Google-Richtlinien empfehlen;
• wird nie ausgegeben, wenn der Pfad weniger als zwei Ebenen hat.

Das Markup lässt sich mit dem Google-Test für Rich-Suchergebnisse validieren.

Abgedeckte Seiten

• Kategorien — vollständiger Pfad ab der Katalogwurzel.
• Produktseiten — Kategoriepfad gemäß der gewählten Strategie, Produkt als letzte Ebene.
• CMS-Seiten — CMS-Kategoriebaum, dann Seitentitel.
• Marken und Lieferanten — Listenseite, dann Detailseite.
• Andere Seiten (Kontakt, Angebote, Sitemap…) — generischer Fallback auf den Meta-Titel der Seite.
• Startseite — kein Pfad wird angezeigt.

Multistore und mehrsprachig

Alle SQL-Abfragen berücksichtigen die Zuordnungen des aktuellen Shops (Multistore-Kontext) sowie die Sprache des Besuchers: Kategorienamen, umgeschriebene URLs und Beschriftungen werden in der richtigen Sprache aufgelöst. Die französische Back-Office-Übersetzung ist enthalten; weitere Sprachen lassen sich über International > Übersetzungen > Übersetzungen installierter Module übersetzen.

Fehlerbehebung

Der Pfad wird nicht angezeigt

Prüfen Sie, ob Ihr Theme den Hook displayWrapperTop bereitstellt (im Classic-Theme und praktisch allen Marketplace-Themes vorhanden). Falls nicht, hängen Sie das Modul über Design > Positionen an einen gleichwertigen Anzeige-Hook.

Zwei Breadcrumbs erscheinen

Die Option „Theme-Breadcrumb ersetzen“ ist deaktiviert, oder Ihr Theme verwendet nicht standardmäßige CSS-Klassen. Aktivieren Sie die Option erneut oder fügen Sie eine CSS-Regel für den Breadcrumb-Container Ihres Themes hinzu.

Der kontextuelle Modus zeigt immer denselben Pfad

Ein Full-Page-Cache ignoriert wahrscheinlich das Cookie dfbcp_last_cat. Wechseln Sie zur Strategie „Tiefste Kategorie“ oder schließen Sie dieses Cookie vom Cache-Schlüssel aus.

Ein Dropdown ist auf einer Ebene leer

Die Kategorie hat keine aktive, dem aktuellen Shop zugeordnete Geschwisterkategorie: In diesem Fall wird das Caret schlicht nicht angezeigt.

Versionshistorie

• 1.0.0 (16.07.2026) — Erstveröffentlichung: Dropdown-Menüs mit Geschwisterkategorien, JSON-LD BreadcrumbList, Strategien Standard / tiefste / kontextuell, Abdeckung von Kategorien, Produkten, CMS, Marken und Lieferanten, Multistore und mehrsprachig.