Configurazione di metafield e metaoggetti

Le funzioni per l'arredamento di Tenora leggono i dati prodotto da metafield e metaoggetti. Questa pagina ti mostra come crearli, passo dopo passo, con i nomi e i tipi esatti che il tema si aspetta.

• Un metafield è un campo aggiuntivo di un prodotto, ad esempio "Larghezza".
• Un metaoggetto è una voce riutilizzabile con campi propri, ad esempio un materiale chiamato "Rovere massello" con un'immagine e le istruzioni per la cura.

Configuri le definizioni una sola volta. Poi compili i valori per ogni prodotto.

Prima di iniziare

• Scrivi ogni namespace e chiave esattamente come indicato, in minuscolo e con i trattini bassi. Il tema legge proprio questi nomi. Una piccola differenza, come specs.Width o spec.width, impedisce al tema di trovare il valore.
• Crea prima la definizione del metaoggetto "Material". Il metafield specs.materials ne ha bisogno.
• Se un valore è vuoto, il blocco corrispondente resta nascosto nella pagina prodotto. Puoi completare i prodotti un po' alla volta.

Funzione	Metafield letti
Dimensioni	specs.width, specs.depth, specs.height, specs.seat_height, specs.weight
Ci starà?	specs.width, specs.depth, specs.height (sono necessari tutti e tre)
Materiali e cura	specs.materials e il metaoggetto "Material"
Ordina un campione	specs.sample_product (o l'impostazione Prodotto campione del blocco)
Consegna e montaggio	delivery.lead_time, delivery.method, delivery.assembly_required, delivery.assembly_guide

Controlla prima il sistema di unità del negozio

I metafield di dimensione e peso usano come unità predefinita il sistema di unità del negozio.

1. Nel pannello di controllo Shopify, vai su Impostazioni (Settings) → Generali (General).
2. Trova Impostazioni predefinite del negozio (Store defaults) → Sistema di unità (Unit system).
3. Controlla se è impostato sul sistema metrico o su quello imperiale.

Se il negozio usa il sistema imperiale, il pannello di controllo seleziona per impostazione predefinita pollici e once. Un valore che scrivi come 220 viene quindi salvato come 220 in, a meno che tu non cambi l'unità accanto al campo. Il tema converte correttamente le unità, ma i numeri non saranno quelli che intendevi.

Suggerimento: controlla sempre l'unità accanto al valore prima di salvare un prodotto.

Il blocco Dimensioni mostra sempre centimetri e pollici, e chilogrammi e libbre, qualunque sia l'unità supportata che hai usato nel pannello di controllo (mm, cm, m, in, ft o yd per le lunghezze; g, kg, lb o oz per il peso). I clienti possono cambiare unità e la loro scelta viene memorizzata sul loro dispositivo.

Passaggio 1: crea la definizione del metaoggetto "Material"

1. Nel pannello di controllo Shopify, vai su Impostazioni → Dati personalizzati (Custom data).

2. In Metaoggetti (Metaobjects), seleziona Aggiungi definizione (Add definition).

3. Inserisci il Nome: Material.

4. Controlla il Tipo. Shopify lo compila a partire dal nome. Deve essere esattamente material.

5. Seleziona Aggiungi campo (Add field) e aggiungi questi quattro campi:

   Nome del campo	Chiave	Tipo	Opzioni
   Nome	name	Testo a riga singola (Single line text)	Contrassegna come obbligatorio
   Immagine	image	File, con solo Immagini consentite	Un file
   Descrizione	description	Testo a più righe (Multi-line text)
   Istruzioni per la cura	care_instructions	Testo a più righe

   Shopify compila la chiave a partire dal nome del campo: controlla che corrisponda esattamente alla colonna Chiave.

6. Nelle opzioni di accesso, attiva l'accesso Vetrine (Storefronts). Senza questo accesso il tema non può leggere il materiale.

7. Lascia disattivata l'opzione Stato attivo-bozza (Active-draft status). Se la attivi, devi impostare ogni voce di materiale su Attivo (Active), altrimenti non comparirà nel negozio.

8. Facoltativo: imposta Nome come nome visualizzato, così le voci sono facili da trovare negli elenchi.

9. Seleziona Salva.

Passaggio 2: aggiungi i materiali

1. Nel pannello di controllo Shopify, vai su Contenuti (Content) → Metaoggetti.

2. Seleziona Material.

3. Seleziona Aggiungi voce (Add entry).

4. Compila i campi. Ad esempio:

   Nome	Descrizione	Istruzioni per la cura
   Rovere massello	Rovere europeo certificato FSC con finitura a olio naturale.	Pulire con un panno morbido e asciutto. Trattare con olio una volta l'anno. Evitare fonti di calore dirette.
   Misto lino	55% lino, 45% cotone. Fodere sfoderabili e prelavate.	Le fodere si possono lavare a 30°C. Asciugare all'aria e stirare ancora umide.
   Rattan naturale	Rattan intrecciato a mano su telaio in legno massello.	Spolverare con una spazzola morbida. Tenere lontano da termosifoni e luce solare diretta.

5. Aggiungi un'Immagine per ogni materiale, ad esempio un primo piano del legno o del tessuto. Un'immagine quadrata è l'ideale.

6. Seleziona Salva.

Suggerimenti

• Con il layout Schede, il blocco mostra solo la prima frase della descrizione. Metti le informazioni più importanti nella prima frase.
• Gli a capo nella descrizione e nelle istruzioni per la cura vengono mantenuti.
• Un materiale senza nome non viene mostrato.

Passaggio 3: crea le definizioni dei metafield prodotto

1. Nel pannello di controllo Shopify, vai su Impostazioni → Dati personalizzati.
2. In Metafield (Metafields), seleziona Prodotti (Products).
3. Seleziona Aggiungi definizione.
4. Inserisci il Nome, poi inserisci Namespace e chiave (Namespace and key) esattamente come indicato qui sotto, con il punto (ad esempio specs.width).
5. Seleziona il Tipo e le opzioni indicate nella tabella.
6. Assicurati che l'accesso Vetrine sia attivo. Di solito è attivo per impostazione predefinita.
7. Seleziona Salva.
8. Ripeti per ogni riga della tabella.

Nome	Namespace e chiave	Tipo	Opzioni
Larghezza	specs.width	Dimensione (Dimension)	Un valore
Profondità	specs.depth	Dimensione	Un valore
Altezza	specs.height	Dimensione	Un valore
Altezza seduta	specs.seat_height	Dimensione	Un valore
Peso	specs.weight	Peso (Weight)	Un valore
Materiali	specs.materials	Metaoggetto (Metaobject), poi seleziona Material	Elenco di voci (List of entries)
Prodotto campione	specs.sample_product	Prodotto (Product)	Un prodotto
Tempi di consegna	delivery.lead_time	Testo a riga singola	Un valore
Modalità di consegna	delivery.method	Testo a riga singola	Un valore. Facoltativo: Limita alle scelte predefinite (Limit to preset choices), ad esempio Standard delivery, White-glove delivery, Flat-pack delivery
Montaggio richiesto	delivery.assembly_required	Vero o falso (True or false)
Istruzioni di montaggio	delivery.assembly_guide	File	Consenti i file PDF (o tutti i tipi di file)

Note

• specs.materials può anche essere una voce singola (Una voce, One entry) invece di un elenco. Il tema supporta entrambe le opzioni. Ti consigliamo un elenco, così un prodotto può avere più materiali.
• I nomi della colonna Nome vengono mostrati solo nel pannello di controllo. Puoi tradurli o cambiarli. Namespace e chiave devono restare esattamente come indicato.
• Suggerimento: quando crei una definizione, attiva Fissa nelle pagine prodotto (Pin to product pages). I campi compariranno direttamente in ogni pagina prodotto del pannello di controllo.

Passaggio 4: compila i prodotti

1. Nel pannello di controllo Shopify, vai su Prodotti e apri un prodotto.

2. Scorri fino a Metafield.

3. Compila i campi di questo prodotto. Ad esempio, per un divano:

   Metafield	Valore di esempio
   Larghezza	220 cm
   Profondità	95 cm
   Altezza	82 cm
   Altezza seduta	44 cm
   Peso	68 kg
   Materiali	Rovere massello, Misto lino
   Prodotto campione	Set di campioni di tessuto
   Tempi di consegna	Realizzato su ordinazione, spedito in 6–8 settimane
   Modalità di consegna	Consegna al piano con installazione
   Montaggio richiesto	Falso
   Istruzioni di montaggio	Un file PDF

4. Prima di salvare, controlla l'unità di ogni dimensione e del peso.

5. Seleziona Salva.

6. Apri il prodotto nel negozio online e controlla i blocchi Dimensioni, Materiali e cura, Ordina un campione e Consegna e montaggio.

Cosa succede con dati parziali

Non devi compilare tutti i campi. Ad esempio, se un prodotto ha solo larghezza, altezza e tempi di consegna:

• La tabella delle dimensioni mostra solo larghezza e altezza.
• Il disegno viene mostrato, perché richiede solo larghezza e altezza.
• "Ci starà?" resta nascosto, perché richiede anche la profondità.
• I blocchi Materiali e cura e Ordina un campione restano nascosti (a meno che nel blocco Ordina un campione non sia impostato un Prodotto campione nell'editor del tema).
• Il blocco Consegna e montaggio mostra solo i tempi di consegna.

Importare i valori dei metafield con un file CSV

Se hai molti prodotti, puoi compilare i metafield con l'importazione CSV dei prodotti di Shopify. Crea le definizioni dei metafield (passaggio 3) prima di esportare o importare. Il CSV avrà così una colonna per ogni definizione.

1. Nel pannello di controllo Shopify, vai su Prodotti e seleziona Esporta (Export) per ottenere un file CSV con i prodotti attuali.

2. Apri il file in un programma per fogli di calcolo. Trova le colonne dei metafield. I loro nomi includono namespace e chiave, ad esempio:

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

3. Compila i valori:

   Colonna	Valore di esempio	Nota
   Larghezza, Profondità, Altezza, Altezza seduta	180cm	Un numero e un'unità
   Peso	58 kg	Un numero e un'unità
   Materiali	solid-oak; linen-blend	Gli handle delle voci di materiale, separati da un punto e virgola e uno spazio
   Tempi di consegna	Made to order, ships in 6–8 weeks	Testo semplice
   Montaggio richiesto	TRUE o FALSE

4. Salva il file in formato CSV (UTF-8).

5. In Prodotti, seleziona Importa (Import), scegli il file e segui i passaggi.

6. Dopo l'importazione, apri alcuni prodotti e controlla valori e unità.

Suggerimenti

• Importa prima un piccolo file di prova con due o tre prodotti.
• L'handle di un materiale è indicato nella voce del materiale in Contenuti → Metaoggetti → Material. Di solito è il nome in minuscolo con i trattini, ad esempio solid-oak.
• Includi sempre l'unità nei valori di dimensione e peso. Senza unità, il valore potrebbe essere letto nell'unità predefinita del negozio.

Tradurre i dati prodotto

Se il negozio ha più lingue, traduci i valori di testo (materiali, tempi di consegna e modalità di consegna) con gli strumenti di traduzione di Shopify, come fai per le descrizioni dei prodotti. Le etichette aggiunte dal tema, come "Larghezza", "Cura" e "Montaggio parziale richiesto", sono già tradotte. Consulta Vendere a livello internazionale.

Risoluzione dei problemi

Problema	Cosa controllare
Un blocco non compare	Namespace e chiave sono esattamente come indicato, l'accesso Vetrine è attivo e il prodotto ha un valore. Il blocco si trova anche nel modello di prodotto usato dal prodotto.
I materiali non compaiono	La voce del materiale ha un Nome. Se la definizione usa lo Stato attivo-bozza, la voce è impostata su Attivo.
Le misure sono sbagliate	L'unità accanto a ogni valore. Controlla il sistema di unità del negozio.
"Ci starà?" non compare	Larghezza, profondità e altezza hanno tutte un valore e Mostra lo strumento per le misure è attivo nel blocco Dimensioni.
Il campione non compare	Il prodotto campione è attivo e disponibile nel canale di vendita Negozio online. Il campione non è il prodotto stesso.

Per altro aiuto, consulta le Domande frequenti.