Lumen Documentation
Documentation

Guide du thème Lumen

Lumen est un thème Online Store 2.0 conçu pour les boutiques de matériel neuf et d'occasion, avec des composants dédiés à l'état du produit, aux caractéristiques techniques et à la reprise. Ce guide couvre tout ce dont vous avez besoin, de l'installation au lancement.

Version 1.0.0 Online Store 2.0 Support : hello@digreg.dev

Aperçu

Lumen inclut toutes les sections et modèles nécessaires pour une boutique complète : accueil, collection, produit, panier, recherche, 404, pages de compte client, blog et cartes cadeaux. Chaque couleur, police et rayon d'angle est exposé comme réglage du thème : une refonte complète est possible sans toucher au code.

Les pages produit incluent un badge d'état, une étiquette de garantie, un onglet de caractéristiques techniques, un onglet éditorial « Notre avis » et une vente croisée facultative vers l'équivalent d'occasion du même produit. Le tout est piloté par des métachamps produit, décrits ci-dessous.

Démarrage rapide

Suivez ces étapes dans l'ordre après avoir installé Lumen sur votre boutique.

  1. Choisissez un style (Default, Midnight ou Editorial) dans la galerie lors de l'installation, ou changez-le ensuite (voir Styles du thème).
  2. Remplacez les textes de démonstration, images et statistiques (voir Contenu de démonstration).
  3. Créez les métachamps produit nécessaires à votre catalogue (voir Métachamps).
  4. Renseignez vos politiques légales pour que les liens du pied de page apparaissent (voir Pages légales).
  5. Facultatif : connectez une app d'avis, activez le comparateur de produits, configurez les filtres de collection.
  6. Passez une vraie commande test sur ordinateur et mobile avant la mise en ligne.

Contenu de démonstration

Chaque section contenant du texte de remplissage ou des statistiques inventées porte une note d'avertissement en haut de ses réglages dans l'éditeur de thème. Recherchez-les et remplacez le contenu avant le lancement. Ne publiez pas de nombres d'avis, témoignages ou promesses de service inventés.

  • En-tête / pied de page : nom de la boutique, slogan, adresse, informations légales/raison sociale.
  • Hero (accueil) : titre, texte, les trois chiffres statistiques (livraison, garantie, note des avis).
  • Bande d'avantages (accueil) : les trois colonnes de garanties de service.
  • Témoignages (accueil) : noms, citations et notes sont des exemples fictifs.
  • Reprise (accueil) : délais et détails du service de reprise.
