Probleemoplossing SEO Meta Templates

Symptomen:

• Productpagina toont nog steeds de originele meta tags
• Template werkt in preview maar niet op de frontend

Oplossing:

1. Controleer Override Mode — als deze op "Fallback Only" staat, worden bestaande meta tags van het product niet overschreven. Leeg de meta titel/description velden van het product of schakel over naar "Always Override"
2. Verifieer dat de store view van het template de winkel bevat waarop je test
3. Als je conditions gebruikt, test of het product matcht door het SKU in te voeren in de preview
4. Controleer template prioriteit — een template met hogere prioriteit (lager nummer) zonder matchende template velden kan winnen
5. Leeg de full page cache na wijzigingen

Preventie:

• Gebruik de preview functie om te verifieren dat templates matchen op specifieke producten voordat je op de frontend vertrouwt

Symptomen:

• Meta titel toont "{name}" letterlijk, of variabelen resolven naar lege strings
• Template zoals {name} - {color} produceert "Widget - "

Oplossing:

1. Controleer of de variabelenaam correct is — deze moet exact overeenkomen met de product attribute code
2. Voor custom attributen, zorg dat het attribuut een waarde heeft ingesteld voor dat specifieke product
3. Voor {brand} leest de module het manufacturer attribuut — zorg dat dit is ingevuld
4. Gebruik optionele wrapping voor onbetrouwbare variabelen: {name}[ - {color}] in plaats van {name} - {color}

Preventie:

• Wrap optionele variabelen altijd in vierkante haken
• Gebruik de preview functie met een echt SKU om te controleren welke variabelen resolven

Symptomen:

• Meta titel of description wordt halverwege een zin afgesneden
• Tekens lijken te verdwijnen aan het einde

Oplossing:

1. Controleer Title Max Length en Description Max Length in de configuratie
2. De module kapt af op woordgrenzen — een limiet van 60 tekens kan resulteren in minder tekens als het volgende woord de limiet zou overschrijden
3. Verhoog de maximale lengte als je templates consistent langere tekst produceren

Preventie:

• Houd templates beknopt, vooral voor titels
• Test met de preview om de daadwerkelijke output lengte te zien

Symptomen:

• Een product krijgt meta van het verkeerde template
• Wijzigingen aan een template lijken geen effect te hebben

Oplossing:

1. Controleer prioriteiten — templates worden geevalueerd van laagste nummer (hoogste prioriteit) naar hoogste nummer
2. Het eerste template dat matcht (correct entity type, store view en voldoet aan conditions) wint
3. Als twee templates dezelfde prioriteit hebben, zijn resultaten onvoorspelbaar — gebruik verschillende prioriteitswaarden
4. Controleer conditions op elk template — een template zonder conditions matcht alles

Preventie:

• Gebruik stappen van 5 of 10 voor prioriteiten (5, 10, 15, 20)
• Zet specifieke/conditionele templates op hogere prioriteit (lager nummer) dan generieke fallbacks

Symptomen:

• Product template met SKU conditie wordt toegepast op alle producten
• Conditioneel template lijkt genegeerd te worden

Oplossing:

1. Conditions werken alleen voor het Product entity type — Category en CMS Page templates negeren conditions volledig
2. Verifieer na het opslaan van conditions dat ze correct zijn opgeslagen door het template opnieuw te openen
3. Test de conditie door een matchend en niet-matchend SKU in te voeren in de preview

Preventie:

• Test conditions altijd met de preview functie voordat je opslaat
• Onthoud dat een template zonder conditions alle producten van dat entity type matcht

Symptomen:

• Meta titel en description worden correct bijgewerkt maar H1 blijft hetzelfde

Oplossing:

1. Zorg dat het H1 Template veld is ingevuld — het is apart van het meta titel template
2. Sommige thema's overschrijven de H1 heading met custom blocks — de module plugt in op Magento\Theme\Block\Html\Title, wat niet alle custom thema's gebruiken
3. Leeg de full page cache

Preventie:

• Test met een standaard Magento thema (Luma) om te isoleren of het probleem thema-gerelateerd is