# AI-vertaling & SEO: volledige gids

> Deze module vertaalt en verbetert de inhoud en de SEO-gegevens van uw producten, categorieën, CMS-pagina's en merken met de AI van uw keuze (ChatGPT van OpenAI, Claude van Anthropic, Gemini…

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

Deze module vertaalt en verbetert de inhoud en de SEO-gegevens van uw **producten, categorieën, CMS-pagina's en merken** met de AI van uw keuze (ChatGPT van OpenAI, Claude van Anthropic, Gemini van Google of Mistral) in alle talen die op uw PrestaShop 8- of 9-winkel zijn geïnstalleerd. Hij is voor de winkelbeheerder gemaakt: aanvinken, talen kiezen, starten.

**Kort samengevat:** koppel uw API-sleutel, kies fiches, bepaal de brontaal en de doeltalen en klik op _Starten_. Een voortgangsbalk verwerkt elke fiche per taal, zonder servertimeout. Een voorbeeld met vóór en na, een SEO-score en een rollback met één klik zitten erbij.

## Installatie

1. Ga in de backoffice naar **Modules > Modulebeheer**, klik op **Een module installeren** en verstuur het bestand `dfaicontent-1.1.0.zip`.
2. Na de installatie verschijnt er een tabblad **AI-inhoud & SEO** onder **Catalogus**.
3. Open het tabblad **Instellingen** om vóór het eerste gebruik minstens één AI-aanbieder in te stellen.

## Een AI-aanbieder instellen

De module werkt met vier aanbieders. U gebruikt **uw eigen API-sleutel** en betaalt de AI naar gebruik rechtstreeks bij de aanbieder: de module rekent geen enkel extra abonnement aan.

- **Actieve aanbieder**: de aanbieder die voor het aanmaken wordt gebruikt.
- **API-sleutel** en **Model** per aanbieder: bijvoorbeeld `gpt-4o-mini` (OpenAI), `claude-sonnet-4` (Anthropic), `gemini-2.0-flash` (Google) of `mistral-small-latest` (Mistral).
- Klik naast elke aanbieder op **Test** om de verbinding te controleren.

Om het budget in de hand te houden, begint u met een zuinig model (Mistral Small, GPT-4o mini). Een volledige productfiche vertalen kost doorgaans een fractie van een cent.

## Een vertaling starten (3 stappen)

1. **Vink** de producten of categorieën in de lijst aan (zoeken op naam of identificatie helpt bij het filteren).
2. Stel in de actiebalk de **brontaal**, de **doeltalen**, de **velden**, de **modus** en de **snelheid** in (1 tot 3 gelijktijdige verzoeken).
3. Klik op **Starten**. Er verschijnt een schatting van de tokens en de kosten ter bevestiging, waarna de wachtrij loopt met een voortgangsbalk en een logboek.

### De drie modi

- **Vertalen**: een getrouwe vertaling van de brontaal naar elke doeltaal.
- **Vertalen en verbeteren** (de standaard): eerst vertalen, daarna herschrijven voor copywriting en SEO.
- **Verbeteren (dezelfde taal)**: herschrijft elke doeltaal ter plaatse; de brontaal wordt genegeerd.

### Behandelde velden

- **Producten**: naam, korte beschrijving, beschrijving, metatitel, metabeschrijving, vereenvoudigde URL, tags (trefwoorden) en alt-teksten van de afbeeldingen.
- **Categorieën**: naam, beschrijving, aanvullende beschrijving, meta's en vereenvoudigde URL.
- **CMS-pagina's**: inhoud, metatitel, metabeschrijving en vereenvoudigde URL.
- **Merken**: korte en lange beschrijving, metatitel en metabeschrijving.

PrestaShop 8 heeft het veld _meta keywords_ geschrapt: de module maakt in de plaats daarvan **producttags** aan. Op een gemigreerde winkel waar de kolom nog bestaat, wordt die herkend en automatisch aangeboden.

## Voorbeeld met vóór en na

