---
title: "Variantes produit"
weight: 55
description: "Proposer des produits déclinés en taille ou couleur dans la boutique (variantes Dolibarr)."
---

# 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.

1. Allez dans **Configuration > Modules/Applications**.
2. 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 :

1. Créez le **produit parent** (par exemple "T-shirt coton bio") et placez-le dans la
   catégorie de votre boutique en ligne.
2. 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".
3. 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.).
4. 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.