# 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…

- Pagina: <https://www.datafirefly.com/nl/documentation/dfaimetagen/>
- Taal: nl
- Bijgewerkt op: 2026-09-09
- Andere talen: [fr](https://www.datafirefly.com/documentation/dfaimetagen/index.md), [en](https://www.datafirefly.com/en/documentation/dfaimetagen/index.md), [es](https://www.datafirefly.com/es/documentation/dfaimetagen/index.md), [de](https://www.datafirefly.com/de/documentation/dfaimetagen/index.md), [it](https://www.datafirefly.com/it/documentation/dfaimetagen/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfaimetagen/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfaimetagen/index.md)
- Index: <https://www.datafirefly.com/nl/documentation/llms.txt>

## 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](https://console.anthropic.com), [OpenAI](https://platform.openai.com) of [Mistral](https://console.mistral.ai)

## 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.

De API-sleutels worden in de Configuration-tabel van PrestaShop bewaard en komen nooit aan de frontzijde terecht. De module bevat geen AI-krediet: elke generatie verbruikt uw eigen quotum bij de aanbieder (ongeveer 0,0005 tot 0,003 € per generatie).

## 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**.

Begin altijd met een taak van 10 tot 20 items om de toon en de vorm van de gegenereerde teksten te beoordelen, stel zo nodig het patroon of het sjabloon bij, en start daarna zonder limiet.

## 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).

Het token beveiligt het endpoint: deel het niet. Twijfelt u, genereer het dan opnieuw via de Instellingen (knop « Het token opnieuw genereren ») en denk eraan uw crontab bij te werken.

## 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.