Attributs et caractéristiques des produits : variantes, types d'options et règles

Pour savoir quelle méthode choisir et à quel moment, consultez la section « Caractéristiques » ou « Produits distincts ».

La liste indique le nombre de produits et de valeurs associés à chaque caractéristique. Cliquez pour agrandir.

1. Créer une caractéristique : onglet « Insérer », saisir le nom pour chaque langue, enregistrer. Un commentaire permet de distinguer les caractéristiques dont les noms se ressemblent (par exemple « Taille textile » et « Taille chaussures »).
2. Créer des valeurs : via « Modifier la caractéristique » et l’onglet « Valeurs de la caractéristique… », vous créez les valeurs et définissez leur ordre de tri. Celui-ci s’applique partout où vous ne définissez pas d’ordre spécifique au niveau du produit.
3. Définir les paramètres par défaut : dans l’onglet « Modifier la caractéristique », sous « Présélection lors de l’ajout dans les produits », vous définissez les paramètres avec lesquels la caractéristique est intégrée à un produit : champ obligatoire, type d’option, affichage de l’image de l’option et tri par numéro d’article. Cela permet de gagner du temps lorsque vous gérez de nombreux produits.

Paramètres par défaut avec lesquels la caractéristique est intégrée dans les nouveaux produits. Cliquez pour agrandir.

Les valeurs et leur ordre de tri. Cliquez pour agrandir.

Autres fonctionnalités de cette page :

• Statut d'affichage : s'il est réglé sur « visible », les valeurs « Show-only » de cette caractéristique apparaissent également dans la liste des produits.
• Fusionner : les options « Fusionner l'option » et « Fusionner la valeur de l'option » permettent de supprimer les caractéristiques et les valeurs créées en double, par exemple après une importation.
• Nettoyage : « Supprimer les caractéristiques de produit inutilisées » supprime les caractéristiques sans produit, « Supprimer les valeurs inutilisées » fait de même pour les valeurs.
• Modifier les valeurs supplémentaires Fonctions avancées des caractéristiques: colonnes numériques personnalisées par valeur pour les formules de prix, voir Formules de prix.

Barre d’outils et la caractéristique « Couleur » déployée avec ses valeurs. Cliquez pour agrandir.

La barre d'outils

• Déplier/Replier (double flèche à gauche dans la barre) : ouvre ou ferme toutes les caractéristiques.
• Ajouter une caractéristique unique (signe « + » vert) : ajouter une caractéristique avec les valeurs sélectionnées.
• Sélection rapide des caractéristiques (icône en forme de coche) : sélectionner plusieurs caractéristiques et valeurs à la fois.
• Ajouter un bloc – Fonctions avancées des caractéristiques: organiser les caractéristiques de la page produit en sections avec un titre.
• (Nombre) Règles – Fonctions avancées des caractéristiques: ensemble des règles du produit.
• Sélectionner l’option principale: la caractéristique dont les valeurs apparaissent sous forme de vignettes dans la liste des produits, voir Option principale.
• Configurer les types d’extensions (roue dentée) : ordre et affichage des boutons « Prix d’achat », « Prix de vente conseillé » et « Produits associés » sous chaque valeur.
• Profils de caractéristiques du produit (sélection à droite) : ensemble enregistré de caractéristiques que vous attribuez au produit. Le crayon situé à côté permet d’ouvrir les profils pour les modifier.

Paramètres par caractéristique

Six types d'options sur une page produit : bouton radio, liste déroulante, bouton radio, champ de texte, zone de texte et case à cocher. Cliquez pour agrandir.

Où se trouve la sélection sur la page produit

S'il y a jusqu'à trois critères de sélection, ceux-ci apparaissent dans l'encadré de prix à côté de l'image ; s'il y en a davantage, ils se trouvent en dessous, sous « Veuillez faire votre choix ». Vous pouvez définir cette limite dans Paramètres → Design → Fiche produit → Nombre maximal d’options dans l’encadré de prix (page d’informations sur le produit) (DISPLAY_MAX_OPTIONS). Sur smartphone, la sélection apparaît toujours dans l’encadré de prix.

Définir plus précisément les champs de saisie (type d’option « Texte »)

Avec le type d’option « Texte », le champ « Détails » apparaît à côté de la caractéristique. Le bouton situé à côté (aide à la saisie pour les attributs HTML) ouvre la boîte de dialogue « Sélectionner les paramètres du champ de saisie de texte ». Vous y définissez :

• Type de données : text, number, date, color ou email. Avec « date », un calendrier s’affiche ; avec « number », un champ avec des boutons « + » et « - ».
• Longueur minimale et maximale pour les textes, valeur minimale, maximale et incrément pour les nombres. La boutique affiche ces limites sous le champ.
• Remarque concernant les champs vides (texte de remplacement) et un contenu prédéfini.

