Kruimelpad Pro: volledige gids

Kruimelpad Pro (dfbreadcrumbpro) vervangt het eenvoudige kruimelpad van uw thema door een rijkere navigatie: uitklapmenu’s met zustercategorieën op elk niveau, gestructureerde JSON-LD-gegevens van het type BreadcrumbList volgens de richtlijnen van Google, en een slim pad voor producten die in meerdere categorieën zitten.

Installatie

1. Ga naar Modules > Modulebeheer > Een module installeren.
2. Upload het archief dfbreadcrumbpro.zip en klik op Installeren.
3. De module registreert zich automatisch op de hooks displayHeader, displayWrapperTop en actionFrontControllerSetMedia. Verder hoeft u niets te doen.

Compatibiliteit: PrestaShop 8.0 tot 9.x, PHP 7.4 tot 8.3, multistore en meertalig.

Configuratie

Open Modules > Modulebeheer, zoek « Kruimelpad Pro » en klik op Configureren. De volgende opties zijn beschikbaar:

• Het kruimelpad van het thema vervangen (standaard aan): verbergt via CSS het kruimelpad dat het thema toont (de klassen .breadcrumb en .breadcrumb-wrapper), zodat er niets dubbel verschijnt.
• Uitklapmenu’s inschakelen (standaard aan): toont de zustercategorieën in een uitklapmenu op elk niveau van het pad.
• De subcategorieën op het laatste niveau tonen (standaard uit): op categoriepagina’s toont het laatste menu de subcategorieën van de huidige categorie in plaats van haar zustercategorieën. Heeft die categorie geen onderliggende categorieën, dan valt de module automatisch terug op de zustercategorieën.
• Padstrategie voor producten: zie het aparte onderdeel hieronder.
• JSON-LD BreadcrumbList inschakelen (standaard aan): injecteert de gestructureerde schema.org-gegevens in de head-tag.
• De link Startpagina tonen (standaard aan): het eerste item van het pad, dat naar de startpagina wijst.
• Scheidingsteken: het teken tussen de niveaus (standaard ›, maximaal 8 tekens).
• Maximaal aantal items per menu: de bovengrens van het aantal categorieën in elk uitklapmenu (standaard 15, van 1 tot 50).

Padstrategieën voor producten

Zit een product in meerdere categorieën, dan moet de module kiezen welk pad hij toont. Er zijn drie strategieën:

Standaardcategorie

Het pad gebruikt de standaardcategorie van het product (id_category_default), dus het klassieke gedrag van PrestaShop. Is die categorie uitgeschakeld of niet aan de huidige winkel gekoppeld, dan valt de module automatisch terug op de diepste categorie.

Diepste categorie

Het pad gebruikt de diepste actieve categorie (de hoogste level_depth) van het product. Dat is het meest specifieke pad en doorgaans het interessantste voor SEO, omdat het het aantal niveaus en zoekwoorden in het pad en in de JSON-LD maximaliseert.

Contextueel (aanbevolen, standaard)

De module onthoudt de laatst bezochte categorie van de klant in een cookie (dfbcp_last_cat). Zit het product op een productfiche in die categorie, dan toont het pad die route: de navigatie weerspiegelt het werkelijke traject van de bezoeker. Zo niet, dan valt de module terug op de diepste categorie.

Uitklapmenu’s

Elk niveau van het pad dat met een categorie overeenkomt, krijgt een pijlknop. Het gedrag:

• Desktop: opent bij het zweven over het niveau of bij een klik op de pijl.
• Mobiel: opent bij een tik op de pijl, met een pad dat op kleine schermen horizontaal schuift.
• Sluiten: klik buiten het pad of druk op Escape.
• Toegankelijkheid: de attributen aria-haspopup, aria-expanded en aria-current, met volledige toetsenbordbediening.
• Geen overloop: de menu’s verplaatsen zich automatisch zodat zij nooit buiten het scherm vallen.

De lijsten met zustercategorieën worden per verzoek in cache gezet en volgen de huidige taal en winkel. De actieve categorie wordt in het menu uitgelicht.

JSON-LD BreadcrumbList

De module injecteert in de head-tag een script application/ld+json van het type BreadcrumbList:

• posities genummerd vanaf 1;
• naam en URL voor elk niveau;
• het laatste item (de huidige pagina) bewust zonder URL, volgens de aanbevelingen van Google;
• wordt nooit uitgestuurd als het pad minder dan twee niveaus telt.

U kunt de geldigheid van de opmaak nagaan met de test voor rijke resultaten van Google.

Behandelde pagina’s

• Categorieën: het volledige pad vanaf de wortel van de catalogus.
• Productfiches: het categoriepad volgens de gekozen strategie, met het product als laatste niveau.
• CMS-pagina’s: de structuur van de CMS-categorieën, gevolgd door de titel van de pagina.
• Merken en leveranciers: de overzichtspagina en daarna de fiche.
• Andere pagina’s (contact, promoties, sitemap en dergelijke): een algemene terugval op de metatitel van de pagina.
• Startpagina: er wordt geen pad getoond.

Multistore en meertaligheid

Alle SQL-queries respecteren de koppelingen van de huidige winkel (de multistorecontext) en de taal van de bezoeker: categorienamen, herschreven URL’s en opschriften worden in de juiste taal opgelost. De Franse vertaling van de backoffice zit in de module; de andere talen vertaalt u via Internationaal > Vertalingen > Vertalingen van de geïnstalleerde modules.

Problemen oplossen

Het pad verschijnt niet

Controleer of uw thema de hook displayWrapperTop wel aanbiedt (die zit in het Classic-thema en in vrijwel alle thema’s op de markt). Is dat niet zo, koppel de module dan via Design > Posities aan een gelijkwaardige weergavehook.

Er verschijnen twee kruimelpaden

De optie « Het kruimelpad van het thema vervangen » staat uit, of uw thema gebruikt niet-standaard CSS-klassen. Zet de optie weer aan of voeg een CSS-regel toe die de padcontainer van uw thema aanspreekt.

De contextuele modus toont altijd hetzelfde pad

Een full-pagecache negeert waarschijnlijk de cookie dfbcp_last_cat. Schakel over op de strategie « Diepste categorie » of sluit die cookie uit van de cachesleutel.

Het uitklapmenu is leeg op een niveau

De categorie heeft geen actieve zustercategorie die aan de huidige winkel is gekoppeld: in dat geval verschijnt de pijl eenvoudigweg niet.

Versieoverzicht

• 1.0.0 (16-07-2026): eerste publicatie met uitklapmenu’s van zustercategorieën, JSON-LD BreadcrumbList, de strategieën standaard, diepste en contextueel, dekking van categorieën, producten, CMS, merken en leveranciers, plus multistore en meertaligheid.