Astuce. Les champs propres de spécification/description du thème (custom.specs_text, citation et corps de l'avis) acceptent du texte brut, pas du JSON (voir Métachamps pour le format exact à utiliser dans votre catalogue).

Métachamps

Créez ces métachamps dans Admin → Paramètres → Données personnalisées → Produits, avec les clés exactes ci-dessous (espace de noms custom). Le thème les lit déjà sous ces noms. Si un métachamp manque, la section qui l'utilise reste simplement masquée : comportement attendu, pas une erreur.

CléTypeUsage
custom.condizioneTexte sur une ligneBadge d'état sur la carte et la page produit, ex. « Occasion · A- », « Neuf scellé ».
custom.nota_statoTexte sur une lignePremière ligne des métadonnées de la carte, ex. « 12 400 déclenchements », « Scellé ».
custom.innestoTexte sur une ligneMonture (RF, E, Z, X, L, M), utilisé aussi comme valeur pour le filtre de collection « Monture ».
custom.garanzia_labelTexte sur une ligneBadge de garantie sur la page produit.
custom.ratingTexte sur une ligneNote affichée dans les métadonnées produit, ex. « 4,9 ».
custom.review_countNombre entierNombre d'avis statique, affiché tant qu'aucun bloc d'app n'est ajouté (voir Avis produit).
custom.usato_correlatoRéférence produitRelie une fiche neuve à son équivalent d'occasion, pour l'encart « Aussi disponible d'occasion ».
custom.specs_textTexte multiligneTableau des caractéristiques. Une ligne par caractéristique, format Libellé : Valeur, par exemple Capteur : CMOS plein format, 24 MP. Texte brut, pas du JSON : modifiable à la main ou via import CSV.
custom.verdict_quoteTexte sur une ligneCourte citation dans l'onglet « Notre avis ». Si vide, l'onglet n'apparaît pas.
custom.verdict_bodyTexte multiligneTexte complet de l'avis, sous la citation.
Pourquoi du texte brut pour les caractéristiques ? Les versions précédentes du thème utilisaient un métachamp JSON. Il a été remplacé par un format simple ligne par ligne Libellé : Valeur afin que l'équipe de la boutique puisse modifier les caractéristiques directement depuis l'admin Shopify sans écrire de JSON.

Styles du thème

Lumen inclut trois styles prêts à l'emploi. Choisissez-en un dans la galerie de styles lors du premier ajout du thème, ou appliquez-en un autre plus tard depuis les préréglages enregistrés de l'éditeur de thème.

Default

Look chaleureux et éditorial, inspiration heritage. Playfair Display + Inter, angles droits.

Midnight

Look sombre façon studio. Fraunces + Work Sans, angles adoucis.

Editorial

Look clair, moderne, sans-serif. Work Sans + Inter, angles arrondis.

Chaque couleur, les trois polices, la largeur du conteneur et le rayon des angles sont modifiables individuellement dans les réglages du thème. Un style n'est qu'un point de départ, pas une contrainte.

Avis produit

L'onglet « Avis » de la page produit affiche un nombre statique issu de custom.review_count (ou un message « aucun avis ») tant qu'aucune app d'avis n'est connectée. Pour passer à de vrais avis : installez une app (Judge.me, Loox, Ryviu, etc.), puis ajoutez son bloc d'app à la section Product tabs dans l'éditeur de thème. Une fois le bloc d'app présent, il est prioritaire et le nombre statique n'est plus affiché.

Comparateur de produits

Une fonction facultative de comparaison côte à côte (icône sur les cartes et la page produit, barre de comparaison, page dédiée) est désactivée par défaut et ne nécessite aucun métachamp.

  1. Réglages du thème → Product comparison → activez Enable product comparison.
  2. Créez une page avec le modèle page.compare.
  3. Sélectionnez cette page dans le réglage Compare page.

L'état de la sélection est stocké dans le navigateur du visiteur (localStorage) ; aucun backend ni métachamp n'est impliqué.

Filtres de collection

Les filtres « État » et « Monture » dans la barre latérale de collection sont rendus génériquement à partir de l'objet natif collection.filters de Shopify. Pour qu'ils apparaissent, configurez des filtres produit dans l'app Search & Discovery en vous basant sur custom.innesto et une étiquette ou un métachamp d'état de votre choix.

Langues

Les chaînes d'interface de la boutique (boutons, libellés, panier, recherche, compte, carte cadeau) sont fournies traduites en quatre langues : italien (par défaut), anglais, espagnol et français. Activez celles dont vous avez besoin dans Admin → Paramètres → Langues.

Les libellés de l'éditeur de thème lui-même (noms de sections et de réglages) sont également traduits dans ces quatre langues : un marchand avec un admin en italien, anglais, espagnol ou français voit un éditeur traduit, pas seulement une boutique traduite.

Le contenu que vous saisissez dans l'éditeur de thème (textes du hero, blocs, métachamps) n'est pas couvert par ces fichiers. Traduisez-le avec l'app native Shopify Translate & Adapt, qui détecte automatiquement le contenu des sections, blocs et métachamps.

Pour ajouter une autre langue : dupliquez les fichiers de langue correspondants (interface et, si nécessaire, libellés de l'éditeur) avec le bon code ISO et traduisez chaque clé.

Limites connues

  • Les états de survol suivent une règle cohérente dans tout le thème (éclaircissement d'environ 8 % / passage à la teinte accent-bright) plutôt que d'être dirigés artistiquement composant par composant.
  • Les filtres de collection (État / Monture) ne se remplissent qu'une fois Search & Discovery configuré. Le thème affiche ce que fournit cette app.
  • L'onglet avis affiche un nombre statique tant qu'aucun bloc d'app n'est ajouté, comme décrit ci-dessus.
  • Les liens légaux du pied de page dépendent des politiques renseignées dans Admin → Paramètres → Politiques ; en attendant, ils restent masqués plutôt que rompus.

FAQ

Puis-je changer de style après avoir installé le thème ?

Oui. Dupliquez le thème publié, réappliquez un préréglage différent depuis l'éditeur de thème, vérifiez puis publiez quand vous êtes prêt.

Que se passe-t-il si je ne crée pas les métachamps produit ?

Rien ne casse. Toute section dépendant d'un métachamp manquant est simplement ignorée ou affichée vide. Aucune erreur sur la boutique.

Ai-je besoin du comparateur de produits ?

Non, il est facultatif et désactivé par défaut. Activez-le seulement si vous souhaitez proposer une comparaison côte à côte.

Puis-je ajouter une langue en plus de l'italien, l'anglais, l'espagnol et le français ?

Oui, dupliquez les fichiers de langue concernés avec le nouveau code ISO et traduisez chaque clé, à la fois pour la boutique et pour les libellés de l'éditeur de thème.

Support

Pour toute question non couverte par ce guide, écrivez à hello@digreg.dev.