La boîte de dialogue inscrit les informations dans le champ « Détails », par exemple maxlength=20;placeholder=z. B. Teamname. Vous pouvez également les saisir directement à cet endroit.

Texte souhaité : 20 caractères maximum, avec texte de remplacement. Cliquez pour agrandir.

Champs numériques avec limites. Le supplément pour le matériel est calculé à partir des données saisies. Cliquez pour agrandir.

Taille avec stock par valeur et supplément pour la taille XXL. Le prix de l'option est indiqué hors taxes dans le champ. Cliquez pour agrandir.

Le stock en valeur n’est débité que si l’option Paramètres → Paiement → Stock → Ajuster le stock (STOCK_LIMITED) est activée. Avec l’option « Désactiver les produits en rupture de stock » (SOLD_OUT_SET_INACTIVE), la boutique désactive un article dès que son stock passe en dessous de 1.

Voici comment créer un groupe de caractéristiques

1. Attribuez la première caractéristique au produit, par exemple « Couleur ».
2. Cliquez sur le signe « + » vert en haut de cette caractéristique (info-bulle « Ajouter une valeur d’option au groupe d’options ») et sélectionnez la deuxième caractéristique, par exemple « Taille ». La deuxième caractéristique ne doit pas encore être attribuée individuellement au produit, sinon elle n’apparaîtra pas dans la liste.
3. Cliquez sur « Ajouter une valeur ». La boutique vous demande les valeurs les unes après les autres, c’est-à-dire d’abord la couleur, puis la taille. «Ajouter toutes les valeurs »crée toutes les combinaisons en une seule fois (jusqu’à près de 200 combinaisons).
4. Pour chaque combinaison, saisissez la référence, le GTIN, le stock et, si nécessaire, l’image et le prix, puis enregistrez en cliquant sur « Mettre à jour ».

Étape 2 : sélectionner la deuxième caractéristique. Cliquez pour agrandir.

Étape 3 : « Ajouter toutes les valeurs » crée toutes les combinaisons. Cliquez pour agrandir.

Chaque combinaison dispose de sa propre ligne avec la référence, le GTIN et le stock. Cliquez pour agrandir.

Affichage dans la boutique : le mode configurateur

Il existe cinq modes d’affichage pour les groupes de caractéristiques : Select, Radio, Radio (Button), Radio (Popup) et Cart. À partir de deux caractéristiques dans le groupe, la boutique affiche chaque caractéristique dans un champ distinct (mode configurateur). Les champs sont interdépendants : la taille ne peut être sélectionnée qu’une fois la couleur choisie (« Veuillez d’abord choisir une couleur ») et les combinaisons qui n’existent pas ou qui sont désactivées apparaissent avec ⁽¹⁾ et sont verrouillées.

Couleur « Navy » sélectionnée : la combinaison « Navy / XXL » est désactivée et donc verrouillée. L'image de la combinaison apparaît dans la galerie. Cliquez dessus pour l'agrandir.

Vous définissez le seuil sous Paramètres → Design → Liste des produits → Taille du groupe d’options à partir duquel l’affichage divisé (« mode configurateur ») doit s’afficher (OPTIONS_SPLIT_NUM, valeur par défaut 2). En dessous, la boutique affiche le groupe sous la forme d’un champ unique contenant des entrées telles que « Noir / M ». Vous pouvez activer le regroupement sous les champs à l’aide de l’option « Regroupement des groupes d’options en vue fractionnée » (OPTIONS_SPLIT_SUMMARY).

Saisissez les quantités par taille, puis cliquez une fois sur « Panier ». Cliquez pour agrandir.

Résultat : deux articles dans le panier. Cliquez pour agrandir.

• Une seule caractéristique de type « Cart » est autorisée par produit. Utilisez pour cela la caractéristique à laquelle sont associés les références et les stocks.
• Une caractéristique « Cart » ne peut pas être un champ obligatoire ; le bouton correspondant n'apparaît donc pas.
• Chaque ligne affiche la valeur, sa référence, les informations de livraison et le prix avec le supplément, ainsi que l'image de la valeur, si elle en possède une.

Dans la liste des produits, les valeurs de l’option principale s’affichent sous forme de vignettes sous le produit. Cliquez dessus pour les agrandir.

• Liste des produits : les valeurs s'affichent sous forme de vignettes avec une image et un nom. Un clic ouvre la page du produit avec la valeur présélectionnée. Le nombre maximal de vignettes affichées est défini dans Paramètres → Général → Valeurs maximales → Nombre maximal d'images et de noms d'options principales dans la liste (MAX_PRIMARY_OPTIONS_IN_LISTING).
• Flux Google : le flux destiné au Merchant Center divise le produit en entrées distinctes en fonction de l’option principale, par exemple « T-shirt bio Classic - Couleur : bleu marine », chacune comportant le prix, l’image et le lien vers la valeur présélectionnée. Seules les valeurs disposant de leur propre référence d’article sont divisées.

