DF Glossary: SEO-woordenlijst voor PrestaShop 8 en 9

Overzicht

DF Glossary maakt van uw vakjargon een SEO-troef. U voert uw termen één keer in, met een korte en een lange definitie, en de module doet automatisch drie dingen: hij injecteert een link met tooltip op elke voorkomst van de term in uw productbeschrijvingen, categorieën en CMS-pagina’s; hij publiceert per term een indexeerbare definitiepagina; en hij verbindt elke definitie met de producten die u eraan koppelt.

Het resultaat is een tweerichtingsnetwerk van interne links dat zonder redactionele inspanning ontstaat: uw fiches versterken uw definities, uw definities versterken uw producten, en uw definities versterken elkaar onderling.

Installatie

Vereisten

• PrestaShop 8.0, 8.1, 8.2 of 9.x
• PHP 7.4 tot 8.3
• MySQL 5.7 / MariaDB 10.3 of hoger
• Vereenvoudigde URL’s ingeschakeld (Winkelinstellingen, Verkeer en SEO): onmisbaar voor de pagina’s van de woordenlijst

Procedure

1. Ga in de backoffice naar Modules → Modulebeheer → Een module installeren.
2. Upload het bestand dfglossary-1.0.0.zip.
3. De installatie maakt vier SQL-tabellen, een backofficetabblad en de standaard configuratiesleutels aan.
4. Er verschijnt een nieuw tabblad Catalogus → SEO-woordenlijst in het menu. Daar beheert u uw termen.
5. Klik in het modulebeheer op Configureren om bij de globale instellingen te komen.

Configuratie van de module

Het configuratiepaneel bestaat uit drie secties.

Activering en injectiemodus

• Injectie inschakelen: hoofdschakelaar. Staat die uit, dan verrijkt de module uw inhoud niet meer, maar blijven de pagina’s van de woordenlijst online en geïndexeerd.
• Modus: drie mogelijke waarden:
  • Link + tooltip (standaard): de term wordt een link naar zijn definitiepagina en toont de tooltip bij het zweven met de muis. Deze modus combineert het SEO-voordeel met het conversievoordeel.
  • Alleen link: de term wordt een link, zonder tooltip. Te verkiezen als u enkel interne links nastreeft.
  • Alleen tooltip: de term toont de definitie bij het zweven, zonder een link te worden. Te verkiezen als u wilt informeren zonder uitgaande links aan uw productfiches toe te voegen.

Limieten (bescherming tegen overoptimalisatie)

• Maximaal aantal voorkomens per term: standaard 1. Ook al staat een woord acht keer in een beschrijving, alleen de eerste voorkomst wordt een link. Wij raden sterk aan deze waarde te behouden: één link per begrip volstaat om het semantische signaal door te geven, en de volgende verdunnen de interne PageRank zonder iets bij te dragen.
• Maximaal aantal links per inhoud: standaard 10, alle termen samen. Daarboven stopt de motor, ongeacht welke termen er nog resten.

Beoogde inhoud

Vier onafhankelijke schakelaars bepalen waar de injectie geldt:

• Productbeschrijvingen: de lange beschrijving.
• De korte beschrijving meenemen: een aparte optie. Let op: de korte beschrijving staat vaak boven aan de fiche en in de lijsten; er links in plaatsen kan overdreven zijn.
• Categoriebeschrijvingen: beschrijving en aanvullende beschrijving.
• CMS-pagina’s en CMS-categorieën: de inhoud van de CMS-pagina’s.

URL-basis

Het veld URL-basis bepaalt onder welk segment de pagina’s van de woordenlijst worden gepubliceerd. Standaardwaarde: woordenlijst, wat /woordenlijst voor de index geeft en /woordenlijst/gecoat-doek voor de fiche van een term. Het veld wordt gevalideerd als een link-rewrite: alleen letters, cijfers en koppeltekens.

Termen beheren

Ga naar Catalogus → SEO-woordenlijst. De lijst toont al uw termen met hun slug, hun status voor automatisch koppelen en hun activeringsstatus. U kunt zoeken, sorteren, filteren, met één klik in- of uitschakelen, en in bulk verwijderen.

Een term aanmaken

Klik op Een term toevoegen. Het formulier is volledig meertalig: elk tekstveld vult u per taal in.

