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.
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.
- Choisissez un style (Default, Midnight ou Editorial) dans la galerie lors de l'installation, ou changez-le ensuite (voir Styles du thème).
- Remplacez les textes de démonstration, images et statistiques (voir Contenu de démonstration).
- Créez les métachamps produit nécessaires à votre catalogue (voir Métachamps).
- Renseignez vos politiques légales pour que les liens du pied de page apparaissent (voir Pages légales).
- Facultatif : connectez une app d'avis, activez le comparateur de produits, configurez les filtres de collection.
- 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.
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é | Type | Usage |
|---|---|---|
custom.condizione | Texte sur une ligne | Badge d'état sur la carte et la page produit, ex. « Occasion · A- », « Neuf scellé ». |
custom.nota_stato | Texte sur une ligne | Première ligne des métadonnées de la carte, ex. « 12 400 déclenchements », « Scellé ». |
custom.innesto | Texte sur une ligne | Monture (RF, E, Z, X, L, M), utilisé aussi comme valeur pour le filtre de collection « Monture ». |
custom.garanzia_label | Texte sur une ligne | Badge de garantie sur la page produit. |
custom.rating | Texte sur une ligne | Note affichée dans les métadonnées produit, ex. « 4,9 ». |
custom.review_count | Nombre entier | Nombre d'avis statique, affiché tant qu'aucun bloc d'app n'est ajouté (voir Avis produit). |
custom.usato_correlato | Référence produit | Relie une fiche neuve à son équivalent d'occasion, pour l'encart « Aussi disponible d'occasion ». |
custom.specs_text | Texte multiligne | Tableau 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_quote | Texte sur une ligne | Courte citation dans l'onglet « Notre avis ». Si vide, l'onglet n'apparaît pas. |
custom.verdict_body | Texte multiligne | Texte complet de l'avis, sous la citation. |
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.
- Réglages du thème → Product comparison → activez
Enable product comparison. - Créez une page avec le modèle
page.compare. - 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.
Pages légales
Les liens du pied de page ne s'affichent que si la politique correspondante existe, il n'y a donc jamais de lien mort :
- Confidentialité / Conditions : lus depuis
shop.privacy_policy/shop.terms_of_service. Renseignez-les dans Admin → Paramètres → Politiques. - Politique de cookies : facultative, basée sur une page avec le handle
cookie(Shopify n'a pas d'objet natif pour la politique de cookies).
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.