Les caractéristiques peuvent servir de filtres sur les pages de catégories et de recherche, qu’il s’agisse de caractéristiques de sélection, de caractéristiques « Afficher uniquement » ou de caractéristiques « Masquer ». Vous pouvez définir quelles caractéristiques apparaissent comme filtres sous Produits → Filtres de produits. Le guide Recherche dans la boutique décrit comment la boutique filtre et effectue des recherches.

Si vous travaillez avec des familles (maître/esclave), le maître reprend les caractéristiques filtrables de ses esclaves afin que la famille soit trouvée dans le filtre avec toutes ses variantes.

Vous configurez les familles dans l’onglet « Général » du produit : « Groupe de produits (produits maîtres/esclaves) », « Produit maître » et « Type d’affichage des produits esclaves » (Liste, Sélection, Bouton radio, Bouton radio (bouton) ou Bouton radio (fenêtre contextuelle)). Les deux peuvent être combinés, par exemple une famille par couleur avec la caractéristique « Taille » dans chaque produit esclave.

Vous pouvez l’ouvrir dans l’onglet « Caractéristiques » via le bouton « (Nombre) Règles ». La boîte de dialogue « Gérer les règles pour… » répertorie tous les blocs de règles du produit. Chaque bloc se compose d’une ou plusieurs conditions et d’une ou plusieurs réactions.

Quatre blocs de règles pour le t-shirt avec impression personnalisée. Cliquez pour agrandir.

Un bloc : si la couleur = noir, alors masquer la couleur d’impression « noir ». Cliquez pour agrandir.

Conditions

• Sélection client/saisie d’une caractéristique : la caractéristique à vérifier. Il existe également « --Nombre d’articles-- » (la quantité dans le panier) et « --sans condition (toujours exécuter)-- ».
• Opérateurs de comparaison : < (inférieur à), ≤ (inférieur ou égal à), = (égal à), ≠ (différent de), ≥ (supérieur ou égal à), > (supérieur à). Cela permet également de vérifier des saisies de texte et des nombres, par exemple « Largeur > 300 ».
• Comparaison : une valeur fixe (« --Sélectionner une valeur-- »), une formule (« --Saisir une formule-- ») ou une autre caractéristique.
• Liaison : pour chaque bloc, on applique soit « Toutes les règles » (et), soit « Au moins une règle » (ou). Si vous avez besoin des deux, créez deux blocs.

Les sept réactions

Le bouton «Réaction immédiate sans attendre le clic sur le panier » (symbole en forme de flèche à côté de la réaction) permet à la réaction de s’appliquer dès la sélection. Sans lui, la boutique ne vérifie qu’au moment du clic sur « Panier », ce qui convient pour les messages d’erreur. Ce sont les serveurs qui évaluent les règles, et non les navigateurs ; elles ne peuvent donc pas être contournées.

T-shirt noir : la couleur d’impression « Noir » est masquée. Cliquez pour agrandir.

Taille XXL : le message d'avertissement s'affiche en haut de la page. Cliquez pour agrandir.

• Statut : chaque bloc peut être désactivé individuellement. La boutique enregistre comme désactivé tout bloc qui ne peut pas fonctionner ainsi et le signale.
• Copier-coller des règles : transfère les règles vers un autre produit via le presse-papiers, au choix en les ajoutant ou en les remplaçant.
• Via l'interface : les règles peuvent également être lues et écrites via l'API xoPort (champ « options_rules »).

Formule dans le prix de l’option : surface en m² multipliée par le prix au m². Cliquez pour agrandir.

Voici comment fonctionne cet exemple

La bannière publicitaire comporte les champs de texte « Largeur en cm » (ID de caractéristique 10) et « Hauteur en cm » (ID 11), tous deux de type « nombre ». Pour la valeur « Bâche PVC 510 g/m² », le prix de l'option est le suivant :

ov10*ov11/10000*12.52

la largeur multipliée par la hauteur, divisée par 10 000, donne la surface en m², multipliée par 12,52 € HT (14,90 € TTC) par m². Pour 200 × 100 cm, cela correspond à 2 m², soit un supplément de 25,04 € HT ou 29,80 € TTC. L’ID de caractéristique figure dans la liste sous « Caractéristiques du produit ».

200 × 100 cm en PVC : 9,90 € de prix de base plus 29,80 € de prix au m². Cliquez pour agrandir.

