Essayage virtuel IA pour WooCommerce — Documentation

Ce que fait le plugin

DF Google Try-On ajoute un bouton d’essayage virtuel sur vos fiches produit WooCommerce. La cliente charge une photo ou utilise sa webcam, et l’intelligence artificielle génère une image d’elle portant le vêtement. L’aperçu s’affiche dans une modale, sans jamais quitter la fiche produit.

Prérequis

• WordPress 6.2 ou supérieur, WooCommerce 7.0 ou supérieur
• PHP 7.4 ou supérieur, avec l’extension OpenSSL activée
• Un projet Google Cloud avec la facturation active
• L’API Vertex AI activée sur ce projet
• Un compte de service disposant du rôle Vertex AI User

Étape 1 — Préparer Google Cloud

Activer l’API Vertex AI

Dans la console Google Cloud, sélectionnez votre projet, puis rendez-vous dans la bibliothèque d’API et activez Vertex AI API. Vérifiez que la facturation est bien active sur le projet : sans elle, tous les appels échoueront.

Créer le compte de service

1. Ouvrez la section IAM et administration, puis Comptes de service.
2. Créez un compte de service (le nom importe peu, par exemple woocommerce-tryon).
3. Attribuez-lui le rôle Vertex AI User. N’accordez pas de rôle plus large que nécessaire.
4. Dans l’onglet Clés, créez une clé de type JSON et téléchargez le fichier.

Choisir une région

Le modèle doit être disponible dans la région que vous indiquez. La valeur par défaut us-central1 est la plus sûre. Si vous souhaitez une région européenne, vérifiez au préalable la disponibilité du modèle Virtual Try-On dans la documentation Google, car la couverture régionale évolue.

Étape 2 — Installer le plugin

1. Dans WordPress, allez dans Extensions, Ajouter, Téléverser une extension.
2. Sélectionnez le fichier ZIP fourni, puis installez et activez.
3. Un nouveau menu apparaît : WooCommerce, Google Try-On.

Étape 3 — Configurer

Tous les réglages se trouvent dans WooCommerce, Google Try-On.

Connexion à Google

• Identifiant du projet GCP : l’identifiant du projet, pas son nom d’affichage.
• Région : par exemple us-central1.
• JSON du compte de service : collez le contenu intégral du fichier téléchargé. Le plugin valide le JSON à l’enregistrement et refuse une clé mal formée.

À l’enregistrement, le cache du jeton d’accès est vidé automatiquement : une modification de clé est donc prise en compte immédiatement.

Affichage

• Activer l’essayage : interrupteur général. Tant qu’il est décoché, rien ne s’affiche côté boutique.
• Libellé du bouton : le texte affiché sur la fiche produit.
• Catégories éligibles : limite le widget à certaines catégories. Laissez vide pour autoriser tous les produits.

Sécurité et coûts

• Filtre de sécurité : niveau de filtrage appliqué par Google aux images. Le réglage le plus strict est recommandé sur une boutique publique.
• Filigrane : ajoute le filigrane SynthID de Google aux images générées. Recommandé, pour signaler qu’il s’agit d’une image de synthèse.
• Plafond mensuel : nombre maximal d’essayages réussis par mois civil. Mettez 0 pour ne pas plafonner, mais gardez en tête que chaque génération est facturée.
• Texte de consentement : le message affiché à côté de la case à cocher obligatoire.

Le compteur du mois en cours est affiché en haut de la page de réglages.

Étape 4 — Contrôler l’affichage produit par produit

Dans la fiche d’un produit, onglet Général des données produit, un réglage Essayage virtuel propose trois valeurs :

• Auto : suit les catégories configurées globalement.
• Toujours afficher : force l’affichage, même hors des catégories éligibles.
• Ne jamais afficher : masque le widget, quelle que soit la configuration globale.

Comment ça fonctionne côté technique

Le parcours d’un essayage est le suivant :

