PS PrestaShop PrestaShop Débutant

Module Panier Sticky & Cross-sell IA — Installation et configuration

Installation, configuration et fonctionnement du module Panier Sticky & Cross-sell IA.

Mis à jour Version du module 1.0.0

Présentation

Le module Panier Sticky & Cross-sell IA (dfstickycart) ajoute à votre boutique PrestaShop un tiroir panier latéral qui s’ouvre en Ajax à chaque ajout, sans recharger la page. Il affiche le contenu du panier, une barre de progression « livraison gratuite » et un bloc de recommandations croisées calculées à partir de vos commandes réelles, avec une couche d’IA optionnelle.

Le moteur de recommandation est entièrement auto-hébergé : le module fonctionne sans aucune clé API. L’IA n’est qu’une couche de re-classement facultative.

Compatibilité

  • PrestaShop 8.0 à 9.x
  • Mono-boutique et multi-boutique
  • 5 langues : FR, EN, ES, DE, IT
  • Aucune dépendance (ni Composer ni framework)

Installation

  1. Dans le back-office, ouvrez Modules > Gestionnaire de modules.
  2. Cliquez sur Installer un module puis sélectionnez le fichier dfstickycart.zip.
  3. Une fois installé, cliquez sur Configurer.

Le module enregistre automatiquement ses hooks (actionFrontControllerSetMedia, displayHeader, displayFooter) et crée sa table de cache à l’installation. La désinstallation supprime cette table.

Configuration

Général

  • Activer le module : affiche ou masque le tiroir et le bouton flottant.
  • Position du tiroir : à droite ou à gauche de l’écran.
  • Ouverture automatique : ouvre le tiroir à chaque ajout au panier.
  • Bouton flottant : affiche un bouton panier permanent avec le compteur d’articles.
  • Couleur principale : couleur d’accent du tiroir, des boutons et de la barre.

Recommandations

  • Activer les recommandations : affiche le bloc cross-sell dans le tiroir.
  • Nombre de produits : nombre de suggestions affichées (3 par défaut).
  • Stratégie : Auto (moteur auto-hébergé seul) ou IA (re-classement par intelligence artificielle).
  • Message panier vide : texte affiché lorsque le panier ne contient encore aucun article.

Livraison gratuite

Renseignez le seuil de livraison gratuite dans la devise par défaut. La barre de progression affiche automatiquement le montant restant (« Plus que X € pour la livraison offerte ») et se convertit dans la devise active du client. Indiquez 0 pour masquer la barre.

Intelligence artificielle (optionnel)

  • Fournisseur : Mistral par défaut, ou tout service compatible OpenAI.
  • Endpoint : URL de l’API de complétion (par défaut l’endpoint de chat Mistral).
  • Modèle : nom du modèle (par exemple un modèle Mistral léger).
  • Clé API : votre clé. Elle n’est jamais réaffichée et reste conservée si vous laissez le champ vide lors d’une mise à jour.

Si la clé est absente ou si l’API ne répond pas, le module bascule silencieusement sur le moteur auto-hébergé. Le tiroir n’est jamais bloqué par une erreur d’IA.

Fonctionnement du moteur de recommandation

Les suggestions sont construites à partir d’un pool de produits issu de trois sources, par ordre de priorité :

  1. Co-achat (market-basket) : produits réellement commandés avec ceux du panier, à partir des commandes valides (poids le plus fort).
  2. Affinité de catégorie : produits des mêmes catégories que le panier.
  3. Meilleures ventes : repli lorsque l’historique est insuffisant.

Le résultat est mis en cache par composition de panier pendant une durée configurable, afin de limiter les calculs. Si la stratégie IA est active, la couche d’intelligence artificielle réordonne ce pool et génère une courte raison personnalisée pour chaque produit.

Performances

Le contenu du tiroir est chargé en Ajax uniquement à l’ouverture : aucune requête supplémentaire n’est exécutée tant que le client n’ouvre pas le panier. Les recommandations mises en cache évitent de recalculer le moteur à chaque affichage.

FAQ et dépannage

Le tiroir ne s’ouvre pas

Vérifiez que le module est activé, videz le cache PrestaShop (Paramètres avancés > Performances) et contrôlez que le thème charge bien jQuery côté front.

Aucune recommandation ne s’affiche

Sur une boutique récente sans historique de commandes, le moteur s’appuie sur l’affinité de catégorie puis sur les meilleures ventes. Assurez-vous d’avoir des produits actifs et visibles au catalogue.

Les suggestions IA ne changent pas

Les résultats sont mis en cache par composition de panier. Réduisez la durée du cache pendant vos tests, ou modifiez le panier pour générer une nouvelle clé de cache.

Cette page vous a-t-elle été utile ?

Toujours bloqué ? Contactez le support