Problemen met de Alternate Hreflang Extensie? Deze pagina behandelt de meest voorkomende problemen en hoe u ze oplost. Begin met de snelle diagnose sectie om uit te zoeken wat er mis is, en spring dan naar het relevante probleem. We hebben ook debug tips toegevoegd (debug mode, log bestanden, self-test) en wat u moet controleren wanneer het niet werkt zoals verwacht.
Veelvoorkomende problemen en hoe ze op te lossen.
Snelle Diagnose
Voordat u in specifieke problemen duikt, voer deze snelle checks uit:
-
Controleer of module is ingeschakeld
- Winkels → Configuratie → Magmodules → Alternate Hreflang → Algemeen → Inschakelen: Ja
-
Leeg cache
bin/magento cache:flush
-
Voer self-test uit
- Winkels → Configuratie → Magmodules → Alternate Hreflang → Debug & Logging
- Klik op "Self-Test Uitvoeren" knop
-
Controleer logs
tail -n 50 var/log/error.log | grep AlternateHreflang
tail -n 50 var/log/debug.log | grep AlternateHreflang
-
Test met debug mode
- Inschakelen: Alternate Hreflang Configuratie → Debug Mode Inschakelen: Ja
- Bezoek:
https://example.com/pagina?show-alternate=1
Veelvoorkomende Problemen
Probleem: Hreflang Tags Verschijnen Niet
Symptomen:
- Geen hreflang tags in paginabron
- Lege output bij gebruik van
?show-alternate=1
- Tags ontbreken op specifieke paginatypen
Oplossing:
-
Verifieer dat module is ingeschakeld:
- Algemeen → Inschakelen: Ja
-
Controleer of paginatype is ingeschakeld:
- Voor homepage: Configuratie → Inschakelen op Homepage: Ja
- Voor producten: Configuratie → Inschakelen op Productpagina's: Ja
- Voor categorieën: Configuratie → Inschakelen op Categoriepagina's: Ja
- Voor CMS: Configuratie → Inschakelen op CMS Pagina's: Ja
-
Verifieer dat store targeting is geconfigureerd:
- Targeting Instellingen → Controleer of winkels zijn toegevoegd met taalcodes
- Minimaal 2 winkels moeten in dezelfde groep zitten
-
Leeg cache:
bin/magento cache:flush
-
Controleer canonical integratie:
- Als "Hreflang Alleen Inschakelen op Canonical URL's" is ingeschakeld
- Verifieer dat pagina self-referential canonical tag heeft
-
Controleer NoIndex afhandeling:
- Als NoIndex afhandeling is ingeschakeld
- Verifieer dat pagina geen noindex directive heeft
Preventie:
- Voer self-test uit na configuratie wijzigingen
- Test met
?show-alternate=1 voordat u live gaat
- Houd debug mode ingeschakeld tot geverifieerd
Probleem: Verkeerde URL's in Hreflang Tags
Symptomen:
- Hreflang tags wijzen naar incorrecte URL's
- URL's voor verkeerde store-views
- 404 errors op alternatieve URL's
Oplossing:
-
Controleer store basis URL's:
- Winkels → Configuratie → Web → Unsecure/Secure → Basis URL
- Verifieer dat elke winkel correcte basis URL heeft
-
Verifieer store targeting configuratie:
- Controleer of taalcodes matchen met verwachte winkels
- Verifieer dat groepnummers correct zijn
-
Controleer of product/categorie bestaat in alle winkels:
- Product moet ingeschakeld zijn in alle winkels in de groep
- Categorie moet actief zijn in alle winkels
-
Test URL generatie:
- Schakel debug mode in
- Controleer logs voor URL generatie:
grep "Adding hreflang" var/log/debug.log
-
Leeg cache en reindex:
bin/magento cache:flush
bin/magento indexer:reindex
Preventie:
- Verifieer dat basis URL's correct zijn voor elke winkel
- Zorg dat producten/categorieën ingeschakeld zijn in alle doelwinkels
- Test URL's handmatig voordat u deployt
Probleem: Hreflang Tags op Gefilterde/Dubbele Pagina's
Symptomen:
- Tags verschijnen op URL's zoals
/product?kleur=rood
- Tags op gepagineerde pagina's zoals
/categorie?p=2
- Dubbele hreflang signalen
Oplossing:
-
Schakel canonical integratie in:
- Configuratie → Hreflang Alleen Inschakelen op Canonical URL's: Ja
-
Verifieer dat canonical tags zijn ingesteld:
- Gefilterde pagina's moeten canonical hebben die naar hoofdpagina wijst
- Controleer paginabron voor
<link rel="canonical" ...>
-
Leeg cache:
bin/magento cache:flush
-
Test:
- Bezoek gefilterde URL met
?show-alternate=1
- Hreflang tags zouden NIET moeten verschijnen
- Bezoek canonical URL met
?show-alternate=1
- Hreflang tags ZOUDEN moeten verschijnen
Preventie:
- Schakel altijd canonical integratie in
- Zorg dat Magento canonical tags correct werken
Probleem: Hreflang op NoIndex Pagina's
Symptomen:
- Tags verschijnen op pagina's met noindex directive
- Gemixte signalen naar zoekmachines
- SEO problemen
Oplossing:
-
Schakel NoIndex afhandeling in:
- Configuratie → NoIndex Afhandeling Inschakelen: Ja
-
Configureer attributen/kolommen:
- Product Attribuut: Selecteer correct attribuut (bijv.
mm_meta_robots)
- Categorie Attribuut: Selecteer correct attribuut
- CMS Kolom: Voer correcte kolomnaam in
-
Verifieer attribuut waarden:
- Controleer of product/categorie attribuut
NOINDEX bevat
- Voor CMS, controleer database kolom waarde
-
Leeg cache:
bin/magento cache:flush
-
Test:
- Bezoek noindex pagina met
?show-alternate=1
- Hreflang tags zouden NIET moeten verschijnen
Preventie:
- Schakel NoIndex afhandeling in vanaf het begin
- Gebruik consistente attribuutnamen over entiteiten
- Test met noindex pagina's na configuratie
Probleem: Ontbrekende Store-Views in Hreflang
Symptomen:
- Sommige winkels verschijnen niet in hreflang tags
- Verwachtte 4 talen maar slechts 2 verschijnen
- Inconsistente tags over pagina's
Oplossing:
-
Controleer store targeting configuratie:
- Verifieer dat alle winkels in hetzelfde groepnummer zitten
- Controleer of taalcodes correct zijn ingevoerd
-
Verifieer dat winkels zijn ingeschakeld:
- Winkels → Alle Winkels
- Controleer of elke winkel is ingeschakeld
-
Controleer product/categorie beschikbaarheid:
- Entiteit moet ingeschakeld zijn in alle winkels
- Zichtbaarheid moet passend zijn
-
Verifieer basis URL's:
- Elke winkel moet een geldige basis URL hebben
- URL's moeten bereikbaar zijn
-
Voer self-test uit:
- Controleer op waarschuwingen over winkel configuratie
Preventie:
- Dubbelcheck groepnummers bij configureren
- Test met een product dat bestaat in alle winkels
- Voer self-test uit na toevoegen nieuwe winkels
Probleem: Prestatie Problemen
Symptomen:
- Langzame pagina laadtijden
- Hoge server belasting
- Sitemap generatie timeouts
Oplossing:
-
Schakel debug logging uit:
- Debug & Logging → Debug Mode: Nee (in productie)
-
Controleer aantal winkels:
- Groot aantal winkels verhoogt processing
- Overweeg of alle winkels hreflang nodig hebben
-
Review sitemap configuratie:
- Schakel sitemap integratie uit indien niet nodig
- Genereer sitemaps tijdens daluren
-
Schakel caching in:
- Zorg dat full-page cache is ingeschakeld
- Verifieer dat block cache werkt
-
Monitor logs voor langzame queries:
grep "slow" var/log/debug.log
Preventie:
- Schakel alleen benodigde paginatypen in
- Houd debug logging uitgeschakeld in productie
- Monitor prestaties na configuratie wijzigingen
Probleem: X-Default Configuratie Werkt Niet
Symptomen:
- X-default tag verschijnt niet
- X-default wijst naar verkeerde pagina
- Errors in Search Console
Oplossing:
-
Verifieer dat x-default is geconfigureerd:
- Targeting Instellingen → X-Default Configuratie
- Controleer of CMS pagina of store-view is geselecteerd
-
Voor CMS pagina optie:
- Verifieer dat CMS pagina bestaat
- Controleer of pagina is ingeschakeld
- Verifieer dat URL bereikbaar is
-
Voor store-view optie:
- Verifieer dat winkel is ingeschakeld
- Controleer of winkel in een groep zit met andere winkels
-
Test output:
- Gebruik
?show-alternate=1 om x-default tag te verifiëren
Preventie:
- Houd x-default eenvoudig (sla over voor eenvoudige setups)
- Test x-default configuratie voordat u deployt
- Raadpleeg SEO partner voor complexe setups
Probleem: Self-Test Mislukkingen
Symptomen:
- Self-test toont errors of waarschuwingen
- Configuratie problemen gedetecteerd
- Compatibiliteits problemen
Oplossing:
-
Review self-test resultaten zorgvuldig
- Lees elk error/waarschuwing bericht
- Prioriteer errors boven waarschuwingen
-
Veelvoorkomende self-test problemen:
"Geen winkels geconfigureerd"
- Voeg winkels toe aan targeting configuratie
"Ongeldige taalcode"
- Gebruik kleine letters met streepje:
nl-nl niet nl_NL
"Winkel basis URL ontbreekt"
- Configureer basis URL in Winkels → Configuratie → Web
"Geen paginatypen ingeschakeld"
- Schakel minimaal één paginatype in Configuratie in
-
Los problemen op en voer test opnieuw uit
-
Controleer compatibiliteits waarschuwingen
- Update incompatibele modules
- Controleer Magento versie vereisten
Preventie:
- Voer self-test uit voordat u live gaat
- Voer self-test uit na grote configuratie wijzigingen
- Voer self-test kwartaal uit voor onderhoud
Probleem: Sitemap Integratie Werkt Niet
Symptomen:
- Hreflang verschijnt niet in sitemap.xml
- Sitemap generatie errors
- Ontbrekende
xhtml:link elementen
Oplossing:
-
Verifieer vereisten:
-
Controleer sitemap configuratie:
- Third Party → Sitemap Producten/Categorieën/etc.: Ja
- Corresponderend paginatype moet ook ingeschakeld zijn
-
Genereer sitemap opnieuw:
- Marketing → SEO & Zoeken → Sitemap
- Genereer nieuwe sitemap
-
Verifieer sitemap output:
curl https://example.com/sitemap.xml | grep "xhtml:link"
-
Controleer sitemap logs:
grep "sitemap" var/log/system.log
Preventie:
- Genereer sitemap opnieuw na configuratie wijzigingen
- Test sitemap lokaal voordat u indient bij zoekmachines
- Monitor sitemap bestandsgrootte voor grote catalogi
Debug Mode Gebruik
Debug Logging Inschakelen
Doel: Gedetailleerde logs voor troubleshooting
Hoe in te schakelen:
- Debug & Logging → Debug Mode: Ja
- Leeg cache
- Reproduceer probleem
- Controleer logs:
tail -f var/log/debug.log | grep AlternateHreflang
Waar naar te zoeken:
[AlternateHreflang] Generating hreflang tags for product ID: 123
[AlternateHreflang] Found 3 store-views in group 1
[AlternateHreflang] Adding hreflang: nl-nl → https://example.nl/product
Uitschakelen na: Schakel altijd debug logging uit in productie
Frontend Debug Inschakelen
Doel: Bekijk hreflang tags direct in browser
Hoe in te schakelen:
- Alternate Hreflang Configuratie → Debug Mode Inschakelen: Ja
- Bezoek een pagina met
?show-alternate=1
- Bekijk gegenereerde tags en configuratie
Uitschakelen na: Schakel uit voordat u live gaat
Google Search Console Errors
"No Return Tag" Error
Wat het betekent: Winkel A linkt naar Winkel B, maar Winkel B linkt niet terug naar Winkel A
Oplossing:
- Verifieer dat beide winkels in dezelfde groep zitten
- Controleer of beide winkels het product/categorie/pagina hebben
- Zorg dat configuratie symmetrisch is
"Incorrect Language Code" Waarschuwing
Wat het betekent: Taalcode matcht niet met ISO standaard
Oplossing:
- Gebruik juiste formaat:
nl-nl niet nl_NL
- Controleer op typefouten in taalcodes
- Gebruik standaard codes van Best Practices
"Multiple X-Default Tags" Error
Wat het betekent: Meer dan één x-default tag op de pagina
Oplossing:
- Controleer x-default configuratie
- Verifieer dat geen andere modules x-default toevoegen
- Gebruik slechts één x-default strategie
Meer Hulp Nodig?
Als u de bovenstaande oplossingen heeft geprobeerd en nog steeds problemen ervaart:
Documentatie:
Support:
Bij contact met support, vermeld:
- Module versie
- Magento versie
- Self-test resultaten (Admin → Magmodules → Alternate Hreflang → Developer → Self-Test)
- Stappen om het probleem te reproduceren
- Eventuele foutmeldingen uit logs
28 dagen geleden