AI Size & Fit Advisor — Guide complet
Installer, configurer et utiliser le conseiller de taille IA pour PrestaShop 8 et 9.
AI Size & Fit Advisor remplace votre guide des tailles statique par un véritable conseiller : le client saisit ses mensurations sur la fiche produit et reçoit la taille la plus adaptée, avec un indice de confiance, une alternative et le détail mensuration par mensuration. Ce guide couvre l’installation, la configuration, la création des guides de tailles et le fonctionnement du moteur de recommandation.
Installation
- Téléchargez l’archive
dfsizefit.zipdepuis votre compte DataFirefly. - Back-office PrestaShop → Modules → Téléverser un module → envoyez le ZIP.
- Le module crée ses tables, enregistre ses hooks et ajoute l’onglet Catalogue → Size & Fit Charts.
Compatible PrestaShop 8.0 à 9.x, en PHP 7.2.5+ (PS8) et 8.1+ (PS9). Aucun override, aucune dépendance externe.
Configuration générale
Rendez-vous dans Modules → AI Size & Fit Advisor → Configurer.
Couche IA
Le module fonctionne sans IA grâce à son moteur déterministe. Vous pouvez activer une couche IA optionnelle pour affiner la décision selon la morphologie et générer une explication dans la langue du client.
- Activer la couche IA : si désactivée, aucun appel externe n’est effectué.
- Fournisseur : Mistral, OpenAI ou Anthropic.
- Clé API : stockée côté serveur, jamais exposée au front-office.
- Modèle : par exemple
mistral-small-latest,gpt-4o-miniouclaude-haiku-4-5.
En cas d’échec ou de dépassement du délai de l’API, le module repasse automatiquement sur le moteur déterministe. La recommandation reste donc toujours disponible.
Préférence de coupe
Activez cette option pour proposer au client les choix Ajustée / Classique / Ample. Le module applique un biais de ±3 % sur les mensurations afin d’orienter la taille vers le haut ou le bas selon la coupe souhaitée.
Fit-learning
Lorsqu’il est activé, le module journalise de façon anonymisée les profils et les recommandations dans la table dédiée, afin d’analyser la pertinence et de repérer les références qui taillent petit ou grand.
Unité et hook d’affichage
- Unité par défaut : centimètres ou pouces.
- Hook d’affichage :
displayProductActions(près du bouton d’ajout au panier) oudisplayProductAdditionalInfo(sous les informations produit). - Libellé du bouton : laissez vide pour utiliser la traduction par défaut « Trouver ma taille ».
Créer un guide des tailles
Ouvrez Catalogue → Size & Fit Charts → Ajouter.
Portée
Chaque guide possède une portée qui détermine les produits concernés :
- Global : s’applique à tous les produits (référence laissée à 0).
- Catégorie : renseignez l’ID de la catégorie.
- Produit : renseignez l’ID du produit.
La résolution se fait en cascade : le module cherche d’abord un guide au niveau du produit, puis de ses catégories, puis le guide global. Le premier trouvé est utilisé.
L’éditeur de grille
L’éditeur visuel fonctionne comme un tableau : une ligne par taille, une colonne par mensuration.
- Ajoutez une colonne de mensuration (poitrine, taille, hanches, entrejambe, longueur de pied, etc.) via le sélecteur, puis le bouton « Ajouter une colonne ».
- Ajoutez une ligne de taille avec « Ajouter une taille » et nommez-la (S, M, L, 38, 40…).
- Pour chaque cellule, indiquez une plage minimum / maximum dans l’unité configurée.
- Choisissez le genre (femme, homme, unisexe, enfant) et activez le guide.
Renseignez des plages cohérentes et sans trou entre les tailles. Plus les mensurations couvertes sont nombreuses, plus la recommandation est fiable.
Comment fonctionne la recommandation
La recommandation se déroule en plusieurs étapes :
- Matching déterministe : le moteur score chaque taille en comparant les mensurations du client aux plages de la grille (distance au centre de chaque plage, pénalité si hors plage), puis applique le biais de coupe.
- Affinage IA (optionnel) : si la couche IA est active, le fournisseur confirme ou ajuste la taille en tenant compte de la morphologie (taille, poids) et rédige une explication courte.
- Repli : si l’IA échoue, le résultat déterministe est conservé.
Le client reçoit la taille recommandée, un indice de confiance, une taille alternative et le détail par mensuration (dans la fourchette, serré ou large).
Affichage côté client
Sur la fiche produit, un bouton « Trouver ma taille » ouvre une modale. Le client saisit ses mensurations, éventuellement sa taille, son poids et sa préférence de coupe, puis valide. Le résultat s’affiche dans la même fenêtre, avec une barre de confiance et la décomposition par mensuration.
Fit-learning et analyse des retours
Chaque recommandation peut être journalisée avec son profil anonymisé, le moteur utilisé et l’indice de confiance. Le statut de retour (gardé, retourné trop petit, retourné trop grand) permet, à terme, d’identifier les coupes problématiques et d’ajuster vos grilles.
Compatibilité et notes techniques
- PrestaShop 8.x et 9.x, multiboutique et multilingue.
- Contrôleur d’administration legacy (pas de contrôleur Symfony) pour la compatibilité PS8/PS9.
- Endpoint AJAX front via le lien de module ; rendu JSON par une méthode dédiée.
- Données client stockées sur votre boutique ; seule la partie nécessaire au calcul est transmise au fournisseur IA choisi.
FAQ et dépannage
Le bouton n’apparaît pas sur la fiche produit. Vérifiez qu’un guide actif s’applique au produit (portée produit, catégorie ou global) et que le hook d’affichage choisi est bien greffé sur votre thème.
La recommandation indique un manque de données. Le client n’a pas renseigné de mensuration correspondant aux colonnes de la grille. Ajoutez des colonnes communes (poitrine, taille, hanches) ou invitez le client à compléter davantage de champs.
L’IA ne renvoie rien. Vérifiez la clé API et le nom du modèle. Le module bascule de toute façon sur le moteur déterministe ; aucune recommandation n’est perdue.