Advanced Breadcrumbs problemen oplossen in Magento 2

Symptomen:

• Geen breadcrumbs zichtbaar op enige pagina
• Breadcrumbs zien er nog uit zoals de standaard Magento-variant (JavaScript-gebaseerd)

Oplossing:

1. Controleer of de module is ingeschakeld in de configuratie (zie Snelle Diagnose)
2. Controleer of de module correct geregistreerd is: bin/magento module:status moet Magmodules_AdvancedBreadcrumbs als ingeschakeld tonen
3. Leeg alle relevante caches: config, layout, full_page
4. Als u Varnish of een externe cachelaag gebruikt, leeg deze dan ook
5. Controleer of een andere module ook het breadcrumbs-blok overschrijft — conflicten kunnen de weergave stilzwijgend blokkeren

Preventie:

• Leeg altijd de full page cache na wijzigingen in de configuratie

Symptomen:

• Breadcrumbs verschijnen op categoriepagina's maar niet op productpagina's, of omgekeerd
• Geen breadcrumbs op CMS-pagina's, zoekresultaten of andere paginatypen

Oplossing:

1. Ga naar de sectie Paginatypen in de configuratie
2. Controleer welke paginatypen zijn ingeschakeld — alleen geselecteerde typen tonen breadcrumbs
3. Standaard zijn alleen Categorie, Product en CMS-pagina's ingeschakeld — andere typen moeten expliciet worden ingeschakeld
4. Sla de configuratie op en leeg de cache

Symptomen:

• De breadcrumb van een product toont een onverwacht categoriepad
• Een "Sale"- of andere marketing/seizoenscategorie verschijnt in plaats van de verwachte structuurcategorie

Oplossing:

1. Controleer of het product een "Primaire Breadcrumb Categorie" override heeft ingesteld (in producteditie > SEO-sectie). Als dit is ingesteld, overschrijft het alle andere logica.
2. Pas categoriegewichten aan: ga naar de gewenste categorie en stel een positief gewicht in (bijv. 10). Ga naar de ongewenste categorie en stel het gewicht in op -1.
3. Bekijk de Selectiestrategie in de configuratie. "Deepest Path" geeft doorgaans de beste resultaten voor een standaard catalogusstructuur.
4. Zorg dat de gewenste categorie actief is, zichtbaar in het menu, en dat het product eraan toegewezen is.

Preventie:

• Stel negatieve gewichten in op marketing- en seizoenscategorieën voordat er producten aan worden toegewezen
• Test met een representatieve set producten na het wijzigen van de selectiestrategie

Symptomen:

• Geen BreadcrumbList JSON-LD block in de paginabron
• Google Search Console meldt ontbrekende gestructureerde data voor breadcrumbs

Oplossing:

1. Controleer de sectie Gestructureerde Data in de configuratie — "JSON-LD inschakelen" moet op Ja staan
2. Bekijk de ruwe paginabron (Ctrl+U, niet via browser DevTools) en zoek naar BreadcrumbList
3. Als breadcrumbs visueel wel worden getoond maar JSON-LD ontbreekt, staat de toggle voor gestructureerde data mogelijk los van de rest uitgeschakeld
4. Als JSON-LD aanwezig is maar Google het niet herkent, valideer dan via Google's Rich Results Test tool

Preventie:

• Valideer gestructureerde data na de initiële inrichting via de Google Rich Results Test of de Schema.org validator

Symptomen:

• Twee of meer BreadcrumbList JSON-LD blocks in de paginabron
• Google Search Console toont waarschuwingen over "duplicate structured data"

Oplossing:

1. Een andere module genereert waarschijnlijk ook breadcrumb JSON-LD — veelvoorkomende veroorzakers zijn rich snippets-modules en algemene SEO-modules
2. Schakel de breadcrumb gestructureerde data-uitvoer in de andere module uit
3. Gebruik Advanced Breadcrumbs als de enige bron voor breadcrumb JSON-LD-uitvoer

Symptomen:

• Breadcrumbs worden gerenderd maar de opmaak klopt niet of ontbreekt
• Tailwind utility classes ontbreken
• Breadcrumbs verschijnen zonder stijl of als standaard HTML zonder classes

Oplossing:

1. De module detecteert Hyva automatisch en schakelt over naar Hyva-specifieke templates. Controleer of Hyva_Theme is ingeschakeld.
2. Voer de Tailwind CSS build uit voor uw Hyva-installatie (doorgaans npm run build of vergelijkbaar) — de classes uit de Hyva-templates van de module moeten worden meegenomen tijdens de CSS purge/scan stap
3. De module registreert zichzelf voor Hyva's Tailwind content scan via de RegisterHyvaConfig observer. Als stijlen nog steeds ontbreken, controleer dan of tailwind.config.js het templatepad van de module bevat.

Symptomen:

• De Home-breadcrumb linkt naar de verkeerde store view of basis-URL
• Treedt voornamelijk op in multi-store setups met verschillende basis-URLs per store view

Oplossing:

1. De URL van de Home-breadcrumb wordt afgeleid van de basis-URL van de Magento-winkel. Controleer Winkels > Configuratie > Algemeen > Web > Basis-URLs
2. Zorg er in een multi-store setup voor dat elke store view de juiste Basis-URL heeft ingesteld op store view-scope
3. Leeg de config cache na wijzigingen aan basis-URLs

Symptomen:

• Een gewichtswaarde wordt ingevoerd op een categorie en opgeslagen, maar keert terug naar 0 bij het herladen
• Het gewichtsveld is niet zichtbaar in het categorie-bewerkingsformulier

Oplossing:

1. Het gewichtsveld bevindt zich in de sectie "Zoekmachineoptimalisatie" van het categorie-bewerkingsformulier
2. Controleer of u opslaat op de juiste scope — als het veld op store view-niveau is ingesteld, schakel dan eerst naar de juiste store view
3. Als het veld helemaal niet zichtbaar is, heeft de data patch mogelijk niet gedraaid — voer bin/magento setup:upgrade uit om dit te corrigeren
4. Controleer of de toggle "Uitsluiten van breadcrumbs" is ingesteld op de categorie — dit overschrijft het gewicht volledig