Configuration des métachamps et métaobjets

Les fonctionnalités mobilier de Tenora lisent les données produit dans des métachamps et des métaobjets. Cette page vous explique comment les créer, étape par étape, avec les noms et les types exacts attendus par le thème.

• Un métachamp est un champ supplémentaire sur un produit, par exemple « Largeur ».
• Un métaobjet est une entrée réutilisable avec ses propres champs, par exemple un matériau appelé « Chêne massif » avec une image et des instructions d'entretien.

Vous configurez les définitions une seule fois. Ensuite, vous renseignez les valeurs pour chaque produit.

Avant de commencer

• Saisissez chaque espace de nommage et chaque clé exactement comme indiqué, en minuscules et avec des tirets bas. Le thème lit ces noms exacts. La moindre différence, comme specs.Width ou spec.width, empêche le thème de trouver la valeur.
• Créez d'abord la définition du métaobjet « Material ». Le métachamp specs.materials en a besoin.
• Si une valeur est vide, le bloc correspondant est masqué sur la page produit. Vous pouvez compléter vos produits petit à petit.

Fonctionnalité	Métachamps lus
Dimensions	specs.width, specs.depth, specs.height, specs.seat_height, specs.weight
Est-ce que ça rentre ?	specs.width, specs.depth, specs.height (les trois sont nécessaires)
Matériaux et entretien	specs.materials et le métaobjet « Material »
Commander un échantillon	specs.sample_product (ou le paramètre Produit échantillon du bloc)
Livraison et montage	delivery.lead_time, delivery.method, delivery.assembly_required, delivery.assembly_guide

Vérifiez d'abord le système d'unités de votre boutique

Les métachamps de dimension et de poids utilisent le système d'unités de votre boutique comme unité par défaut.

1. Dans votre interface administrateur Shopify, accédez à Paramètres (Settings) → Général (General).
2. Trouvez Paramètres par défaut de la boutique (Store defaults) → Système d'unités (Unit system).
3. Vérifiez s'il est réglé sur le système métrique ou impérial.

Si votre boutique utilise le système impérial, l'interface administrateur sélectionne par défaut les pouces et les onces. Une valeur saisie comme 220 est alors enregistrée comme 220 in, sauf si vous changez l'unité à côté du champ. Le thème convertit correctement les unités, mais les chiffres ne correspondront pas à ce que vous vouliez.

Conseil : vérifiez toujours l'unité à côté de la valeur avant d'enregistrer un produit.

Le bloc Dimensions affiche toujours les centimètres et les pouces, ainsi que les kilogrammes et les livres, quelle que soit l'unité prise en charge utilisée dans l'interface administrateur (mm, cm, m, in, ft ou yd pour les longueurs ; g, kg, lb ou oz pour le poids). Les clients peuvent changer d'unité, et leur choix est mémorisé sur leur appareil.

Étape 1 : créer la définition du métaobjet « Material »

1. Dans votre interface administrateur Shopify, accédez à Paramètres (Settings) → Données personnalisées (Custom data).

2. Sous Métaobjets (Metaobjects), sélectionnez Ajouter une définition (Add definition).

3. Saisissez le Nom (Name) : Material.

4. Vérifiez le Type. Shopify le remplit à partir du nom. Il doit être exactement material.

5. Sélectionnez Ajouter un champ (Add field) et ajoutez ces quatre champs :

   Nom du champ	Clé	Type	Options
   Name	name	Texte sur une seule ligne (Single line text)	Marquer comme obligatoire
   Image	image	Fichier (File), avec uniquement Images autorisées	Un seul fichier
   Description	description	Texte multiligne (Multi-line text)
   Care instructions	care_instructions	Texte multiligne (Multi-line text)

6. Dans les options d'accès, activez l'accès Vitrines (Storefronts). Sans cet accès, le thème ne peut pas lire le matériau.

7. Laissez l'option Statut actif/brouillon (Active-draft status) désactivée. Si vous l'activez, vous devez passer chaque entrée de matériau au statut Actif (Active), sinon elle n'apparaîtra pas dans votre boutique.

8. Facultatif : définissez Name comme nom d'affichage, pour retrouver facilement les entrées dans les listes.

9. Sélectionnez Enregistrer.

Les noms de champs (Name, Care instructions…) ne sont visibles que dans l'interface administrateur : vous pouvez les nommer en français. Les clés et le type material doivent rester exactement comme indiqué.

