Terroir
Guide de mise en route

1. Installer le thème

1. Dans votre admin Shopify : Boutique en ligne → Thèmes.
2. Ajouter un thème → Importer un fichier zip.
3. Choisissez terroir.zip — le fichier intérieur du paquet que vous avez téléchargé, pas le paquet entier.
4. Il apparaît dans votre bibliothèque sous le nom TERROIR, non publié. Personnaliser pour y travailler ; publiez quand vous êtes prêt.

Si Shopify indique que le fichier n’est pas un thème valide, vous avez presque certainement importé le paquet extérieur. Décompressez-le d’abord.

Pendant que vous y êtes : Boutique en ligne → Pages → Ajouter une page, nommez-la Contact et choisissez le gabarit contact — le menu par défaut y renvoie, et le thème est livré avec un formulaire de contact complet et des blocs d’information pour vos horaires et votre adresse.

2. Couleurs — la seule chose à savoir

TERROIR est un thème sombre, et les données produit reposent sur un papier écru. Cela signifie que le cuivre existe deux fois dans les réglages, et le vert-de-gris aussi :

• Accent — utilisé sur les surfaces sombres de la cave.
• Accent on paper — un cuivre plus foncé pour les surfaces claires où reposent la fiche de lot et le prix.

Ce n’est pas de la décoration. Le cuivre de la cave mesure 2,74:1 contre le papier, bien en dessous du 4,5:1 dont le texte courant a besoin pour être lisible. Si vous changez l’un, changez l’autre. Il en va de même pour Provenance et Provenance on paper.

Une autre paire mérite d’être comprise : Hairline est un séparateur décoratif qui a le droit d’être discret, tandis que Control border dessine les contours des champs et des boutons et doit rester à 3:1 contre le fond — sinon une personne malvoyante ne trouve pas le champ. Chaque valeur par défaut du thème est mesurée, et le tableau se trouve dans docs/ACCESSIBILITY.md à l’intérieur de votre paquet.

3. Métachamps — l’étape qui fait le thème

La fiche de lot, les notes de dégustation, les conseils de préparation et le bloc allergènes lisent tous des métachamps produit. Tant que vous ne les avez pas créés, ces blocs n’ont rien à afficher et restent invisibles — le thème semblera amputé de la moitié de ce que vous avez payé.

Paramètres → Données personnalisées → Produits → Ajouter une définition. Espace de noms terroir, puis la clé tirée des tableaux ci-dessous. Sous Vitrines, vérifiez que Les vitrines peuvent lire ce métachamp est activé — sans cela, le thème ne voit pas la valeur et la ligne reste vide, sans erreur pour vous dire pourquoi.

La fiche de lot

origin sert deux fois : il s’affiche au-dessus du titre du produit en vert-de-gris et sur chaque carte produit. Laissez-le vide et le thème se rabat sur le vendeur du produit.

Échelles

roast et intensity, tous deux de type Entier. Le bloc Échelle dessine une jauge cuivrée ; ajoutez-le deux fois si vous vendez à la fois du café et du vin. Le nombre de crans est un réglage de section, si bien que 3 sur une échelle à cinq crans se lit « 3/5 ».

Notes de dégustation

aroma, palate, finish, pairing, serve — tous en texte sur une ligne.

Comment préparer

method, grind, dose, water, temperature, time, ratio — tous en texte sur une ligne.

Composition et allergènes

ingredients, allergens, nutrition, storage, responsible — tous en texte multiligne.

La ligne des allergènes est toujours affichée. Si allergens est vide, le thème imprime « Aucun allergène déclaré. » plutôt que d’omettre la ligne. Une ligne absente n’est pas la même déclaration que « il n’y a rien à déclarer », et c’est précisément le champ qu’un acheteur allergique est venu lire.

Si vous vendez des denrées alimentaires dans l’UE, ce n’est pas de la décoration : le règlement 1169/2011 exige que l’information sur les allergènes soit disponible avant la conclusion de l’achat — sur la page produit, pas sur le paquet qui arrive trois jours plus tard. Rien ici n’est un conseil juridique, et le thème ne peut pas vérifier ce que vous saisissez. Ce qu’il garantit, c’est que ce que vous saisissez est affiché, clairement, avant le paiement.

Les remplir rapidement

Au-delà d’une poignée de produits, utilisez l’export CSV des produits : Shopify ajoute des colonnes de métachamps dès que les définitions existent. Exportez, remplissez les colonnes dans un tableur, réimportez. L’éditeur groupé de Shopify fonctionne aussi — Produits → tout sélectionner → Modification groupée → Ajouter des colonnes.

4. Faire de l’origine un filtre

