Configureer de Multi-Language Alternate Hreflang-extensie

Hier vindt u alle instellingen voor de Alternate Hreflang Extensie. Deze gids legt uit wat elke optie doet en wanneer u deze zou gebruiken. We hebben het georganiseerd zoals in het admin panel (Algemeen, Targeting, Configuratie) zodat u snel kunt vinden wat u nodig heeft. Sommige instellingen hebben aanbevolen waarden voor veelvoorkomende setups.

Alle configuratie opties uitgelegd.

Locatie: Winkels → Configuratie → Magmodules → Alternate Hreflang

---

Algemeen

Extensie Inschakelen

Schakel de module in of uit. Schakel dit in nadat u uw store targeting en paginatypen hebt geconfigureerd.

Versie Controle

Toont de huidige module versie en controleert op beschikbare updates. Gebruik dit om up-to-date te blijven met de nieuwste features en bugfixes.

---

Targeting Instellingen

Store Targeting

Configureer welke store-views aan elkaar gekoppeld moeten worden met hreflang tags.

Hoe het werkt:

• Alle winkels in hetzelfde Groep nummer zullen aan elkaar gekoppeld worden
• Winkels in verschillende groepen zullen NIET aan elkaar gekoppeld worden
• Elke winkel heeft een taalcode nodig (bijv. en-us, fr-fr, de-de)

Wanneer meerdere groepen gebruiken:

• U heeft aparte productcatalogi (bijv. schoenen vs. kleding)
• Verschillende merken of bedrijfsonderdelen
• Producten/categorieën worden niet gedeeld tussen winkels

Taalcode formaat:

• Gebruik kleine letters met streepje: en-us (niet en_US)
• Wees specifiek met regio's bij het targeten van verschillende markten: en-us, en-gb, en-au
• Kan alleen-taal codes gebruiken voor breder targeten: en, fr, de

Aanbevolen:

• Gebruik regio-specifieke codes (en-us) voor beter targeten
• Groepeer alleen winkels die dezelfde content/producten delen
• Houd taalcodes consistent over uw site

Voorbeeld:

Groep 1: Internationale Winkel
- Engels (VS) → en-us → Groep 1
- Frans      → fr-fr → Groep 1
- Duits      → de-de → Groep 1

Groep 2: B2B Winkel
- Engels (VS) → en-us → Groep 2
- Duits      → de-de → Groep 2

---

X-Default Configuratie

Stel een fallback pagina in voor gebruikers wiens taal/regio niet specifiek getarget is. Dit is optioneel en niet nodig voor de meeste setups.

Twee opties:

1. Target een CMS Pagina - Stuur gebruikers naar een taal/land selector pagina
2. Target een Store-View - Gebruik een specifieke winkel (bijv. Engels VS) als standaard

Wanneer gebruiken:

• U heeft een taalselector landingspagina
• U bedient klanten wereldwijd zonder toegewijde taalversies
• Complexe multi-regionale targeting waar geen enkele winkel primair is

Wanneer overslaan:

• Eenvoudige meertalige setup (bijv. NL + FR + DE)
• Alle doelmarkten hebben toegewijde store-views
• U wilt de configuratie eenvoudig houden

Aanbevolen:

• Voor de meeste winkels: Gebruik geen x-default - moderne zoekmachines handelen dit goed af
• Indien nodig: Gebruik uw primaire markt store-view als x-default
• Raadpleeg uw SEO partner voor complexe internationale setups

---

Alternate Hreflang Configuratie

Paginatypen

Kies welke paginatypen hreflang tags moeten hebben.

Inschakelen op Homepage

Voeg hreflang tags toe aan uw winkel homepage.

Wanneer inschakelen:

• Homepage content verschilt tussen store-views
• U heeft gelokaliseerde homepages voor verschillende talen

Inschakelen op Productpagina's

Voeg hreflang tags toe aan product detail pagina's.

Wanneer inschakelen:

• Producten zijn beschikbaar in meerdere store-views
• Productcontent is vertaald/gelokaliseerd

Inschakelen op Categoriepagina's

Voeg hreflang tags toe aan categoriepagina's.

Wanneer inschakelen:

• Categorieën worden gedeeld tussen store-views
• Categoriecontent is vertaald/gelokaliseerd

Inschakelen op CMS Pagina's

Voeg hreflang tags toe aan CMS pagina's (Over Ons, Voorwaarden, etc.).

Wanneer inschakelen:

• CMS pagina's zijn vertaald en beschikbaar in meerdere talen
• Pagina's delen dezelfde identifier tussen winkels

---

Canonical URL Integratie

Hreflang Alleen Inschakelen op Canonical URL's

Voeg alleen hreflang tags toe aan pagina's met self-referential canonical URL's. Dit voorkomt dat tags verschijnen op dubbele/gefilterde pagina's.

Hoe het werkt:

• Pagina met canonical die naar zichzelf wijst: Hreflang tags toegevoegd ✅
• Pagina met canonical die ergens anders naar wijst: Geen hreflang tags ❌

Voorbeeld:

Productpagina: https://example.com/schoenen
Gefilterde pagina: https://example.com/schoenen?maat=42

