# DataFirefly Ventes croisées panier : suggestions de produits dans le panier PrestaShop
> Présentation DataFirefly Ventes croisées panier affiche des suggestions de produits dans la page panier, dans la fenêtre d'ajout au panier et dans le panier vide. Le client ajoute une suggestion…
- Page:
- Langue: fr
- Mis à jour le: 2026-11-02
- Autres langues: [en](https://www.datafirefly.com/en/documentation/dfcartcrosssell/index.md), [es](https://www.datafirefly.com/es/documentation/dfcartcrosssell/index.md), [de](https://www.datafirefly.com/de/documentation/dfcartcrosssell/index.md), [it](https://www.datafirefly.com/it/documentation/dfcartcrosssell/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfcartcrosssell/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfcartcrosssell/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfcartcrosssell/index.md)
- Index:
## Présentation
DataFirefly Ventes croisées panier affiche des suggestions de produits dans la **page panier**, dans la **fenêtre d'ajout au panier** et dans le **panier vide**. Le client ajoute une suggestion en un clic, choisit la déclinaison dans la carte, et le panier se met à jour sans recharger la page.
Les suggestions viennent d'abord de vos **règles**, puis de **sources automatiques** : produits associés, souvent achetés ensemble, même catégorie, même marque, mêmes caractéristiques, meilleures ventes, nouveautés et prix similaire. Une règle peut baisser le prix de ses produits tant que le panier contient un produit qui la déclenche.
Le module fonctionne de PrestaShop 1.7.8 à 9.x avec PHP 7.1 à 8.5, avec les thèmes Classic et Hummingbird. Il est traduit en anglais, français, espagnol, allemand, italien, polonais, néerlandais et portugais.
## Installation et mise à jour
1. Dans **Modules > Gestionnaire de modules**, cliquez sur **Installer un module** et déposez le fichier `dfcartcrosssell-2.0.0.zip`.
2. Cliquez sur **Configurer** pour ouvrir la page du module et ses quatre onglets : Tableau de bord, Règles, Réglages et Outils.
L'installation construit l'index « souvent achetés ensemble » à partir de vos commandes existantes : cette source fonctionne dès la première visite.
Mise à jour depuis la version 1.0 : envoyez le zip 2.0.0 par-dessus l'ancien module. Vos réglages et statistiques sont conservés, les bundles de la 1.0 deviennent des règles et le cache des fichiers JS/CSS combinés est vidé. La remise « bundle » de la 1.0 n'était jamais appliquée aux paniers : les remises passent désormais par les offres des règles.
## Où s'affichent les suggestions
### Page panier
Par défaut, le bloc s'affiche sous les produits du panier, en carrousel, en grille ou en liste compacte. Au-dessus, le bloc **souvent achetés ensemble** liste les produits souvent commandés avec le panier, avec des cases à cocher, le choix de la déclinaison, le total réel des produits cochés et un bouton pour tout ajouter.
Page panier avec le bloc souvent achetés ensemble et le carrousel de suggestions avec prix d'offre
Vous pouvez aussi placer le bloc dans la colonne du récapitulatif : il devient alors une liste compacte de 4 produits au plus.
### Fenêtre d'ajout au panier
Quand un client ajoute un produit depuis n'importe quelle page, la fenêtre de confirmation affiche des suggestions pour ce produit. L'ajout d'une suggestion garde la fenêtre ouverte, met à jour le compteur du panier et annonce le nouveau total aux lecteurs d'écran.
Fenêtre de confirmation d'ajout au panier avec des suggestions pour le produit ajouté
### Panier vide
Un panier vide affiche vos meilleures ventes : la page n'est jamais une impasse.
Page panier vide affichant les meilleures ventes de la boutique
### Mobile
Sur mobile, le carrousel se fait défiler au doigt et la carte suivante dépasse pour inviter à faire défiler. Les flèches, la navigation au clavier et le défilement automatique facultatif sont disponibles sur ordinateur ; le défilement automatique s'arrête au survol, au focus et si le visiteur préfère réduire les animations.
Carrousel de suggestions sur mobile
Compatibilité
## Ajout au panier en un clic
Chaque carte affiche le prix, le prix normal quand il est réduit, le badge de réduction ou d'offre, la marque et, si le module Commentaires produits est actif, la note moyenne réelle des avis validés. Les produits à déclinaisons ont une liste déroulante dans la carte : le prix suit la déclinaison choisie et les déclinaisons indisponibles sont grisées.
Le bouton d'ajout envoie une requête vérifiée par le serveur : le produit doit être actif, visible, disponible à la commande, en stock (sauf commande hors stock autorisée), sans personnalisation obligatoire et accessible au groupe du client. Le module déclenche ensuite le rafraîchissement du panier du thème : totaux, aperçu du panier et bloc lui-même sont mis à jour sans recharger la page, avec un squelette pendant le recalcul des suggestions.
Ajout au panier en un clic avec choix de la déclinaison
## Règles
Les règles choisissent les produits à suggérer pour certains paniers. Elles passent avant les suggestions automatiques, de la priorité la plus haute à la plus basse. La liste affiche les déclencheurs, les produits suggérés, l'offre, la priorité, le statut (active, inactive, programmée, expirée) ainsi que les ajouts et le CA des 30 derniers jours.
Liste des règles de ventes croisées avec déclencheurs, produits suggérés, offres, priorité et statut
### Créer une règle
1. **Quand le panier contient** : des produits, des catégories (sous-catégories comprises) ou des valeurs de caractéristique. Laissez tout vide pour appliquer la règle à tous les paniers. Un montant minimum de panier peut s'ajouter.
2. **Suggérer** : des produits dans l'ordre choisi, des catégories ou des valeurs de caractéristique (ce sont les produits les plus vendus).
3. **Offre** (facultative) : un pourcentage ou un montant TTC sur les produits suggérés listés dans la règle.
4. **Options** : priorité de 0 à 100, affichage des seuls produits de la règle, dates de début et de fin, groupes de clients et titre du bloc propre à la règle dans chaque langue.
L'aperçu à droite montre les cartes exactement comme le client les verra, avec les prix d'offre.
Éditeur de règle
### Règles par caractéristiques
Une règle peut se déclencher sur des valeurs de caractéristique (par exemple _Collection : Citations inspirantes_) et suggérer des produits ayant d'autres valeurs (par exemple _Composition : Céramique_). Recherchez une valeur avec _Caractéristique : valeur_ ; le nombre de produits de chaque valeur est affiché.
Règle de ventes croisées par caractéristiques
### Offres
Une offre baisse le prix d'un produit suggéré tant que le panier contient aussi **un autre** produit qui déclenche la règle. Elle est calculée par le serveur et appliquée par un prix spécifique limité à ce panier : rien de ce que le navigateur envoie ne peut la modifier. Elle est vérifiée à chaque modification du panier et retirée dès que le panier ne remplit plus la condition. Les promotions du catalogue sont conservées : l'offre s'applique au prix déjà remisé.
Suggestions d'une règle avec son propre titre et une offre en montant pour un panier de thé
Une offre s'applique à toutes les unités du produit dans le panier. Désactivez **Offres des règles** dans les réglages pour arrêter toutes les offres d'un coup.
## Suggestions automatiques et caractéristiques
Chaque source automatique a un poids de 0 (désactivée) à 10. Les produits trouvés par plusieurs sources obtiennent un meilleur score. La source **Mêmes caractéristiques** suggère les produits qui partagent le plus de valeurs de caractéristique avec le panier ; vous pouvez la limiter à certaines caractéristiques.
Poids des sources automatiques
DataFirefly Tags en caractéristiques transforme les tags produits en caractéristiques natives. Les ventes croisées lisent ces caractéristiques en direct, sans réglage : dès que les tags sont convertis, la source « mêmes caractéristiques » et les règles par caractéristiques les utilisent.
Les produits inactifs, invisibles ou indisponibles, ceux qui exigent une personnalisation et ceux des catégories masquées au groupe du client ne sont jamais suggérés. Dans **Filtres et exclusions**, vous pouvez aussi masquer les produits en rupture, ceux déjà dans le panier, et des produits ou catégories précis.
## Affichage et apparence
L'onglet Réglages regroupe la position dans le panier, la disposition, le nombre de produits, les titres dans chaque langue, la fenêtre d'ajout, le panier vide, le bloc achetés ensemble, le contenu des cartes, quatre styles de carte, la couleur d'accent (ou les couleurs du thème), l'arrondi et l'ombre. En multiboutique, les réglages sont enregistrés par boutique.
Réglages d'affichage
## Tableau de bord
Le tableau de bord n'affiche que les données enregistrées par le module sur votre boutique : vues du bloc, clics produits, ajouts au panier, taux d'ajout, commandes contenant un produit suggéré et **CA additionnel**, c'est-à-dire le total HT des lignes de commande des produits ajoutés depuis le bloc, dans les commandes valides. Il compare aussi le panier moyen avec et sans produit suggéré, et chaque chiffre avec la période précédente.
Tableau de bord des ventes croisées
Les tableaux détaillent vues, ajouts, taux et CA par source et par emplacement (page panier, fenêtre, panier vide, bloc achetés ensemble), et listent les produits les plus performants.
Performance des suggestions par source et par emplacement
## Outils
Le **simulateur de panier** affiche les suggestions pour n'importe quelle liste de produits, avec la source, la règle et le score de chacune : le moyen le plus rapide de vérifier une règle ou les poids.
Simulateur de panier
- **Index « souvent achetés ensemble »** : mis à jour à chaque commande ; reconstruisez-le après un import de commandes ou un changement de durée d'historique.
- **Tâche planifiée** (facultative) : appelez l'URL une fois par jour pour reconstruire l'index et nettoyer les anciennes données. Sans elle, le nettoyage s'exécute de lui-même au plus une fois par jour.
- **Maintenance** : nombre de paniers avec une offre active et suppression des statistiques.
## Sécurité et données personnelles
- L'ajout au panier exige une requête POST avec le jeton de la boutique ; les prix et quantités envoyés par le navigateur sont ignorés.
- Les vues et clics sont signés par le serveur : les statistiques falsifiées sont refusées.
- Les statistiques ne contiennent aucune donnée personnelle : des compteurs journaliers par produit, et l'identifiant du panier seulement pour relier un ajout à sa commande.
- La désinstallation supprime les tables, les réglages et les offres de panier du module.
## Dépannage
### Le bloc ne s'affiche pas
Vérifiez que **Afficher les suggestions** est activé, que la position dans le panier n'est pas _Pas sur la page panier_ et que des produits peuvent être suggérés : le simulateur de panier indique pourquoi une liste est vide.
### L'ancien script est encore chargé après la mise à jour
La mise à jour vide le cache des fichiers combinés. Si un cache serveur ou un CDN garde une ancienne copie, videz-le aussi.
### Une offre ne s'applique pas
Le panier doit contenir un autre produit qui déclenche la règle, la règle doit être active et dans ses dates, et l'offre doit donner un prix inférieur au prix actuel.