dfaimetagen: AI-generator voor metatitels, beschrijvingen en ALT-tags

Overzicht

dfaimetagen genereert in bulk uw metatitels, metabeschrijvingen en ALT-tags van afbeeldingen met AI (Anthropic Claude, OpenAI GPT of Mistral) op PrestaShop 8 en 9. De module dekt 6 soorten entiteiten (producten, categorieën, CMS-pagina’s, fabrikanten, leveranciers en productafbeeldingen), past beproefde CTR-patronen toe, maakt A/B-varianten, bewaakt de SERP-lengtes en weert dubbels via Jaccard-gelijkenis.

Vereisten

• PrestaShop 8.0 tot 9.x
• PHP 8.1, 8.2, 8.3 of 8.4
• PHP-extensies: curl, json, iconv
• MySQL 5.7+ of MariaDB 10.3+
• Een API-sleutel bij minstens één aanbieder: Anthropic, OpenAI of Mistral

Installatie

1. Download het bestand dfaimetagen.zip vanuit uw klantaccount.
2. Ga in de PrestaShop-backoffice naar Modules > Modulebeheer > Een nieuwe module toevoegen.
3. Upload de ZIP en klik op Installeren.
4. De module maakt 6 tabellen in de database aan (voorvoegsel df_aimeta_), installeert 11 standaard CTR-patronen en genereert een willekeurig CRON-token.
5. Er verschijnt een nieuw tabblad AI Meta Generator onder het menu Catalogus.

De AI-aanbieder instellen

1. Ga naar Catalogus > AI Meta Generator > Instellingen.
2. Kies uw actieve aanbieder: Anthropic (aanbevolen voor het Frans), OpenAI of Mistral.
3. Plak uw API-sleutel in het bijbehorende veld.
4. Klik op de knop Test naast het veld om de verbinding te controleren: u hoort het antwoord « OK » te krijgen.
5. De standaardmodellen zijn claude-sonnet-4-5, gpt-4o-mini en mistral-large-latest. U kunt die wijzigen als u een ander model van dezelfde aanbieder verkiest.

Instellingen voor de generatie

Nog steeds bij Instellingen kunt u bijstellen:

• Lengtelimieten: standaard afgestemd op de SERP-aanbevelingen van Google: metatitel 35 tot 60 tekens, metabeschrijving 120 tot 158, ALT 25 tot 125. Gaat de AI daarover, dan wordt de tekst netjes op een woordgrens afgekapt.
• A/B-varianten per item: van 1 tot 5 alternatieven per entiteit en per taal.
• Drempel tegen duplicatie: het percentage Jaccard-gelijkenis waarboven een variant wordt geweigerd (standaard 85 %). De vergelijking is ongevoelig voor accenten.
• Batchgrootte: aantal items dat per AJAX- of CRON-doorloop wordt verwerkt (standaard 10, tot 100).
• HTTP-timeout: maximale wachttijd op een antwoord van de aanbieder (standaard 60 s).
• Overschrijven / niet-lege overslaan: het standaardgedrag bij al ingevulde meta’s.

Een bulkgeneratie starten

1. Ga naar Catalogus > AI Meta Generator > Bulkgeneratie.
2. Entiteit: producten, categorieën, CMS-pagina’s, fabrikanten, leveranciers of productafbeeldingen.
3. Veld: metatitel, metabeschrijving of ALT van de afbeelding (de ALT-tags gelden voor productafbeeldingen).
4. CTR-patroon: kies een bepaald patroon of laat Auto staan om het standaardpatroon van het veld te gebruiken.
5. Talen: meervoudige keuze, waarbij de generatie wordt vermenigvuldigd (items × talen).
6. Bereik: alle entiteiten, een lijst met ID’s, of een filter op categorie of fabrikant.
7. Limiet: zet 10 of 20 voor een test, 0 om alles te verwerken.
8. Klik op De taak aanmaken.

Taken opvolgen en uitvoeren

De pagina Taken toont alle taken met hun voortgang, hun statistieken (geslaagd / mislukt / overgeslagen) en hun status. Er zijn drie manieren van uitvoeren:

• Uitvoeren tot klaar (op de detailpagina van de taak): verwerkt de batches in een lus via AJAX, met een voortgangsbalk in real time. Houd het tabblad open.
• Eén batch uitvoeren: verwerkt één batch en herlaadt daarna de pagina.
• CRON: verwerking op de achtergrond, aanbevolen voor grote catalogi (zie hieronder).

Een taak kan tijdens de uitvoering worden geannuleerd, vanaf het begin worden herstart of worden verwijderd. De volledige historiek van elke generatie (status, tokens in en uit, eventuele fout) blijft bewaard in het tabblad Historiek van het taakdetail.

De CRON instellen

1. Kopieer bij Instellingen, sectie CRON, de getoonde URL. Die heeft deze vorm:
   https://uw-winkel.nl/modules/dfaimetagen/cron.php?token=UW_TOKEN