De knop **Voorbeeld** op een regel maakt de inhoud aan **zonder iets te bewaren** en toont een vergelijking van vóór en na. Bevalt het resultaat, dan bewaart _Deze inhoud toepassen_ precies wat u in het voorbeeld zag, zonder een tweede AI-aanroep en dus zonder extra kosten. Test altijd één fiche in het voorbeeld vóór u een groot lot start.

## SEO-score

De knop **SEO** op elke regel berekent per taal een score van 0 tot 100, met een gedetailleerde controlelijst: de lengte van de metatitel en de metabeschrijving, het trefwoord vooraan in de titel, de rijkdom van de inhoud, de tussentitels, de geldigheid van de slug, het aantal tags en de dekking van de alt-teksten.

## Samengaan met Creative Elements

Beschrijvingen die met Creative Elements (of Elementor) zijn opgebouwd, worden op twee manieren beschermd:

- **Tokenisatie**: scripts, stijlen, iframes, SVG's, shortcodes `[...]` en tijdelijke aanduidingen `{...}` worden vóór het versturen naar de AI door tokens vervangen, en daarna identiek teruggezet.
- **Een strikte systeeminstructie**: de AI vertaalt alleen de zichtbare tekst en behoudt alle tags, klassen, identificaties, inline stijlen en `data-*`-attributen.

Gebruikt u een Creative Elements-widget met een patroon dat nog niet is gedekt, voeg dan een patroon toe in de methode `protect()` van de klasse `DfAiContentProcessor`.

## Historiek en rollback

Elk lot komt in het logboek met de oude waarden van alle velden. Via het tabblad **Historiek** zet u een volledige bewerking met één klik terug, inclusief de tags en de alt-teksten. De bijbehorende historiekvermelding verdwijnt dan.

## Kostenraming

Vóór elke start meet de module het werkelijke volume van de gekozen inhoud in de database en toont hij het aantal aanroepen, de geschatte tokens in en uit, en de bijbehorende kosten volgens de tarieven per miljoen tokens die u in de instellingen hebt ingevuld.

## Cron voor automatisch vertalen

De module kan nieuwe inhoud vanzelf vertalen:

1. Schakel in **Instellingen > Cron** de cron in en stel de brontaal, de doeltalen, de velden, de types en de grens per doorloop in.
2. Kopieer de **met een token beveiligde URL** en roep die om de 5 tot 15 minuten aan vanuit de planner van uw hosting.

Bij elke doorloop spoort de module de fiches op waarvan de bron inhoud heeft maar waarvan de doeltalen geen metatitel en geen metabeschrijving hebben, en vertaalt hij daar een klein lot van. Een overslaglijst voorkomt dat een fiche met een fout eindeloos opnieuw wordt geprobeerd; het logboek van de laatste doorloop staat in de instellingen.

Maakt u het token opnieuw aan, dan werkt de oude cron-URL meteen niet meer: denk eraan uw planner bij te werken.

## Redactionele instellingen

- **Beschermde termen**: merken en productnamen die nooit worden vertaald (één per regel).
- **Woordenlijst**: opgelegde vertalingen, één regel per regel in de vorm `bronterm => vertaling`.
- **Schrijftoon**, **maximale SEO-lengtes** en **eigen instructies** voor uw winkel.

## Problemen oplossen

- **« Source content is empty »**: de fiche heeft geen inhoud in de gekozen brontaal; kies een andere brontaal.
- **Fout met de API-sleutel**: controleer de sleutel en het model in de Instellingen en gebruik daarna de knop Test.
- **Een doeltaal die gelijk is aan de brontaal** wordt in de modus Vertalen automatisch overgeslagen.

## Technische noten

- Geschikt voor PrestaShop 8.0 tot 9.x, zonder override van de kern (een beheercontroller en de native mechanismen).
- Werkt in multistore op de winkel van de huidige context.
- Geen enkele Composer-afhankelijkheid; de inhoud gaat uitsluitend naar de API van de gekozen aanbieder, met uw eigen sleutel.
