Box Builder (Mix & Match) : guide complet
Installer, configurer et exploiter Box Builder sur PrestaShop 8 et 9 : coffrets à l'article ou au poids, emplacements en étapes, 5 modèles de prix dont le prix au poids, options cadeau, disponibilité, affichage dans le catalogue, modification depuis le panier, stock et statistiques.
Présentation
Box Builder (Mix & Match) (dfboxbuilder) ajoute une page où vos clients composent leur propre coffret à partir des produits que vous sélectionnez. Ils choisissent les articles dans une grille, suivent une barre de progression, voient le prix du coffret et l’économie réalisée se mettre à jour, puis ajoutent le coffret au panier. Le coffret se remplit au nombre d’articles ou au poids. Chaque coffret est une ligne du panier avec son propre prix ; sa composition reste lisible dans le panier, sur la commande et sur la facture.
Vous créez autant de coffrets que nécessaire, chacun avec ses produits, ses règles, son modèle de prix et sa période de vente. Un même catalogue peut alimenter des coffrets très différents (box apéro, coffret de Noël, ballotin de chocolats au poids, pack découverte…).
Compatibilité
- PrestaShop 8.x et 9.x
- PHP 7.4 à 8.x
- Boutique simple et multiboutique
- Interface en 5 langues : FR, EN, ES, DE, IT
- Thème Classic, Hummingbird et thèmes personnalisés (configurateur en JavaScript natif, sans jQuery)
- Aucune dépendance (ni Composer ni framework)
Installation et mise à jour
- Dans le back-office, ouvrez Modules > Gestionnaire de modules.
- Cliquez sur Installer un module et sélectionnez
dfboxbuilder.zip. - Ouvrez l’onglet Box Builder ajouté au menu pour créer votre premier coffret.
Pour mettre à jour, téléversez le nouveau ZIP de la même façon : les scripts de mise à jour s’exécutent automatiquement (nouvelles colonnes, nouveaux hooks, URL propres générées à partir des noms de coffrets). Les coffrets existants restent au remplissage par nombre d’articles.
À la première sauvegarde d’un coffret, le module crée un produit technique qui porte le coffret dans le panier. Il est caché par défaut ; vous pouvez l’afficher dans vos catégories (voir Affichage dans le catalogue). Sa fiche produit redirige toujours vers le configurateur. Supprimer un coffret supprime aussi ce produit.
Réglages du module
Le panneau Réglages, au-dessus de la liste des coffrets, contient trois options :
- Afficher les coffrets sur la page d’accueil : bloc « Composez votre coffret » sur le hook
displayHome. - Couleur d’accent : couleur de la barre de progression, des onglets d’étape et des éléments mis en avant. Indiquez la couleur principale de votre thème (par exemple
#8a5a2b) ; laissez vide pour le bleu par défaut. La couleur du texte posé dessus est choisie automatiquement pour rester lisible. - Après l’ajout d’un coffret au panier : aller à la page panier (par défaut) ou rester sur le configurateur. En restant, le bloc panier du thème est mis à jour et ouvre sa fenêtre de confirmation, puis le client peut composer un autre coffret.
Dans la liste des coffrets, le menu de chaque ligne propose Ouvrir la page du configurateur et Dupliquer. La copie reprend les prix, tarifs dégressifs, emplacements, sources, modèles, contraintes et groupes ; elle est créée inactive. Pour un coffret au poids, les colonnes Min et Max affichent les poids.
Créer un coffret
Le formulaire d’un coffret est organisé en six onglets.
Général
- Nom, description, libellé du bouton : par langue.
- URL simplifiée : par langue, générée à partir du nom si vous la laissez vide. Avec les URL simplifiées de PrestaShop activées, la page du coffret a pour adresse
/box/ID-url-simplifiee. - Remplir le coffret par : Nombre d’articles (par défaut) ou Poids (voir Coffret au poids).
- Articles min / max (remplissage au nombre d’articles) : bornes de la composition (0 = pas de maximum).
- Poids minimum / maximum (remplissage au poids) : dans l’unité de poids de la boutique ; 0 = pas de maximum, la même valeur pour un poids exact.
- Autoriser le même article plusieurs fois et unités max par article.
- Masquer les produits en rupture : sinon ils restent visibles mais ne peuvent pas être ajoutés.
- Activer « Surprenez-moi », Activer l’enregistrement et le partage, Actif.
Disponibilité
- Disponible à partir du / jusqu’au : période de vente. Avant la date de début, la page du coffret affiche « Ce coffret sera disponible à partir du … » ; après la date de fin, le coffret est retiré des paniers qui le contiennent encore.
- Stock limité (coffrets) : nombre maximum de coffrets vendus, toutes boutiques confondues, commandes annulées exclues (0 = illimité). Le formulaire affiche le nombre vendu et restant ; la page du coffret affiche « Édition limitée : plus que N ».
- Afficher dans le catalogue : nulle part (par défaut), catégories et recherche, catégories uniquement ou recherche uniquement, avec la liste des catégories où placer le coffret.
- Groupes de clients : aucun groupe coché = tout le monde. Sinon, seuls les groupes cochés voient et commandent le coffret.
- Proposer le coffret sur les fiches produit : ajoute « Composez un coffret avec ce produit » sur la fiche de chaque produit que le coffret contient.
Tarification
Tous les prix se saisissent hors taxe, dans la devise par défaut. Le coffret a sa propre règle de taxe, appliquée dans le panier selon l’adresse du client.
- Prix fixe : un prix unique, quel que soit le contenu.
- Paliers de volume : le prix dépend du nombre d’articles (ex. à partir de 3 articles : 25 €, à partir de 6 : 45 €). Le client voit « Encore 2 article(s) et votre coffret passe à … ».
- Somme des produits avec remise : somme des prix des articles moins un pourcentage. Les prix des articles sont alors affichés dans la grille.
- Prix par emplacement : chaque emplacement a un prix par article (nécessite les emplacements).
- Prix au poids : poids total des articles multiplié par un prix par unité de poids (par kg si la boutique est en kg). Des tarifs dégressifs optionnels changent ce prix à partir d’un poids de coffret, et tout le coffret passe alors au nouveau tarif : avec 30 € le kg puis 26 € dès 1 kg, un coffret de 1,05 kg coûte 27,30 €. Le client voit le prix au kilo en cours et « Encore 100 g et le prix passe à 26,00 € / kg ». Ce modèle fonctionne aussi avec un remplissage au nombre d’articles.
Afficher l’économie compare le prix du coffret au prix des articles achetés séparément, aux prix actuels de votre catalogue : « Au lieu de 34,00 € : vous économisez 5,20 € (-15 %) ».
Récompenses à la complétion : produit offert et/ou livraison offerte, accordés par une règle panier à code secret, à usage unique, valable uniquement tant que le coffret est dans le panier. Le libellé de la récompense est affiché dans le configurateur.
Options cadeau :
- Message cadeau avec une longueur maximale (1 à 500 caractères). Le message apparaît sur la commande en back-office et sur la facture.
- Emballage cadeau avec son prix hors taxe (0 = gratuit), ajouté au prix du coffret.
Composition
Les produits éligibles viennent de produits ajoutés un par un (recherche par nom, référence ou ID) ou de catégories entières. Chaque déclinaison d’un produit devient un article sélectionnable, avec son stock, son prix et son poids.
Utiliser des emplacements structure le coffret, par exemple « 2 salés + 1 sucré ». Chaque emplacement a un nom par langue, un minimum, un maximum, un prix par article (modèle par emplacement) et ses propres sources. Côté client, les emplacements deviennent des étapes numérotées.
Modèles
Coffrets pré-composés que le client applique d’un clic puis ajuste. Les produits d’un modèle doivent aussi être éligibles dans le coffret.
Contraintes
Paires de produits qui ne peuvent pas figurer dans le même coffret. Le configurateur empêche la combinaison et le serveur la refuse.
Coffret au poids
Pour un ballotin de chocolats, un assortiment de thés ou une box de vrac, le client remplit le coffret jusqu’à un poids au lieu de compter les articles.
- Onglet Général : Remplir le coffret par = Poids, puis un poids minimum et/ou maximum. Exemple : 1 et 1,2 pour un ballotin de 1 à 1,2 kg ; 1 et 1 pour exactement 1 kg. Au moins l’un des deux est obligatoire.
- Onglet Tarification : tous les modèles de prix fonctionnent. Prix au poids facture le coffret au kilo, avec des tarifs dégressifs si besoin ; un prix fixe convient à un ballotin vendu 35 € quel que soit l’assortiment.
- Vérifiez le poids des produits : fiche produit, onglet Livraison, et impact sur le poids de chaque déclinaison.
- Poids d’un article : poids du produit + impact de la déclinaison, la même valeur que PrestaShop utilise pour la livraison.
- Produits sans poids : ils ne sont pas proposés dans un coffret au poids, ni dans un coffret au prix au poids, et le bloc des fiches produit ne propose pas le coffret sur leur page. Le formulaire du coffret affiche le nombre de produits éligibles concernés.
- Configurateur : poids sur chaque carte, dans le récapitulatif et dans l’aperçu rapide ; compteur et barre de progression en g / kg (« 800 g / 1,2 kg », minimum marqué) ; un article qui ferait dépasser le maximum est grisé avec « Dépasse le poids restant » ; tant que le minimum n’est pas atteint, le client voit « Encore 200 g pour compléter votre coffret ».
- Règles d’articles : en mode poids, les articles min / max du coffret ne s’appliquent pas ; les emplacements, les doublons, les unités max par article et les incompatibilités restent actifs.
- Surprenez-moi remplit le coffret dans la fourchette de poids.
- Panier, commande et facture : le poids total s’affiche avec la composition.
- Affichage des poids : en grammes sous 1 kg, en kilos au-delà, avec le séparateur décimal de la langue du visiteur.
Côté client
Le configurateur
- Étapes : avec des emplacements, des onglets numérotés indiquent l’avancement (« Salé 2/3 »). Quand une étape est pleine, le configurateur passe à la suivante ; un bouton « Étape suivante » apparaît dès qu’une étape est complète.
- Grille : au-delà de 8 produits, une barre de recherche (accents ignorés), un filtre par catégorie et un tri par nom ou par prix apparaissent. Un clic sur l’image ou le nom ouvre l’aperçu rapide (image, description, lien vers la fiche, bouton Ajouter). Les articles choisis ont un bouton « – ».
- Récapitulatif : compteur avec la règle (min. 5, max. 6, ou en poids pour un coffret au poids), barre de progression avec le minimum marqué, aperçu visuel de la boîte (une case par article), prix, économie, récompense à débloquer et options cadeau. Ce qui manque encore est indiqué en bleu (« Ajoutez encore 2 articles… ») ; le rouge est réservé aux vrais blocages.
- Mobile : grille sur deux colonnes, modèles et étapes défilant horizontalement, barre fixe avec le nombre d’articles (ou le poids) et le prix, qui devient « Ajouter au panier » quand le coffret est valide.
- Surprenez-moi remplit le coffret au hasard en respectant les règles ; Sauvegarder et partager génère un lien qui recharge la composition.
Le prix est toujours recalculé par le serveur à partir de votre catalogue ; une composition envoyée par le navigateur est revérifiée (produits, déclinaisons, emplacements, poids, stock) avant d’être ajoutée au panier.
Modifier un coffret depuis le panier
Dans le panier et la commande en cours, la composition du coffret est suivie d’un lien Modifier ce coffret. Il rouvre le configurateur avec la composition et les options cadeau ; le bouton devient « Mettre à jour mon coffret ». À la validation, le coffret est remplacé à la même place, avec la même quantité. Dans le thème Classic, la composition et le lien se trouvent dans la fenêtre « Personnalisation du produit » de la ligne.
Affichage et acquisition
- Page du coffret : lien « Ouvrir la page du configurateur » dans le formulaire et dans la liste. Adresse
/box/ID-url-simplifieeavec les URL simplifiées, balise canonique, changement de langue vers l’URL de la langue choisie. - Accueil : bloc listant les coffrets disponibles (réglage du module).
- Widget : le bloc peut être greffé sur n’importe quel hook d’affichage (Apparence > Positions) ou placé dans un template :
{widget name='dfboxbuilder'},{widget name='dfboxbuilder' id_dfbox=3}ou{widget name='dfboxbuilder' title='Nos coffrets'}. - Fiches produit : bloc « Composez un coffret avec ce produit » (jusqu’à 3 coffrets), qui ouvre le configurateur avec le produit déjà ajouté.
- Catalogue : avec l’option « Afficher dans le catalogue », le coffret apparaît dans les catégories choisies et/ou la recherche. Le prix affiché est le prix « à partir de » (composition valide la moins chère, taxe et remise de groupe comprises ; pour un coffret au poids, au poids minimum ou au palier dégressif le plus avantageux) ; un coffret à prix fixe affiche son prix. Le lien mène au configurateur et il n’y a pas de bouton d’ajout au panier.
Le filtre de prix de la navigation à facettes et le tri par prix utilisent le prix enregistré du produit technique, qui vaut 0 : un coffret visible remonte en tête d’un tri par prix croissant.
Seuls les coffrets actifs, dans leur période de vente, non épuisés et autorisés pour le groupe du visiteur apparaissent dans les blocs. Désactiver un coffret désactive aussi son produit technique, qui disparaît des listes.
Panier, commandes et stock
- Prix par ligne : le prix du coffret est enregistré sur sa ligne de panier ; deux coffrets de compositions différentes gardent chacun leur prix. Les remises de groupe client s’appliquent ; les règles de prix catalogue et les remises par quantité ne s’appliquent pas aux coffrets.
- Stock des composants : vérifié à l’ajout sur l’ensemble du panier (autres coffrets et produits achetés seuls). Si le client augmente la quantité d’un coffret au-delà du stock, elle est ramenée au maximum possible sur la page panier, avec un message.
- Commande : le stock de chaque composant est pris à la validation, rendu si la commande passe en annulé ou en erreur de paiement, et repris si elle est réactivée. Une commande créée directement en erreur ne prend pas de stock.
- Coffrets indisponibles : un coffret supprimé, désactivé, terminé, pas encore commencé ou réservé à un autre groupe est retiré du panier sur les pages panier et commande, y compris après « Commander à nouveau ».
- Back-office et facture : la composition (par emplacement), l’emballage, le message cadeau et, pour un coffret au poids, le poids total sont affichés sur la commande et la facture.
Statistiques
Le bouton Statistiques de la liste ouvre un tableau de bord avec un choix de période (7, 30, 90 ou 365 jours) :
- coffrets commandés, chiffre d’affaires hors taxe, nombre moyen d’articles, conversion (commandes / vues) ;
- par coffret : vues du configurateur, ajouts au panier, commandes, coffrets, taux d’ajout, conversion, chiffre d’affaires et prix moyen ;
- articles les plus choisis et combinaisons les plus commandées.
Les vues et ajouts sont comptés depuis la version 1.2.0, robots exclus ; les commandes annulées sont exclues.
Suivi Google Analytics 4
Après l’ajout d’un coffret, le configurateur envoie un événement add_to_cart dans window.dataLayer (si Google Tag Manager ou gtag.js est présent) avec currency, value et l’article dfbox-ID. Un événement dfbox:added est aussi déclenché sur document, avec les mêmes données, pour d’autres outils.
FAQ et dépannage
Les boutons ne réagissent pas ou la page reste vide
Videz le cache de PrestaShop (Paramètres avancés > Performances) et, pendant vos tests, désactivez la combinaison des fichiers JS/CSS. Vérifiez que le coffret est actif, associé à la boutique et qu’il a au moins une source de produits.
La grille est vide
Les sources doivent contenir des produits actifs et disponibles à la commande dans la boutique courante. Si « Masquer les produits en rupture » est activé, les produits sans stock n’apparaissent pas. Pour un coffret au poids ou au prix au poids, les produits sans poids n’apparaissent pas non plus.
Un produit n’apparaît pas dans un coffret au poids
Il n’a pas de poids. Renseignez-le dans la fiche produit, onglet Livraison, ou dans l’impact sur le poids de ses déclinaisons. L’avertissement en haut du formulaire du coffret indique combien de produits éligibles sont concernés.
Un coffret visible dans une catégorie affiche 0,00 €
Mettez le module à jour en 1.2.1 ou plus : les listes affichent alors le prix « à partir de ».
Le coffret n’apparaît pas pour un client
Vérifiez les dates de vente, le stock limité et les groupes de clients dans l’onglet Disponibilité.
Le lien « Modifier ce coffret » n’apparaît pas
Il n’est affiché que dans le panier et la commande en cours, pour un coffret encore disponible. Dans le thème Classic, ouvrez la fenêtre de personnalisation de la ligne.
Le stock des composants ne baisse pas
Il est pris à la validation de la commande, pas à l’ajout au panier, et seulement si la gestion des stocks est activée. Une commande annulée rend le stock.