Variantes produit (taille, couleur)
OnePageBasket s'appuie sur les variantes natives de Dolibarr pour proposer un même produit décliné en plusieurs versions (taille, couleur, etc.). Chaque variante est un vrai produit enfant avec sa propre référence, son prix, son stock et ses images. En boutique, le client voit un seul produit parent et choisit sa combinaison à l'aide d'un sélecteur ; c'est la variante choisie (l'enfant) qui part au panier puis sur la commande ou le devis.
Prérequis : activer le module Variants de Dolibarr
Les variantes reposent entièrement sur le module Variants de Dolibarr. Tant qu'il n'est pas activé, la section "Variantes" de la configuration OnePageBasket reste masquée.
- Allez dans Configuration > Modules/Applications.
- Activez le module Variants (catégorie Produits/Services).
Créer un produit à variantes (côté Dolibarr)
La création des variantes est un acte d'administration Dolibarr classique, identique à une boutique sans OnePageBasket :
- Créez le produit parent (par exemple "T-shirt coton bio") et placez-le dans la catégorie de votre boutique en ligne.
- Définissez les attributs et leurs valeurs (menu Produits > Variantes) : par exemple l'attribut "Couleur" avec les valeurs "Rouge", "Bleu", et l'attribut "Taille" avec "S", "M", "L".
- Depuis la fiche du produit parent, onglet Variantes, générez les combinaisons. Dolibarr crée automatiquement un produit enfant par combinaison (T-shirt Rouge S, T-shirt Rouge M, etc.).
- Ajustez si besoin le prix, le stock et l'image de chaque enfant : ce sont de vrais produits, vous gardez la main sur chacun.
Comment cela apparaît en boutique
- La page du produit parent affiche un sélecteur (une liste déroulante par attribut). Tant que le client n'a pas choisi une combinaison complète, le bouton "Ajouter au panier" reste désactivé.
- À la sélection d'une combinaison, le prix, le stock et l'image se mettent à jour pour refléter la variante choisie.
- Les produits enfants n'apparaissent pas comme des articles séparés dans le catalogue, ni dans le sitemap, ni dans le flux Google Shopping : seul le parent est visible.
- Si un client ouvre directement l'URL d'une variante enfant, il est redirigé vers la page du parent avec la bonne combinaison présélectionnée.
- Le libellé de la variante (par exemple "Couleur: Rouge, Taille: M") apparaît dans le panier, et peut être ajouté à la description de la ligne de commande, de devis et de facture.
Réglages OnePageBasket
Les réglages se trouvent dans Configuration > Catalogue, section Variantes (visible uniquement si le module Variants est activé).
| Réglage | Défaut | Rôle |
|---|---|---|
| Changer l'image à la sélection | Oui | Remplace l'image principale par celle de la variante choisie. |
| Afficher le stock de la variante | Oui | Affiche le stock disponible de la combinaison sélectionnée (nécessite le module Stock). |
| Griser les combinaisons indisponibles | Non | Grise les options qui ne mènent à aucune combinaison existante ou en rupture. |
| Libellé de variante sur la commande | Oui | Ajoute le libellé (ex. Couleur: Rouge, Taille: M) à la description de la ligne. |
| Badge variantes sur les vignettes | Non | Affiche le nombre de variantes disponibles sur les vignettes du catalogue. |
Bon à savoir
- Le panier, la commande, le devis, la facture, le stock et la comptabilité manipulent toujours le produit enfant : aucun traitement particulier n'est nécessaire, une variante se comporte comme n'importe quel produit.
- Un produit parent "abstrait" ne peut jamais être commandé seul : si aucune combinaison n'est choisie, l'ajout au panier est refusé avec un message invitant à choisir une option.
- Une variante d'un produit masqué pour certains clients (visibilité par tags) reste masquée pour ces clients.