De gefilterde pagina heeft canonical die naar de hoofdpagina wijst,
dus hreflang verschijnt alleen op https://example.com/schoenen

Aanbevolen:

• Schakel dit in om duplicate content problemen te voorkomen
• Zorgt ervoor dat hreflang tags alleen op primaire/canonical pagina's staan
• Volgt SEO best practices

---

NoIndex Afhandeling

Voorkom dat hreflang tags worden toegevoegd aan pagina's gemarkeerd met noindex directive. Dit voorkomt het sturen van tegenstrijdige signalen naar zoekmachines.

NoIndex Afhandeling Inschakelen

Wanneer ingeschakeld, krijgen pagina's met een noindex directive geen hreflang tags.

Waarom dit belangrijk is:

• Hreflang zegt "indexeer deze alternatieve versie"
• NoIndex zegt "indexeer deze pagina niet"
• Deze tegenstrijdige signalen verwarren zoekmachines

Aanbevolen:

• Schakel in als u noindex directives gebruikt op pagina's
• Werkt met custom attributen of Magmodules Sitemap and Robots module

Product Attribuut

Selecteer het product attribuut dat Meta Robots instellingen bevat (bijv. NOINDEX,FOLLOW).

Voor Magmodules Sitemap and Robots module: Gebruik mm_meta_robots

Categorie Attribuut

Selecteer het categorie attribuut dat Meta Robots instellingen bevat.

Voor Magmodules Sitemap and Robots module: Gebruik mm_meta_robots

CMS Pagina Kolom

Specificeer de database kolom in CMS pagina's die Meta Robots instellingen bevat.

Voor Magmodules Sitemap and Robots module: Gebruik mm_meta_robots

---

Third Party Ondersteuning

Third Party Ondersteuning Inschakelen

Schakel integraties in met third-party modules en sitemap generatie.

Third Party Modules

Selecteer met welke third-party modules geïntegreerd moet worden. Toont alleen modules die gedetecteerd en compatibel zijn.

---

Sitemap Integratie

Voeg hreflang data toe aan uw XML sitemap. Vereist de Magmodules Sitemap and Robots Module.

Wat dit doet: Voegt hreflang links toe aan uw sitemap.xml:

<url>
  <loc>https://example.com/product</loc>
  <xhtml:link rel="alternate" hreflang="en-us" href="https://example.com/product"/>
  <xhtml:link rel="alternate" hreflang="fr-fr" href="https://example.fr/produit"/>
</url>

Voordelen:

• Helpt zoekmachines hreflang relaties sneller te ontdekken
• Consistente data tussen HTML en sitemap
• Betere crawl efficiëntie voor internationale sites

Producten / Categorieën / CMS Pagina's / Homepage

Schakel hreflang data in de sitemap in voor elk paginatype.

Wanneer inschakelen:

• Corresponderend paginatype is ingeschakeld in Alternate Hreflang Configuratie
• U wilt dat zoekmachines variaties sneller ontdekken
• U gebruikt Magmodules Sitemap module

---

Debug & Logging

Debug Mode (Logging)

Schakel gedetailleerde logging in naar var/log/debug.log voor troubleshooting. Logt hreflang generatie events, store berekeningen en errors.

Wanneer inschakelen:

• Voor het eerst instellen
• Troubleshooting van problemen
• Testen van configuratie wijzigingen

Wanneer uitschakelen:

• Productie (na verificatie)
• Logs worden te groot
• Geen problemen worden onderzocht

Debug Mode Inschakelen (Frontend)

Sta het bekijken van hreflang tags toe door ?show-alternate=1 aan een URL toe te voegen.

Hoe te gebruiken:

1. Schakel deze instelling in
2. Bezoek een pagina met ?show-alternate=1
3. Bekijk gegenereerde hreflang tags in de output

Voorbeeld: https://example.com/product?show-alternate=1

Log Viewer

Bekijk en download log bestanden direct vanuit het admin panel. Handig voor het reviewen van errors en debug informatie.

Self-Test

Voer diagnostische tests uit op uw configuratie. Controleert module status, configuratie validiteit, store setup en URL generatie.

Gebruik dit om:

• Configuratie te verifiëren na wijzigingen
• Potentiële problemen te identificeren
• Compatibiliteit te controleren
• Taalcodes en store setup te valideren

---

Configuratie Tips

Begin eenvoudig:

1. Schakel module in
2. Configureer store targeting (één groep)
3. Schakel belangrijke paginatypen in (homepage, producten)
4. Test met debug mode
5. Breid configuratie uit indien nodig

Voor betere SEO:

• Schakel altijd canonical integratie in
• Schakel NoIndex afhandeling in bij gebruik van noindex directives
• Gebruik specifieke taalcodes (en-us vs en)
• Test configuratie voordat u live gaat

Prestaties:

• Schakel debug logging uit in productie
• Schakel alleen benodigde paginatypen in
• Gebruik sitemap integratie voor grote catalogi (vereist Sitemap and Robots Module)

---

Meer Hulp Nodig?

Documentatie:

• Alle Help Artikelen - Compleet documentatie overzicht

Support:

• Contact Opnemen - Hulp van ons team