• Term: het exacte woord dat in uw inhoud wordt gezocht. De vergelijking negeert hoofdletters en respecteert woordgrenzen.
• Slug: de identificatie in de URL. Laat leeg om die automatisch uit de naam te laten genereren.
• Synoniemen: lijst gescheiden door komma’s. Meervouden, afkortingen en spellingvarianten: al die vormen roepen dezelfde link en dezelfde tooltip op.
• Korte definitie: dit is de tekst van de tooltip. Platte tekst aanbevolen. Hij wordt in de tooltip tot 180 tekens afgekapt, maar verschijnt volledig boven aan de definitiepagina.
• Lange definitie: rijke editor. Dit is de hoofdtekst van de definitiepagina en de inhoud die in Google zal scoren.
• Metatitel / Metabeschrijving: optioneel. Ontbreken ze, dan valt de module automatisch terug op de naam van de term en de korte definitie.
• Gekoppelde producten: lijst met product-ID’s, gescheiden door komma’s. Hun miniaturen verschijnen op de pagina van de term.
• Automatisch koppelen: schakelaar per term. Staat die uit, dan behoudt de term zijn geïndexeerde definitiepagina maar wordt hij nooit in de inhoud geïnjecteerd.
• Actief: staat dit uit, dan verdwijnt de term uit de woordenlijst en geeft zijn pagina een nette 404.

Goede redactionele praktijken

• Mik op 20 tot 50 termen. De hoeveelheid is niet de bepalende factor: een term verdient zijn plaats als hij daadwerkelijk in uw beschrijvingen voorkomt en als hij aansluit bij een vraag die uw klanten zich stellen.
• Schrijf lange definities van 150 tot 400 woorden. Genoeg om voor Google zelfstandige inhoud te vormen, kort genoeg om vlot te schrijven.
• Koppel 2 tot 6 producten per term, niet meer. Een definitiepagina die naar twintig producten wijst, verdunt haar autoriteit.
• Besteed zorg aan de synoniemen. Dat is de hefboom die de dekking vermenigvuldigt: een catalogus die over meerdere jaren door verschillende mensen is geschreven, verwoordt eenzelfde begrip zelden op één manier.
• Vertaal de synoniemen niet woord voor woord. Elke taal heeft eigen varianten; voer ze onafhankelijk in.

Hoe de injectie werkt

De verrijking gebeurt aan serverzijde, op het moment dat de pagina wordt opgebouwd, via de contentfilterhooks van PrestaShop. Uw beschrijvingen worden nooit in de database gewijzigd: schakelt u de module uit, dan krijgt uw inhoud onmiddellijk zijn oorspronkelijke vorm terug.

De vervangingsmotor

De inhoud wordt opgesplitst in tagsegmenten en tekstsegmenten. Alleen de tekstsegmenten komen voor vervanging in aanmerking. De volgende zones worden stelselmatig overgeslagen:

• bestaande links (geen risico op een geneste link),
• koppen h1, h2 en h3,
• blokken script, style, code, pre, svg en noscript,
• formuliervelden: textarea, select, option, button,
• iframes.

Binnen de toegelaten segmenten gebruikt het zoeken Unicode-woordgrenzen: het is onmogelijk om een fragment binnen een woord of een identificatie om te zetten. De vergelijking negeert hoofdletters en verdraagt meerdere spaties of regeleinden. Tot slot wordt elke geïnjecteerde link tijdens de verwerking tijdelijk door een uniek token vervangen, zodat een term nooit opnieuw kan worden gekoppeld binnen een link die de module zelf zonet heeft gemaakt.

Prioriteit van de varianten

Alle varianten van een term (hoofdnaam en synoniemen) worden samengevoegd en daarna op aflopende lengte gesorteerd. De langste uitdrukking wint altijd. Staan zowel gecoat doek PVC als gecoat doek in uw synoniemen, dan wordt het eerste gekoppeld zodra het volledig voorkomt.

De pagina’s van de woordenlijst

Indexpagina

Bereikbaar op /woordenlijst, toont zij alle actieve termen, per letter gegroepeerd, met een alfabetische navigatie en per term een uittreksel. Zij zendt een JSON-LD van het type DefinedTermSet uit.

Definitiepagina

Bereikbaar op /woordenlijst/{slug}, bevat elke fiche:

