Guida al tema Lumen
Lumen è un tema Online Store 2.0 pensato per negozi di attrezzatura nuova e usata, con componenti dedicati a condizione prodotto, specifiche tecniche e permuta. Questa guida copre tutto il necessario, dall'installazione al lancio.
Panoramica
Lumen include tutte le sezioni e i template per gestire uno storefront completo: home, collezione, prodotto, carrello, ricerca, 404, pagine account cliente, blog e gift card. Ogni colore, font e raggio degli angoli è esposto come impostazione del tema: è possibile un intero re-styling senza toccare il codice.
Le pagine prodotto includono un badge di condizione, un'etichetta di garanzia, un tab con le specifiche tecniche, un tab editoriale "Il nostro giudizio" e un cross-sell opzionale verso l'equivalente usato dello stesso prodotto. Tutto è gestito tramite metafield prodotto, descritti più sotto.
Avvio rapido
Segui questi passaggi in ordine dopo aver installato Lumen sul tuo negozio.
- Scegli uno stile (Default, Midnight o Editorial) dalla galleria al momento dell'installazione, oppure cambialo in seguito (vedi Stili del tema).
- Sostituisci testi demo, immagini e statistiche (vedi Contenuti demo).
- Crea i metafield prodotto necessari al tuo catalogo (vedi Metafield).
- Compila le tue policy legali perché i link in footer compaiano (vedi Pagine legali).
- Facoltativo: collega un'app di recensioni, attiva il confronto prodotti, configura i filtri collezione.
- Effettua un ordine di prova reale su desktop e mobile prima di andare live.
Contenuti demo
Ogni sezione con testi placeholder o statistiche inventate ha una nota di avviso in cima alle sue impostazioni nel Theme Editor. Cercale e sostituisci i contenuti prima del lancio. Non pubblicare conteggi recensioni, testimonianze o claim di servizio inventati.
- Header / footer: nome negozio, tagline, indirizzo, dati legali/ragione sociale.
- Hero (home): titolo, testo, i tre numeri statistica (spedizione, garanzia, punteggio recensioni).
- Benefits band (home): le tre colonne di garanzie di servizio.
- Testimonials (home): nomi, citazioni e valutazioni sono placeholder.
- Trade-in (home): tempi e dettagli del servizio di permuta.
custom.specs_text, citazione e corpo del giudizio) accettano testo semplice, non JSON (vedi Metafield per il formato esatto da usare nel catalogo).Metafield
Crea questi metafield in Admin → Impostazioni → Dati personalizzati → Prodotti, con le chiavi esatte sotto (namespace custom). Il tema li legge già con questi nomi. Se un metafield manca, la sezione che lo usa resta semplicemente nascosta: comportamento previsto, non un errore.
| Chiave | Tipo | Uso |
|---|---|---|
custom.condizione | Testo a riga singola | Badge condizione su card e pagina prodotto, es. "Usato · A-", "Nuovo sigillato". |
custom.nota_stato | Testo a riga singola | Prima riga della meta card, es. "12.400 scatti", "Sigillato". |
custom.innesto | Testo a riga singola | Innesto (RF, E, Z, X, L, M), usato anche come valore per il filtro collezione "Innesto". |
custom.garanzia_label | Testo a riga singola | Badge garanzia sulla pagina prodotto. |
custom.rating | Testo a riga singola | Valutazione mostrata nella meta prodotto, es. "4,9". |
custom.review_count | Numero intero | Conteggio recensioni statico, mostrato finché non si aggiunge un blocco app (vedi Recensioni prodotto). |
custom.usato_correlato | Riferimento a prodotto | Collega un annuncio nuovo al suo equivalente usato, per il box "Disponibile anche usato". |
custom.specs_text | Testo su più righe | Tabella specifiche. Una riga per specifica, formato Etichetta: Valore, ad esempio Sensore: CMOS full-frame, 24 MP. Testo semplice, non JSON: editabile a mano o via import CSV. |
custom.verdict_quote | Testo a riga singola | Citazione breve nel tab "Il nostro giudizio". Se vuota, il tab non appare. |
custom.verdict_body | Testo su più righe | Testo completo del giudizio, sotto la citazione. |
Etichetta: Valore così lo staff del negozio può modificare le specifiche direttamente dall'Admin Shopify senza scrivere JSON.Stili del tema
Lumen include tre stili predefiniti pronti all'uso. Scegline uno dalla galleria stili quando aggiungi il tema per la prima volta, oppure applicane uno diverso in seguito dai preset salvati nel Theme Editor.
Default
Look caldo ed editoriale, ispirazione heritage. Playfair Display + Inter, angoli squadrati.
Midnight
Look scuro da studio. Fraunces + Work Sans, angoli morbidi.
Editorial
Look chiaro, moderno, sans-serif. Work Sans + Inter, angoli arrotondati.
Ogni colore, i tre font, la larghezza del contenitore e il raggio degli angoli sono modificabili singolarmente in Impostazioni tema. Uno stile è solo un punto di partenza, non un vincolo.
Recensioni prodotto
Il tab "Recensioni" sulla pagina prodotto mostra un conteggio statico da custom.review_count (o un messaggio "nessuna recensione") finché non colleghi un'app di recensioni. Per passare a recensioni reali: installa un'app (Judge.me, Loox, Ryviu, ecc.), poi aggiungi il suo blocco app alla sezione Product tabs nel Theme Editor. Una volta presente il blocco app, ha priorità e il conteggio statico non viene più mostrato.
Confronto prodotti
Una funzione opzionale di confronto affiancato (icona su card e pagina prodotto, barra di confronto, pagina dedicata) è disattivata di default e non richiede metafield.
- Impostazioni tema → Product comparison → attiva
Enable product comparison. - Crea una pagina con template
page.compare. - Seleziona quella pagina nell'impostazione
Compare page.
Lo stato della selezione è salvato nel browser del visitatore (localStorage); nessun backend né metafield coinvolti.
Filtri collezione
I filtri "Condizione" e "Innesto" nella sidebar collezione sono renderizzati genericamente dall'oggetto nativo collection.filters di Shopify. Per farli comparire, configura i filtri prodotto nell'app Search & Discovery basandoti su custom.innesto e su un tag o metafield di condizione a tua scelta.
Pagine legali
I link in footer compaiono solo se la relativa policy esiste, quindi non ci sono mai link morti:
- Privacy / Termini: letti da
shop.privacy_policy/shop.terms_of_service. Compilali in Admin → Impostazioni → Norme. - Cookie policy: opzionale, basata su una pagina con handle
cookie(Shopify non ha un oggetto nativo per la cookie policy).
Lingue
Le stringhe di interfaccia dello storefront (bottoni, label, carrello, ricerca, account, gift card) sono incluse tradotte in quattro lingue: italiano (default), inglese, spagnolo e francese. Attiva quelle che ti servono in Admin → Impostazioni → Lingue.
Anche le etichette del Theme Editor stesso (nomi di sezioni e impostazioni) sono tradotte nelle stesse quattro lingue: un merchant con Admin in italiano, inglese, spagnolo o francese vede un editor tradotto, non solo uno storefront tradotto.
I contenuti inseriti nel Theme Editor (testi hero, blocchi, metafield) non passano da questi file. Traducili con l'app nativa Shopify Translate & Adapt, che intercetta automaticamente contenuti di sezione, blocco e metafield.
Per aggiungere un'altra lingua: duplica i file di lingua corrispondenti (interfaccia e, se necessario, etichette editor) con il codice ISO corretto e traduci ogni chiave.
Limiti noti
- Gli stati hover seguono una regola coerente in tutto il tema (schiarimento ~8% / passaggio al tono accento-bright) invece di essere art-direzionati singolarmente per componente.
- I filtri collezione (Condizione / Innesto) si popolano solo dopo aver configurato Search & Discovery. Il tema renderizza ciò che l'app fornisce.
- Il tab recensioni mostra un conteggio statico finché non si aggiunge un blocco app, come descritto sopra.
- I link legali in footer dipendono dalle policy compilate in Admin → Impostazioni → Norme; finché non lo sono, restano nascosti anziché rotti.
FAQ
Posso cambiare stile dopo aver installato il tema?
Sì. Duplica il tema pubblicato, riapplica un preset diverso dal Theme Editor, verifica e pubblica quando pronto.
Cosa succede se non creo i metafield prodotto?
Niente si rompe. Ogni sezione che dipende da un metafield mancante viene semplicemente saltata o mostrata vuota. Nessun errore sullo storefront.
Mi serve la funzione di confronto prodotti?
No, è opzionale e disattivata di default. Attivala solo se vuoi offrire un confronto affiancato.
Posso aggiungere una lingua oltre a italiano, inglese, spagnolo e francese?
Sì, duplica i file di lingua interessati con il nuovo codice ISO e traduci ogni chiave, sia per lo storefront sia per le etichette del Theme Editor.
Supporto
Per domande non coperte da questa guida, scrivi a hello@digreg.dev.