> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Modificateurs

> Laissez les clients personnaliser les produits storekit via des groupes de modificateurs. Configurez options, sélections min/max et choix gratuits.

Les modificateurs permettent aux clients de personnaliser les produits. Ils sont organisés en **groupes de modificateurs** - chaque groupe contient des options et des règles sur le nombre pouvant être sélectionnées.

## Exemples

| Groupe de modificateurs | Options                           | Règles                                    |
| ----------------------- | --------------------------------- | ----------------------------------------- |
| Choisissez votre taille | Petit, Moyen, Grand               | Requis, choisir exactement 1              |
| Ajouter des garnitures  | Pepperoni, champignons, olives... | Facultatif, choisir jusqu'à 5             |
| Sélectionnez votre base | Riz blanc, riz complet, nouilles  | Requis, choisir 1                         |
| Sauces supplémentaires  | Ketchup, mayo, BBQ...             | Facultatif, choisir n'importe quel nombre |

## Créer un groupe de modificateurs

1. Cliquez sur un produit pour ouvrir l'éditeur
2. Allez dans l'onglet **Modifiers**
3. Cliquez sur **Add Modifier Group**
4. Saisissez un nom (par exemple « Choose your size »)
5. Ajoutez des options avec des noms et des prix
6. Définissez les règles de sélection min/max
7. Cliquez sur **Save Modifiers**

## Paramètres du groupe de modificateurs

### Nom et description

| Champ           | Description                                            |
| --------------- | ------------------------------------------------------ |
| **Name**        | Affiché aux clients (par exemple « Choose your size ») |
| **Description** | Contexte supplémentaire facultatif                     |
| **SKU / PLU**   | Pour l'intégration POS                                 |

### Règles de sélection

Définissez combien d'options les clients doivent/peuvent choisir :

| Paramètre         | Exemple                        | Comportement                              |
| ----------------- | ------------------------------ | ----------------------------------------- |
| Min : 1, Max : 1  | Choisissez une taille          | Requis, choisir exactement une            |
| Min : 0, Max : 3  | Ajouter des garnitures         | Facultatif, choisir jusqu'à 3             |
| Min : 2, Max : 4  | Choisissez vos accompagnements | Requis, choisir 2 à 4                     |
| Min : 0, Max : 10 | Sauces supplémentaires         | Facultatif, choisir n'importe quel nombre |

<Tip>
  Définissez **Min : 0** pour rendre un groupe de modificateurs facultatif. Définissez **Min : 1** ou plus pour le rendre requis.
</Tip>

### Autoriser plusieurs de la même option

Activez **Allow customers to select an option more than once** pour des cas comme :

* « 2x fromage supplémentaire »
* « 3x bacon »

Vous pouvez éventuellement définir une limite spécifique par option.

### Modificateurs gratuits

Définissez un nombre de **Free Modifiers** pour donner aux clients un certain nombre de sélections gratuites avant facturation. Utile pour :

* « Les 3 premières garnitures gratuites, puis 0,50 £ chacune »
* « Comprend 2 sauces, sauces supplémentaires 0,30 £ »

## Options de modificateurs

Chaque option d'un groupe a :

| Champ              | Description                               |
| ------------------ | ----------------------------------------- |
| **Name**           | Nom de l'option affiché aux clients       |
| **Price**          | Coût supplémentaire (peut être 0 £)       |
| **Original Price** | Pour afficher les remises sur les options |
| **POS ID**         | Pour l'intégration POS                    |
| **Tax Rate**       | Remplace la taxe par défaut               |
| **Default Qty**    | Présélectionner cette option              |
| **In Stock**       | Basculer la disponibilité                 |

### Quantité par défaut

Présélectionnez des options en définissant une quantité par défaut. Le total de toutes les quantités par défaut ne peut pas dépasser le maximum du groupe.

### Disponibilité de l'option

Désactivez **In Stock** pour masquer temporairement une option sans la supprimer.

### Tags et allergènes

Les options de modificateurs peuvent avoir leurs propres informations d'allergènes, tags diététiques et données nutritionnelles. Lorsqu'un client sélectionne des options, les informations combinées d'allergènes du produit et de tous les modificateurs sélectionnés sont affichées.

Voir [Tags et allergènes](/docs/fr/guides/menu/tags-allergens) pour plus de détails.

## Paramètres d'affichage

### Affichage initial

Contrôlez comment le groupe de modificateurs apparaît sur la page produit :

| Paramètre     | Comportement                                |
| ------------- | ------------------------------------------- |
| **Expanded**  | Options visibles immédiatement (par défaut) |
| **Collapsed** | Options masquées derrière un clic           |

### Imprimer comme des produits

Activez **Print modifier options as products** pour imprimer chaque modificateur sélectionné sur sa propre ligne sur les tickets, plutôt qu'en tant que sous-articles sous le produit.

## Réutiliser les groupes de modificateurs

Vous pouvez attacher des groupes de modificateurs existants à plusieurs produits :

1. Ouvrez l'onglet Modifiers d'un produit
2. Cliquez sur **Add Existing Group**
3. Sélectionnez parmi vos groupes de modificateurs existants

Les modifications apportées à un groupe de modificateurs partagé affectent tous les produits qui l'utilisent.

<Warning>
  Modifier un groupe de modificateurs partagé le met à jour partout où il est utilisé. Créez un nouveau groupe si vous avez besoin d'options différentes pour des produits spécifiques.
</Warning>

## Réorganisation

* Faites glisser les groupes de modificateurs pour changer leur ordre sur le produit
* Faites glisser les options au sein d'un groupe pour changer leur ordre

## Supprimer des groupes de modificateurs

1. Ouvrez le groupe de modificateurs
2. Cliquez sur **Remove Group**

Cela retire le groupe du produit actuel. S'il est partagé avec d'autres produits, il reste sur ces produits.

## Astuces

* **Nommez clairement les groupes** - « Choose your size » et non « Size options »
* **Ordonnez les options logiquement** - Du plus petit au plus grand, ou par popularité
* **Utilisez des options à 0 £** - Pour les substitutions ou préférences (par exemple « Pas d'oignons »)
* **Fixez des limites raisonnables** - Trop d'options submerge les clients
* **Utilisez des modificateurs gratuits** - Encourage la personnalisation sans complexité


## Related topics

- [Aperçu du menu](/docs/fr/guides/menu/overview.md)
- [Structure du menu](/docs/fr/guides/menu-engineering/menu-structure.md)
- [Modificateurs gratuits](/docs/fr/guides/menu/free-modifiers.md)
- [Modificateurs de suppression](/docs/fr/guides/menu/removal-modifiers.md)
- [Imprimer les modificateurs comme des produits](/docs/fr/guides/menu/print-modifiers-as-products.md)