Étape 2 : ajouter vos matériaux

1. Dans votre interface administrateur Shopify, accédez à Contenu (Content) → Métaobjets (Metaobjects).

2. Sélectionnez Material.

3. Sélectionnez Ajouter une entrée (Add entry).

4. Remplissez les champs. Par exemple :

   Nom	Description	Instructions d'entretien
   Chêne massif	Chêne européen certifié FSC avec une finition à l'huile naturelle.	Essuyer avec un chiffon doux et sec. Huiler à nouveau une fois par an. Éviter la chaleur directe.
   Lin mélangé	55% lin, 45% coton. Housses amovibles prélavées.	Housses lavables à 30°C. Sécher à l'air libre et repasser encore humide.
   Rotin naturel	Rotin tressé à la main sur une structure en bois massif.	Dépoussiérer avec une brosse douce. Tenir éloigné des radiateurs et du soleil direct.

5. Ajoutez une Image pour chaque matériau, par exemple un gros plan du bois ou du tissu. Une image carrée donne le meilleur résultat.

6. Sélectionnez Enregistrer.

Conseils

• Avec la mise en page Cartes, le bloc n'affiche que la première phrase de la description. Placez l'information la plus importante dans la première phrase.
• Les retours à la ligne de la description et des instructions d'entretien sont conservés.
• Un matériau sans nom ne s'affiche pas.

Étape 3 : créer les définitions de métachamps de produit

1. Dans votre interface administrateur Shopify, accédez à Paramètres → Données personnalisées.
2. Sous Métachamps (Metafields), sélectionnez Produits (Products).
3. Sélectionnez Ajouter une définition.
4. Saisissez le Nom, puis l'Espace de nommage et clé (Namespace and key) exactement comme indiqué ci-dessous, avec le point (par exemple specs.width).
5. Sélectionnez le Type et les options indiqués dans le tableau.
6. Vérifiez que l'accès Vitrines (Storefronts) est activé. Il l'est généralement par défaut.
7. Sélectionnez Enregistrer.
8. Recommencez pour chaque ligne du tableau.

Nom	Espace de nommage et clé	Type	Options
Largeur	specs.width	Dimension	Une valeur
Profondeur	specs.depth	Dimension	Une valeur
Hauteur	specs.height	Dimension	Une valeur
Hauteur d'assise	specs.seat_height	Dimension	Une valeur
Poids	specs.weight	Poids (Weight)	Une valeur
Matériaux	specs.materials	Métaobjet (Metaobject), puis sélectionnez Material	Liste d'entrées
Produit échantillon	specs.sample_product	Produit (Product)	Un seul produit
Délai de fabrication	delivery.lead_time	Texte sur une seule ligne	Une valeur
Mode de livraison	delivery.method	Texte sur une seule ligne	Une valeur. Facultatif : Limiter aux choix prédéfinis (Limit to preset choices), par exemple Standard delivery, White-glove delivery, Flat-pack delivery
Montage requis	delivery.assembly_required	Vrai ou faux (True or false)
Notice de montage	delivery.assembly_guide	Fichier (File)	Autoriser les fichiers PDF (ou tous les types de fichiers)

Remarques

• specs.materials peut aussi être une entrée unique (Une entrée) plutôt qu'une liste. Le thème prend en charge les deux. Nous recommandons une liste, pour qu'un produit puisse avoir plusieurs matériaux.
• Les noms de la colonne Nom ne s'affichent que dans l'interface administrateur. Vous pouvez les traduire ou les modifier. L'espace de nommage et la clé doivent rester exactement comme indiqué.
• Conseil : activez Épingler aux pages produit (Pin to product pages) lorsque vous créez une définition. Les champs apparaissent alors directement sur chaque page produit de l'interface administrateur.

Étape 4 : compléter vos produits

1. Dans votre interface administrateur Shopify, accédez à Produits (Products) et ouvrez un produit.

2. Faites défiler jusqu'à Métachamps (Metafields).

3. Remplissez les champs pour ce produit. Par exemple, pour un canapé :

   Métachamp	Exemple de valeur
   Largeur	220 cm
   Profondeur	95 cm
   Hauteur	82 cm
   Hauteur d'assise	44 cm
   Poids	68 kg
   Matériaux	Chêne massif, Lin mélangé
   Produit échantillon	Lot d'échantillons de tissu
   Délai de fabrication	Fabriqué sur commande, expédié sous 6 à 8 semaines
   Mode de livraison	Livraison premium avec installation
   Montage requis	Faux
   Notice de montage	Un fichier PDF