1. La cliente ouvre la modale et fournit une photo, par import ou capture webcam. L’image est redimensionnée dans le navigateur, sur son plus grand côté, avant tout envoi.
2. Elle coche la case de consentement, obligatoire : sans elle, la requête est refusée par le serveur.
3. Le serveur vérifie le jeton de sécurité, le produit, la limitation par adresse IP et le plafond mensuel.
4. Le plugin signe un jeton JWT en RS256 avec la clé privée du compte de service, l’échange contre un jeton d’accès OAuth2, puis le met en cache jusqu’à sa quasi-expiration.
5. La photo et l’image produit sont envoyées au modèle Vertex AI, qui renvoie l’image générée.
6. L’image est retournée au navigateur et affichée dans la modale.

L’image du vêtement n’est jamais fournie par le navigateur : elle est toujours lue côté serveur depuis la fiche produit. Cela empêche un visiteur de détourner le service pour essayer une image arbitraire.

Données personnelles et RGPD

La photo de la cliente est une donnée personnelle. Le plugin est conçu en conséquence :

• La photo n’est jamais enregistrée sur votre serveur, ni dans la médiathèque, ni en base de données. Elle transite en mémoire le temps de l’appel.
• L’image générée est renvoyée directement au navigateur et n’est pas stockée non plus.
• Une case de consentement explicite, dont vous rédigez le texte, doit être cochée avant tout traitement.
• La photo est transmise à Google, qui agit comme sous-traitant. Mentionnez ce transfert dans votre politique de confidentialité, en indiquant la finalité et le destinataire.

Maîtriser les coûts

Chaque essayage réussi correspond à une génération d’image facturée par Google. Trois garde-fous sont intégrés :

• Le plafond mensuel, qui bloque les nouvelles générations une fois atteint.
• Une limitation par adresse IP, qui empêche les appels en rafale.
• L’usage exclusif de l’image produit côté serveur, qui interdit tout usage détourné du service.

Le compteur est réinitialisé automatiquement à chaque nouveau mois civil. Surveillez en parallèle le budget dans la console Google Cloud, où vous pouvez définir des alertes de facturation.

Résolution des problèmes

Le bouton n’apparaît pas

Vérifiez dans l’ordre : l’interrupteur général est activé, l’identifiant de projet et le JSON sont renseignés, le produit appartient à une catégorie éligible ou est forcé sur Toujours afficher, et le produit possède bien une image principale.

Message d’erreur d’authentification

La clé JSON est invalide, incomplète, ou le compte de service n’a pas le rôle Vertex AI User. Recollez le fichier complet et vérifiez le rôle dans la console Google Cloud. Vérifiez aussi que l’extension OpenSSL est disponible sur votre hébergement.

Aucune image générée

Le modèle peut refuser une photo trop sombre, floue, recadrée sur le visage, ou comportant plusieurs personnes. Demandez une photo nette, bien éclairée, de préférence en pied et de face. Un filtre de sécurité très strict peut aussi bloquer certaines images.

Erreur de région ou de modèle introuvable

Le modèle n’est pas disponible dans la région saisie. Revenez à us-central1 et vérifiez la disponibilité régionale du modèle dans la documentation Google.

Le service indique être à pleine capacité

Le plafond mensuel est atteint. Augmentez-le dans les réglages, ou attendez le mois suivant. Le compteur du mois en cours est visible en haut de la page de réglages.

Questions fréquentes

Faut-il installer Composer ?

Non. Le plugin utilise un autoloader natif et signe l’authentification Google en PHP pur, via OpenSSL.

Le plugin est-il compatible HPOS ?

Oui, la compatibilité avec le stockage haute performance des commandes est déclarée.

Fonctionne-t-il sur mobile ?

Oui. La capture utilise la caméra frontale lorsque le navigateur l’autorise, et l’import de photo reste toujours disponible.

Peut-on essayer autre chose que des vêtements ?

Le modèle est entraîné pour les vêtements portés. Les résultats sur des accessoires, des chaussures ou des objets sont beaucoup moins fiables. Restreignez le widget à vos catégories de vêtements.

Que se passe-t-il si je désinstalle le plugin ?

La désinstallation supprime les réglages, le jeton en cache et les compteurs mensuels. Le réglage par produit est conservé, afin de ne rien perdre en cas de réinstallation.