• een H1-titel en de korte definitie in de kijker,
• de lange definitie in rijk formaat, waarin de andere termen van de woordenlijst op hun beurt automatisch worden gekoppeld (de huidige term is uitgesloten, geen zelfverwijzing),
• de miniaturen van de gekoppelde producten,
• een wolk met verwante termen,
• een eigen metatitel en metabeschrijving, een canonieke URL en een kruimelpad,
• een JSON-LD van het type DefinedTerm.

Bestaat een slug niet of is de term uitgeschakeld, dan geeft de pagina een nette 404.

Meertaligheid en multistore

Alle tekstvelden van de woordenlijst zijn meertalig: naam, synoniemen, definities, slug, metatitel en metabeschrijving kunnen per taal verschillen. Het matchen gebeurt altijd in de taal van de huidige context: een Nederlandse beschrijving wordt nooit met Engelse termen verrijkt.

In multistore worden de termen via de standaard koppeltabel van PrestaShop aan de winkels gekoppeld. U kunt dus een dichte technische woordenlijst op een B2B-winkel voeren en een toegankelijke woordenlijst op een B2C-winkel, binnen dezelfde installatie.

Gedrag op mobiel

Op een aanraakscherm bestaat er geen zweven met de muis. De module laadt een klein script dat de tik afhandelt: de eerste tik op een term toont de tooltip en blokkeert de navigatie, de tweede tik opent de definitiepagina. Andere geopende tooltips sluiten automatisch, en een tik buiten de term sluit de tooltip.

Prestaties

Het woordenboek met de termen wordt één keer per verzoek geladen en statisch in cache gezet: zelfs een categoriepagina met dertig producten veroorzaakt maar één SQL-query voor de woordenlijst. De vervanging zelf is een tekstbewerking in PHP, in de orde van een milliseconde. Er wordt geen blokkerende JavaScript geladen, er is geen enkele netwerkaanroep, en het resultaat werkt naadloos samen met een full-pagecache.

Problemen oplossen

Er verschijnt geen enkele link in mijn productfiches

• Controleer of de hoofdschakelaar Injectie inschakelen op Ja staat.
• Controleer of Productbeschrijvingen is aangevinkt bij de beoogde inhoud.
• Controleer of de term actief is en of zijn automatisch koppelen aanstaat.
• Controleer of de term wel is ingevuld in de taal van de bekeken fiche: een term die alleen in het Frans is ingevoerd, wordt nooit in een Engelse beschrijving geïnjecteerd.
• Leeg de PrestaShop-cache (Geavanceerde parameters → Prestaties).

De term staat in de tekst maar is niet gekoppeld

Drie mogelijke oorzaken. Ofwel staat de term al binnen een link, een kop h1 tot h3 of een beschermde zone, en dat is het gewenste gedrag. Ofwel is de limiet aan voorkomens per term (standaard 1) voor die inhoud al bereikt: de volgende voorkomens blijven platte tekst, wat normaal is. Ofwel is de globale limiet van 10 links per inhoud bereikt.

De pagina’s van de woordenlijst geven een 404

• Controleer of de vereenvoudigde URL’s actief zijn.
• Genereer het .htaccess-bestand opnieuw (Winkelinstellingen → Verkeer en SEO → Het .htaccess-bestand genereren).
• Controleer of de term actief is en of zijn slug in de bekeken taal is ingevuld.

De tooltips verschijnen niet

Controleer of de modus niet op Alleen link staat. Klopt de modus, leeg dan de cache en controleer of de stylesheet van de module wel wordt geladen (die wordt automatisch op alle pagina’s aan de frontzijde toegevoegd).

Verwijderen

Bij het verwijderen worden de vier SQL-tabellen van de module, het backofficetabblad en alle configuratiesleutels gewist. Uw termen gaan dus definitief verloren: exporteer ze als u later opnieuw wilt installeren. Geen enkele product-, categorie- of CMS-beschrijving is echter ooit in de database gewijzigd: uw inhoud krijgt eenvoudigweg zijn oorspronkelijke vorm terug, zonder dat u iets hoeft op te ruimen.

Bekende beperkingen

• De uniciteit van de slugs wordt niet per taal afgedwongen. Delen twee termen dezelfde slug in dezelfde taal, dan wint de eerst gevonden term. Controleer uw slugs bij het invoeren.
• De beschermde zones (links, koppen h1 tot h3, code, formulieren) worden nooit verrijkt. Dat is een ontwerpkeuze, geen beperking die u kunt omzeilen.