2. Voeg die toe aan de crontab van uw server, bijvoorbeeld elke 5 minuten:
   */5 * * * * curl -s "https://uw-winkel.nl/modules/dfaimetagen/cron.php?token=UW_TOKEN" >/dev/null
3. Elke doorloop verwerkt tot 5 batches van de oudste wachtende taak. Optionele parameters: &batch=20 (batchgrootte) en &loops=10 (aantal batches per doorloop).

A/B-varianten en activering

Elke generatie levert het ingestelde aantal varianten op (1 tot 5). De eerste geldige variant wordt op de entiteit weggeschreven en als Actief gemarkeerd. De andere blijven in reserve op de detailpagina van de taak:

• Klik op Activeren naast een variant om die meteen op de entiteit weg te schrijven.
• De andere varianten van hetzelfde drietal (entiteit, veld, taal) worden automatisch gedeactiveerd.
• De tekenteller bij elke variant laat u in één oogopslag de SERP-conformiteit nagaan.

CTR-patronen

De 11 vooraf geïnstalleerde patronen dekken drie families:

• Metatitels: voordeel + jaartal, genummerde lijst, USP tussen haakjes, vraaghaak, krachtwoorden.
• Metabeschrijvingen: opeenstapeling van voordelen, sociale bewijskracht, probleem en oplossing, directe call to action.
• ALT-tags van afbeeldingen: beschrijvend en contextueel.

Wilt u eigen patronen maken, ga dan naar Catalogus > AI Meta Generator > Patronen. Het sjabloon aanvaardt dynamische tokens:

• {NAME}, {BRAND}, {CATEGORY}, {PRICE}, {YEAR}, {NUMBER}, {LANG_NAME}: automatisch door de module ingevuld;
• {BENEFIT}, {USP}, {CONTEXT}: door de AI ingevuld op het moment van de generatie.

Patronen met de vermelding « systeem » worden met de module meegeleverd en blijven bij updates behouden.

Geavanceerde promptsjablonen

Wilt u het gedrag van de AI volledig sturen, maak dan sjablonen aan in Catalogus > AI Meta Generator > Promptsjablonen. Elk sjabloon richt zich op een drietal (entiteit, veld, taal of alle talen) en bepaalt:

• de systeemprompt: rol, toon en globale beperkingen;
• de gebruikersprompt, met de tokens {NAME}, {BRAND}, {CATEGORY}, {DESCRIPTION}, {PRICE}, {PATTERN}, {LANG_NAME}, {MIN_LENGTH}, {MAX_LENGTH}, {AB_VARIANTS} en {EXISTING}.

Markeer een sjabloon als « standaard » zodat het automatisch op zijn drietal wordt toegepast.

Bescherming tegen duplicatie

Vóór een variant wordt bewaard, vergelijkt de module die met de al opgeslagen varianten:

1. Exacte hash (sha1 van de genormaliseerde versie): meteen geweigerd bij een perfect duplicaat.
2. Jaccard-gelijkenis op de verzamelingen genormaliseerde woorden (kleine letters, zonder accenten): geweigerd zodra de gelijkenis boven de ingestelde drempel ligt.

Een geweigerde variant wordt automatisch opnieuw door de AI gegenereerd, binnen het aantal pogingen van de batch.

Dashboard

De pagina Dashboard bundelt: het aantal taken (totaal, in afwachting, afgerond), de gegenereerde en actieve varianten, de geslaagde en mislukte generaties, de verbruikte tokens (in en uit), de recentste taken en de recentste generaties. Gebruik die pagina om uw AI-budget te bewaken en fouten bij de aanbieder op te sporen.

Multistore

De module leest en schrijft de waarden met inachtneming van de winkelcontext wanneer de betrokken *_lang-tabel een kolom id_shop heeft. Kies in het bulkgeneratieformulier de doelwinkel als uw installatie in multistore draait.

Problemen oplossen

• « FAIL » bij de verbindingstest: controleer de API-sleutel, het kredietsaldo bij de aanbieder, en of uw server uitgaande HTTPS-verbindingen (cURL) naar api.anthropic.com, api.openai.com of api.mistral.ai toelaat.
• Taak blijft op « running » staan: start handmatig een batch vanaf de detailpagina, of wacht op de volgende CRON-doorloop. Een taak kan altijd worden geannuleerd en opnieuw gestart.
• Lege of afgekapte varianten: verhoog de HTTP-timeout in de Instellingen, of kies een sneller model.
• 403 op de CRON-URL: het token in de URL klopt niet meer (mogelijk opnieuw gegenereerd). Kopieer de URL opnieuw uit de Instellingen.
• Er wordt niets gegenereerd voor bepaalde entiteiten: staat « Niet-lege overslaan » aan, dan worden al ingevulde entiteiten bewust overgeslagen. Vink « Overschrijven » aan om dat af te dwingen.

Verwijderen

Bij het verwijderen worden de 6 tabellen van de module en zijn configuratiesleutels gewist. De gegenereerde meta’s die al op uw producten, categorieën en afbeeldingen zijn weggeschreven, blijven behouden: zij maken deel uit van uw catalogus.