4. Vérifiez l'unité de chaque dimension et de chaque poids avant d'enregistrer.

5. Sélectionnez Enregistrer.

6. Ouvrez le produit dans votre boutique en ligne et vérifiez les blocs Dimensions, Matériaux et entretien, Commander un échantillon et Livraison et montage.

Données partielles : ce qui se passe

Vous n'avez pas besoin de remplir tous les champs. Par exemple, si un produit n'a qu'une largeur, une hauteur et un délai de fabrication :

• Le tableau des dimensions affiche uniquement la largeur et la hauteur.
• Le schéma s'affiche, car il n'a besoin que de la largeur et de la hauteur.
• « Est-ce que ça rentre ? » est masqué, car l'outil a aussi besoin de la profondeur.
• Les blocs Matériaux et entretien et Commander un échantillon sont masqués (sauf si un Produit échantillon est défini pour le bloc Commander un échantillon dans l'éditeur de thème).
• Le bloc Livraison et montage affiche uniquement le délai de fabrication.

Importer les valeurs des métachamps avec un fichier CSV

Si vous avez beaucoup de produits, vous pouvez remplir les métachamps avec l'importation CSV de produits de Shopify. Créez les définitions de métachamps (étape 3) avant d'exporter ou d'importer. Le fichier CSV contient alors une colonne pour chaque définition.

1. Dans votre interface administrateur Shopify, accédez à Produits et sélectionnez Exporter (Export) pour obtenir un fichier CSV de vos produits actuels.

2. Ouvrez le fichier dans un tableur. Repérez les colonnes de métachamps. Leur nom contient l'espace de nommage et la clé, par exemple :

   • Width (product.metafields.specs.width)
   • Weight (product.metafields.specs.weight)
   • Materials (product.metafields.specs.materials)

3. Renseignez les valeurs :

   Colonne	Exemple de valeur	Remarque
   Width, Depth, Height, Seat height	180cm	Un nombre et une unité
   Weight	58 kg	Un nombre et une unité
   Materials	solid-oak; linen-blend	Identifiants (handles) des entrées de matériaux, séparés par un point-virgule et une espace
   Lead time	Made to order, ships in 6–8 weeks	Texte brut
   Assembly required	TRUE ou FALSE

4. Enregistrez le fichier au format CSV (UTF-8).

5. Dans Produits, sélectionnez Importer (Import), choisissez le fichier et suivez les étapes.

6. Après l'importation, ouvrez quelques produits et vérifiez les valeurs et les unités.

Conseils

• Importez d'abord un petit fichier de test avec deux ou trois produits.
• L'identifiant (handle) d'un matériau est indiqué sur son entrée dans Contenu → Métaobjets → Material. Il s'agit généralement du nom en minuscules avec des traits d'union, par exemple solid-oak.
• Indiquez toujours l'unité dans les valeurs de dimension et de poids. Sans unité, la valeur risque d'être lue dans l'unité par défaut de votre boutique.

Traduire vos données produit

Si votre boutique propose plusieurs langues, traduisez les valeurs textuelles (matériaux, délais de fabrication et modes de livraison) avec les outils de traduction de Shopify, comme pour les descriptions de produits. Les libellés ajoutés par le thème, comme « Largeur », « Entretien » et « Montage partiel requis », sont déjà traduits. Consultez Vendre à l'international.

Dépannage

Problème	À vérifier
Un bloc n'apparaît pas	L'espace de nommage et la clé sont exactement comme indiqué, l'accès Vitrines est activé et le produit a une valeur. Le bloc figure aussi dans le modèle de produit utilisé par le produit.
Les matériaux n'apparaissent pas	L'entrée de matériau a un Nom. Si la définition utilise le Statut actif/brouillon, l'entrée est au statut Actif.
Les tailles sont fausses	L'unité à côté de chaque valeur. Vérifiez le système d'unités de votre boutique.
« Est-ce que ça rentre ? » n'apparaît pas	La largeur, la profondeur et la hauteur ont toutes une valeur, et Afficher l'outil de vérification d'encombrement est activé dans le bloc Dimensions.
L'échantillon n'apparaît pas	Le produit échantillon est actif et disponible sur votre canal de vente Boutique en ligne. L'échantillon n'est pas le produit lui-même.

Pour plus d'aide, consultez les Questions fréquentes.