Le plugin repose sur l’API OpenAI.
La clé est saisie dans une page d’administration réservée à l’administrateur, jamais visible pour les autres rôles.

Lorsqu’on lance une génération, le plugin scanne la médiathèque et repère toutes les images sans texte alternatif.
Pour chaque image, il identifie son contexte d’utilisation :
– page où elle apparaît (contenu, image mise en avant, galerie…),
– titre de la page ou du produit,
– et, s’il existe, la métadescription associée.

Les images sont ensuite traitées en batch — par exemple 100 d’un coup — puis les balises alt sont directement enregistrées dans la médiathèque.
Seules les nouvelles images uploadées déclenchent une génération en direct, avec aperçu avant validation.

Construction du contexte

Le script adapte le prompt selon le type de contenu concerné :

• WooCommerce : le plugin combine le nom du produit et les informations de la boutique (activité, gamme, valeurs).
• CPT classique : il assemble le titre du contenu et sa métadescription éventuelle, pour créer un contexte sémantique pertinent.

Gestion du contexte selon le type de site

Le texte d’activité utilisé comme base de contexte varie selon la configuration du site et la position de l’image.

• Sans WooCommerce, le plugin s’appuie sur le champ « General Context for Descriptions ». Ce texte décrit l’activité, les valeurs ou la mission de l’entreprise. Il sert de cadre général pour aider l’IA à comprendre le domaine.
• Avec WooCommerce, si l’option « Rechercher des produits WooCommerce » est activée, le plugin utilise le champ “Informations sur la boutique” en complément du contexte général. Cela permet de préciser la nature des produits ou le type d’artisanat concerné, tout en conservant la cohérence avec la description d’ensemble du site.

Dans tous les cas, le plugin analyse également l’endroit où chaque image est utilisée :

• image mise en avant d’un article, d’une page ou d’un produit,
• image intégrée dans le contenu d’un bloc Gutenberg,
• ou image de produit / galerie WooCommerce.

Pour chaque cas, il récupère le titre du contenu associé (CPT ou produit) et, si Yoast SEO est installé, la méta description correspondante.
Ces éléments s’ajoutent automatiquement au prompt pour fournir à l’IA un contexte complet : activité du site + sujet précis du contenu + informations produit le cas échéant.

Structure du prompt complet

Pour chaque image détectée, le plugin assemble automatiquement un prompt complet envoyé à OpenAI.

Ce prompt contient trois éléments complémentaires, qui aident l’IA à produire une description pertinente :

A. L’instruction principale

Générez une description courte et précise pour cette balise alt, sans aucune autre explication.

B. Le contexte du site et du contenu

Le plugin ajoute le texte d’activité défini dans les réglages (champ General Context for Descriptions), puis complète ce contexte avec le titre et la méta description de la page ou du produit où l’image apparaît.
Si WooCommerce est actif, les informations sur la boutique viennent s’ajouter pour préciser la nature des produits.

C. La contrainte finale

La réponse ne doit pas dépasser 150 caractères.

Ce contexte enrichi est ensuite envoyé à OpenAI en même temps que l’image.

Le modèle lit ces informations, essaie de reconnaître ce qu’il voit,

et tente de l’associer au sujet fourni : un événement, un produit, un lieu, une ambiance.

Autrement dit, il ne se contente pas de décrire la photo — il la contextualise dans le cadre du site.

Ce plugin ne remplace pas un audit RGAA, mais il aide à reprendre le contrôle sur la base.
Sur un site de mairie, c’est déjà un gain colossal.
Sur un site privé, c’est une anticipation bienvenue avant 2027–2028.
Chaque génération respecte les bonnes pratiques : un texte concis, pertinent et cohérent avec le contenu réel.

💬 En résumé :

Un plugin pensé pour simplifier le travail humain, pas pour le remplacer.

En pratique

L’interface affiche le nombre d’images détectées sans texte alternatif, par exemple :

212 images à traiter.

Deux actions principales sont disponibles :

• 🪄 Générer les textes alternatifs : lance la génération en batch sur toutes les images sans alt. Les nouvelles balises sont directement enregistrées dans la médiathèque.

Après la génération, il est conseillé de contrôler les résultats obtenus.
Si plusieurs textes semblent incohérents ou trop vagues, c’est souvent que le contexte global du site n’est pas assez clair — notamment le texte décrivant l’activité de l’entreprise dans les réglages du plugin.
Un manque d’informations sur ce que fait l’organisation (secteur, produits, mission) limite la compréhension du modèle, et donc la pertinence des descriptions générées.

👉 Dans ce cas, il suffit d’ajuster les champs de configuration du plugin :

• le titre du site,
• la description courte de l’entreprise ou de la marque,
• et le texte d’activité (ou, si WooCommerce est activé, le texte “Informations sur la boutique”).

Ces précisions permettent à l’IA de mieux comprendre le domaine et d’améliorer sensiblement la qualité des prochaines générations.

• 🔁 Rafraîchir les blocs d’images : met à jour les contenus existants. Lorsqu’une image est insérée dans Gutenberg, le code HTML du bloc contient le texte alternatif au moment de l’insertion. Pour que les nouvelles balises alt soient bien reprises, il faut donc rafraîchir les pages, articles ou produits concernés.

💡 En pratique :

Si une image illustre un événement, le titre et la méta description donnent déjà des indices sur le sujet.
L’IA essaie alors de décrire la scène en lien avec ce contexte : une photo de salle de concert ou de scène sera décrite comme telle.
Si la photo montre un bâtiment, elle tentera d’en déduire le rapport avec la page (lieu, patrimoine, cadre), mais il peut y avoir des erreurs d’interprétation.

De même, l’IA ne reconnaît pas les personnes sur les photos : visages, artistes ou élus ne sont pas identifiés.

Il est donc recommandé de passer rapidement en revue les images après génération, surtout sur les contenus événementiels.
Chaque exécution affiche le nombre d’images traitées et le temps total de génération.