Une fois les métachamps renseignés : Produits → Collections → Filtres → Ajouter un filtre, puis choisissez vos métachamps terroir.origin et terroir.process.

Ils apparaissent alors dans la barre latérale des pages de collection et de recherche, avec des compteurs, exactement comme le prix et la disponibilité. Les filtres fonctionnent sans JavaScript — le formulaire est soumis et la page se recharge — et passent à un rafraîchissement en direct quand il est disponible.

5. Abonnements

TERROIR s’appuie sur les plans de vente Shopify, le mécanisme d’abonnement propre à la plateforme : il fonctionne donc avec toute application qui les utilise — Shopify Subscriptions, Recharge, Seal, Appstle — et rien n’est lié à un fournisseur.

Installez votre application, créez un groupe de plans de vente, rattachez-y des produits. Il n’y a rien à configurer dans le thème. Sur tout produit doté de plans, la zone d’achat devient un ensemble de choix : achat unique au prix normal, puis une ligne par fréquence au prix du plan, avec l’économie affichée à côté.

Les affectations peuvent différer par variante : un sachet de 250 g et un sachet de 1 kg peuvent être sur des plans différents à des remises différentes — la zone d’achat suit la variante que l’acheteur sélectionne. Un produit vendu uniquement par abonnement n’a simplement pas de ligne d’achat unique.

6. Retrait en boutique

Rien à activer. Si le retrait en boutique est activé pour un emplacement (Paramètres → Expédition et livraison → Retrait en magasin), la page produit affiche la disponibilité de la variante sélectionnée, et la rafraîchit quand l’acheteur change de variante.

La disponibilité est par variante et par emplacement — un sachet de 250 g peut être en rayon quand le 1 kg ne l’est pas — c’est pourquoi elle ne peut pas être donnée une fois pour tout le produit.

7. Vérification de l’âge

Dans l’éditeur de thème, elle se trouve dans le groupe pied de page, pas dans les paramètres du thème. Activez-la et listez les pays où elle s’applique en codes ISO : FR, DE, IT. Laissez la liste vide pour l’appliquer partout. Vous choisissez combien de temps la réponse est mémorisée.

Elle se dessine par-dessus une page déjà rendue. C’est voulu : votre boutique reste indexable par les moteurs de recherche, et un visiteur dont le JavaScript a échoué ne tombe pas sur une page blanche. C’est un geste de conformité et non un contrôle de sécurité — rien derrière elle n’est protégé de quelqu’un décidé à regarder.

8. Localisateur de points de vente

Ajouter une section → Localisateur de points de vente, puis un bloc par revendeur : nom, adresse, horaires, téléphone et un lien d’itinéraire.

La carte est une image que vous téléversez, pas un service cartographique intégré. Donc aucun script tiers, aucun bandeau de consentement, aucune clé d’API à renouveler, et aucune carte qui casse à un changement de facturation. Exportez une carte depuis l’outil de votre choix et téléversez l’image.

9. Paiement

Boutons de paiement express. La page produit et le panier affichent Apple Pay, Google Pay, Shop Pay et tout autre moyen de paiement accéléré accepté par votre boutique, pour qu’un acheteur puisse payer en un geste sans créer de compte. Désactivez-les avec Afficher les boutons de paiement express dans le bloc Boutons d’achat.

Ces boutons viennent de Shopify, pas du thème : ils n’apparaissent qu’une fois les paiements accélérés activés dans Paramètres → Paiements → Shopify Payments → Gérer → Portefeuilles, chaque visiteur ne voit que les moyens pris en charge par son propre appareil, et rien ne s’affiche tant que la boutique est encore protégée par mot de passe.

Prix unitaire. Tout ce qui se vend au poids ou au volume affiche automatiquement un prix au kilo ou au litre, partout où un prix apparaît. Dans l’UE, c’est une obligation de la directive 98/6/CE. Il vient de la mesure de variante propre à Shopify — réglez-la sur la variante et le thème fait le reste.

Le paiement à vos couleurs (facultatif). Paramètres → Paiement → Personnaliser : fond #12160F, surfaces #E9E4D8, accent #C0793F.

10. Bonus : e-mail de confirmation de commande

bonus/order-confirmation.html, dans votre paquet, habille la confirmation de commande aux couleurs du thème et affiche le prix unitaire et le plan d’abonnement sur chaque ligne.

Paramètres → Notifications → Confirmation de commande → Modifier le code, puis remplacez le corps HTML par le contenu du fichier. Copiez d’abord le code existant en lieu sûr — le modèle par défaut de Shopify porte la logique de tous les types de commande que vous pourriez recevoir, et le récupérer signifie revenir au modèle par défaut.