• Les valeurs autorisées sont « + - * / ( ) » et les nombres avec un point comme séparateur décimal (12.52, et non 12,52). Une division par 0 donne 0.
• Les formules utilisent les prix nets, tout comme le prix de l’option lui-même.
• Le champ « Poids » accepte également une formule, par exemple un poids au m².
• Vous gérezles valeurs supplémentaires sous Produits → Caractéristiques des produits → « Modifier les valeurs supplémentaires » : un tableau comportant des colonnes distinctes pour chaque valeur, par exemple le prix au m² et le poids au m² pour chaque matériau.

Exemples pratiques

• CSV : sous Outils → Gestionnaire d’import/export CSV xoPort, le port « Options produit (caractéristiques) » permet de gérer les caractéristiques, les valeurs, les prix, les références et les stocks.
• API REST : l’importation de produits accepte les caractéristiques dans le champ options et crée les caractéristiques et valeurs manquantes. L’exportation fournit les caractéristiques individuelles dans options et les groupes de caractéristiques avec toutes leurs combinaisons dans option_groups. Les règles se trouvent dans le champ options_rules. Pour plus de détails, consultez la documentation de l’API « Products ».
• Gestion des stocks : les caractéristiques « Show-only » sont particulièrement adaptées aux données issues de la gestion des stocks, car elles n’influencent pas le processus de commande.

• Lors de l’enregistrement du produit : la boutique rejette toute caractéristique obligatoire sans valeur active et toute présélection sur une valeur inactive, en affichant un message d’erreur.
• Lors de la restauration d’un panier : si un client se connecte et qu’un ancien panier est restauré, la boutique vérifie la sélection enregistrée. Si une valeur n’existe plus, elle le signale au lieu de calculer incorrectement le montant de la ligne.
• Lors du paiement : sous Paramètres → Protection des données → Règles GEO IP → Vérifier l’absence de sélection d’attributs lors du paiement (CHECKOUT_ATTRIBUTE_GUARD_MODE), vous définissez ce qui se passe lorsqu’un article ne comporte pas de caractéristique obligatoire : off (aucune vérification), log (uniquement consigner dans le journal, valeur par défaut) ou block (bloquer le paiement). Ces lignes ne sont pas créées via la page produit, mais par exemple via l’importation d’une liste d’articles. Si une sélection enregistrée n’est plus disponible à la commande, le processus de paiement bloque systématiquement.

• Stock du produit trop faible : le stock pris en compte est la plus petite des deux valeurs entre le stock du produit et celui de la référence. Si le stock du produit est à 0, la variante est considérée comme en rupture de stock, même si le stock de la référence est à 50.
• Une deuxième caractéristique manque lors du regroupement : une caractéristique déjà attribuée individuellement au produit ne peut pas être ajoutée au groupe. Supprimez-la au préalable.
• Le prix de l'option est net : si vous souhaitez un supplément de 2 € brut, saisissez 1,6807 avec une TVA de 19 % ou utilisez le calculateur situé à côté du champ.
• Virgule dans les formules : dans les formules, seul le point est utilisé comme séparateur décimal.
• Sélection non obligatoire : sans « Veuillez choisir », la première valeur est déjà sélectionnée par défaut. Pour les tailles, cela peut entraîner des erreurs de commande. Activez simultanément les options « Veuillez choisir » et « Champ obligatoire ».
• Caractéristiques en double après l’importation : « Taille » et « Groesse » sont considérées comme deux caractéristiques distinctes par la boutique. Regroupez-les sous « Caractéristiques du produit ».
• Références d’articles dans le flux Google : les valeurs de l’option principale doivent comporter des références d’articles complètes, voir « Option principale ».
• Conversion en groupe de caractéristiques : lors du regroupement, les valeurs existantes du groupe sont perdues. Sauvegardez au préalable les références, les GTIN et les stocks, par exemple via une exportation CSV.

1. Créez les caractéristiques et leurs valeurs sous Produits → Caractéristiques du produit, puis triez les valeurs.
2. Choisissez : caractéristiques individuelles, groupe de caractéristiques ou famille ?
3. Attribuez les caractéristiques dans l’onglet « Caractéristiques », définissez le type d’option, « Veuillez sélectionner » et marquez le champ comme obligatoire.
4. Pour chaque valeur, saisissez le supplément de prix, la référence, le GTIN, le stock et l’image.
5. Définir le stock du produit à un niveau au moins égal au stock le plus élevé.
6. Définir l’option principale si les variantes doivent apparaître dans la liste des produits et dans le flux Google.
7. Si nécessaire, créer des règles et des formules dans les « Fonctions avancées des caractéristiques ».
8. Enregistrez, puis sur la page du produit, cliquez une fois sur chaque sélection : prix, référence, image et stock.