# Traduction IA & SEO — Guide complet

> Ce module traduit et améliore le contenu et les données SEO de vos produits, catégories, pages CMS et marques avec l'IA de votre choix — ChatGPT (OpenAI), Claude (Anthropic), Gemini…

- Page: <https://www.datafirefly.com/documentation/ai-translation-seo-prestashop/>
- Langue: fr
- Mis à jour le: 2026-06-17
- Autres langues: [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), [nl](https://www.datafirefly.com/nl/documentation/ai-translation-seo-prestashop/index.md)
- Index: <https://www.datafirefly.com/documentation/llms.txt>

Ce module traduit et améliore le contenu et les données SEO de vos **produits, catégories, pages CMS et marques** avec l'IA de votre choix — ChatGPT (OpenAI), Claude (Anthropic), Gemini (Google) ou Mistral — dans toutes les langues installées sur votre boutique PrestaShop 8 ou 9. Pensé pour le gestionnaire de boutique : on coche, on choisit les langues, on lance.

**En bref :** branchez votre clé API, sélectionnez des fiches, choisissez langue source et langues cibles, cliquez _Lancer_. Une barre de progression traite chaque fiche × langue sans timeout serveur. Aperçu avant/après, score SEO et rollback en un clic inclus.

## Installation

1. Dans le back-office, allez dans **Modules > Gestionnaire de modules**, cliquez sur **Installer un module** et envoyez le fichier `dfaicontent-1.1.0.zip`.
2. Une fois installé, un onglet **Contenu IA & SEO** apparaît sous **Catalogue**.
3. Ouvrez l'onglet **Paramètres** pour configurer au moins un fournisseur d'IA avant la première utilisation.

## Configurer un fournisseur d'IA

Le module est compatible avec quatre fournisseurs. Vous utilisez **votre propre clé API** et payez l'IA à l'usage directement auprès du fournisseur — aucun abonnement supplémentaire n'est facturé par le module.

- **Fournisseur actif** : le fournisseur utilisé pour les générations.
- **Clé API** et **Modèle** par fournisseur : par exemple `gpt-4o-mini` (OpenAI), `claude-sonnet-4` (Anthropic), `gemini-2.0-flash` (Google), `mistral-small-latest` (Mistral).
- Cliquez sur **Test** à côté de chaque fournisseur pour vérifier la connexion.

Pour maîtriser le budget, commencez avec un modèle économique (Mistral Small, GPT-4o mini). La traduction complète d'une fiche produit coûte typiquement une fraction de centime.

## Lancer une traduction (3 étapes)

1. **Cochez** les produits ou catégories dans la liste (la recherche par nom ou ID aide à filtrer).
2. Dans la barre d'action, réglez la **langue source**, les **langues cibles**, les **champs** à traiter, le **mode** et la **vitesse** (1 à 3 requêtes en parallèle).
3. Cliquez **Lancer**. Une estimation des tokens et du coût s'affiche pour confirmation, puis la file s'exécute avec une barre de progression et un journal.

### Les trois modes

- **Traduire** : traduction fidèle de la langue source vers chaque langue cible.
- **Traduire + améliorer** (par défaut) : traduction puis réécriture copywriting et SEO.
- **Améliorer (même langue)** : réécrit chaque langue cible sur place ; la langue source est ignorée.

### Champs gérés

- **Produits** : nom, description courte, description, meta titre, meta description, URL conviviale, tags (mots-clés) et balises alt des images.
- **Catégories** : nom, description, description additionnelle, metas, URL conviviale.
- **Pages CMS** : contenu, meta titre, meta description, URL conviviale.
- **Marques** : descriptions courte et longue, meta titre, meta description.

PrestaShop 8 a supprimé le champ _meta keywords_ : le module génère des **tags produits** à la place. Sur une boutique migrée où la colonne existe encore, elle est détectée et proposée automatiquement.

## Aperçu avant / après

Le bouton **Aperçu** sur une ligne génère le contenu **sans rien enregistrer** et affiche un comparatif avant/après. Si le résultat convient, _Appliquer ce contenu_ enregistre exactement ce qui a été prévisualisé — sans second appel IA, donc sans coût supplémentaire. Testez toujours une fiche en aperçu avant un gros lot.

## Score SEO

Le bouton **SEO** sur chaque ligne calcule un score de 0 à 100 par langue, avec une checklist détaillée : longueurs du meta titre et de la meta description, présence du mot-clé en tête de titre, richesse du contenu, sous-titres, validité du slug, nombre de tags et couverture des balises alt.

## Compatibilité Creative Elements

Les descriptions construites avec Creative Elements (ou Elementor) sont protégées par deux mécanismes :

- **Tokenisation** : les scripts, styles, iframes, SVG, shortcodes `[...]` et placeholders `{...}` sont remplacés par des jetons avant l'envoi à l'IA, puis réinjectés à l'identique.
- **Consigne système stricte** : l'IA ne traduit que le texte visible et préserve toutes les balises, classes, ids, styles inline et attributs `data-*`.

Si vous utilisez un widget Creative Elements qui produit un motif non couvert, ajoutez un motif dans la méthode `protect()` de la classe `DfAiContentProcessor`.

## Historique & rollback

Chaque lot est journalisé avec les anciennes valeurs de tous les champs. L'onglet **Historique** permet de restaurer une opération complète en un clic — tags et balises alt compris. L'entrée d'historique est alors supprimée.

## Estimation du coût

Avant chaque lancement, le module mesure le volume réel des contenus sélectionnés en base et affiche le nombre d'appels, les tokens estimés en entrée et en sortie, et le coût correspondant selon les tarifs au million de tokens que vous avez configurés dans les paramètres.

## Cron d'auto-traduction

Le module peut traduire automatiquement les nouveaux contenus :

1. Dans **Paramètres > Cron**, activez le cron et réglez la langue source, les langues cibles, les champs, les types et la limite par exécution.
2. Copiez l'**URL sécurisée par token** et appelez-la toutes les 5 à 15 minutes depuis le planificateur de votre hébergement.

À chaque passage, le module détecte les fiches dont la source a du contenu mais dont les cibles n'ont ni meta titre ni description, et en traduit un petit lot. Une liste de skip évite de réessayer indéfiniment une fiche en erreur ; le journal du dernier passage est affiché dans les paramètres.

Si vous régénérez le token, l'ancienne URL de cron cesse immédiatement de fonctionner : pensez à mettre à jour votre planificateur.

## Réglages éditoriaux

- **Termes protégés** : marques et noms de produits jamais traduits (un par ligne).
- **Glossaire** : traductions imposées, une règle par ligne au format `terme source => traduction`.
- **Ton d'écriture**, **longueurs SEO max** et **instructions personnalisées** propres à votre boutique.

## Dépannage

- **« Source content is empty »** : la fiche n'a pas de contenu dans la langue source choisie — sélectionnez une autre langue source.
- **Erreur de clé API** : vérifiez la clé et le modèle dans Paramètres, puis utilisez le bouton Test.
- **Une langue cible identique à la source** est automatiquement ignorée en mode Traduire.

## Notes techniques

- Compatible PrestaShop 8.0 à 9.x, sans override du coeur (contrôleur d'administration + mécanismes natifs).
- Agit sur la boutique du contexte courant en multiboutique.
- Aucune dépendance Composer ; les contenus sont envoyés uniquement à l'API du fournisseur choisi via votre clé.