dfbundlevisual — Souvent achetés ensemble

Présentation

dfbundlevisual affiche sur la fiche produit un bloc « Souvent achetés ensemble » façon Amazon : des cartes produits cochables séparées par des « + », un prix total recalculé en direct et un bouton unique pour ajouter la sélection au panier. Une remise de lot (pourcentage ou montant fixe TTC) est appliquée automatiquement lorsque le lot complet est au panier. Sans lot manuel, le module peut suggérer les produits réellement achetés ensemble d’après votre historique de commandes.

Installation

1. Dans le back-office, ouvrez Modules > Gestionnaire de modules > Installer un module.
2. Téléversez le fichier dfbundlevisual.zip puis cliquez sur Installer.
3. Le module crée ses tables, son onglet Catalogue > Lots visuels et s’enregistre sur les hooks nécessaires.

Configuration

Ouvrez la page de configuration du module (Modules > Gestionnaire de modules > dfbundlevisual > Configurer) :

• Activer le module : interrupteur général du bloc front.
• Point d’accroche d’affichage : displayFooterProduct (pied de fiche produit, recommandé) ou displayProductAdditionalInfo (sous le bouton d’achat, selon le thème).
• Titre du bloc : personnalisable par langue. Par défaut « Souvent achetés ensemble » en français.
• Activer les suggestions automatiques : affiche des suggestions par co-achat lorsqu’aucun lot manuel n’existe pour le produit consulté.
• Nombre max de suggestions automatiques : nombre de produits complémentaires proposés (2 par défaut).
• Co-achats minimum : nombre minimal de commandes contenant les deux produits pour qu’une suggestion apparaisse (2 par défaut).
• Fenêtre d’historique de commandes (jours) : période analysée pour la co-occurrence (365 par défaut).

Créer un lot

1. Ouvrez Catalogue > Lots visuels puis cliquez sur Ajouter.
2. Nom du lot : nom interne, également utilisé comme libellé de la remise dans le panier.
3. Produit principal : recherchez par nom, référence ou ID. C’est sur la fiche de ce produit que le bloc s’affichera.
4. Produits du lot : ajoutez un ou plusieurs produits complémentaires via la recherche avec autocomplétion.
5. Type et valeur de remise : aucune remise, pourcentage (max 100) ou montant fixe TTC.
6. Activez le lot puis enregistrez.

Fonctionnement de la remise

La remise est appliquée par une règle panier dynamique créée à la volée pour chaque panier (code DFBV-{id_lot}-{id_panier}) et restreinte aux seuls produits du lot :

• Elle n’est créée que si le lot complet est présent au panier — vérification effectuée côté serveur.
• Une remise en pourcentage s’applique uniquement aux produits du lot, jamais au reste du panier.
• Si le client retire un produit du lot, la remise est supprimée automatiquement.
• À la validation de la commande, la règle est désactivée pour ne pas être réutilisée.
• À la désinstallation du module, toutes les règles générées sont purgées.

Suggestions automatiques

Lorsqu’aucun lot manuel actif n’existe pour le produit consulté et que l’option est activée, le module analyse la co-occurrence des produits dans vos commandes valides sur la fenêtre configurée, puis affiche les combinaisons les plus fréquentes qui respectent le seuil de co-achats. Les produits hors stock sont exclus. Le résultat est mis en cache pour préserver les performances. Aucune remise n’est appliquée sur les suggestions automatiques : la remise est réservée aux lots manuels.

Statistiques

La liste Catalogue > Lots visuels affiche pour chaque lot ses vues (affichages du bloc) et ses conversions (ajouts complets au panier). Les suggestions automatiques sont comptabilisées globalement. Utilisez ces chiffres pour ajuster compositions et remises.

Dépannage

• Le bloc ne s’affiche pas : vérifiez que le module est activé, qu’un lot actif existe pour le produit (ou que les suggestions automatiques sont activées avec un historique suffisant), et que le hook choisi est bien présent dans votre thème.
• La remise n’apparaît pas : elle n’est créée que si tous les produits du lot sont au panier. Vérifiez aussi que le type de remise n’est pas « Aucune remise ».
• Aucune suggestion automatique : abaissez le seuil de co-achats minimum ou élargissez la fenêtre d’historique ; il faut des commandes valides contenant les produits ensemble.
• Produits à déclinaisons : la déclinaison par défaut est utilisée à l’ajout, avec contrôle du stock.