Metafield e metaobject Shopify: campi personalizzati senza app

Metafield e metaobject: la differenza in una frase

Creare una definizione di metafield

1. nell’admin vai in Impostazioni > Metafield e metaobject (in alcuni negozi la voce si chiama ancora “Dati personalizzati”) e scegli Prodotti;
2. clicca Aggiungi definizione e scrivi un nome, per esempio “Materiale”;
3. Shopify genera l’identificativo custom.materiale: custom è lo spazio dei nomi (namespace), materiale la chiave;
4. scegli il tipo: per il materiale va bene “Testo su una riga”; se i valori sono più di uno, passa da “Un valore” a “Elenco di valori”;
5. salva.

Mostrarlo senza codice: le origini dinamiche

1. apri Personalizza sul tema e vai su un modello prodotto;
2. nella sezione delle informazioni prodotto aggiungi un blocco, per esempio Testo;
3. accanto al campo del testo clicca l’icona “Collega origine dinamica” e scegli il metafield “Materiale”;
4. salva: ogni prodotto mostrerà il suo materiale, e i prodotti senza valore non mostreranno niente.

Mostrarlo con Liquid

Testo e numeri

{%- assign materiale = product.metafields.custom.materiale.value -%}
{%- if materiale != blank -%}
  <p class="scheda__riga">Materiale: {{ materiale | escape }}</p>
{%- endif -%}

{{ product.metafields.custom.istruzioni | metafield_tag }}

Liste

{%- assign ingredienti = product.metafields.custom.ingredienti.value -%}
{%- if ingredienti != blank -%}
  <ul class="ingredienti">
    {%- for ingrediente in ingredienti -%}
      <li>{{ ingrediente | escape }}</li>
    {%- endfor -%}
  </ul>
{%- endif -%}

Riferimenti a metaobject

Esempio completo: tabella taglie riutilizzabile

1. Metaobject “Riga taglia” (tipo riga_taglia) con tre campi di testo su una riga: taglia, torace, vita;
2. Metaobject “Tabella taglie” (tipo tabella_taglie) con due campi: titolo (testo) e righe (elenco di riferimenti a “Riga taglia”);
3. in Contenuti > Metaobject crei le voci: prima le righe (S, M, L…), poi la tabella “Maglie uomo” che le elenca in ordine;
4. crei un metafield prodotto “Tabella taglie” di tipo Metaobject, collegato a “Tabella taglie”: identificativo custom.tabella_taglie;
5. su ogni prodotto scegli la tabella giusta dal menu del metafield.

{%- assign tabella = product.metafields.custom.tabella_taglie.value -%}
{%- if tabella -%}
  <table class="tabella-taglie">
    <caption>{{ tabella.titolo.value | escape }}</caption>
    <tr><th>Taglia</th><th>Torace (cm)</th><th>Vita (cm)</th></tr>
    {%- for riga in tabella.righe.value -%}
      <tr>
        <th scope="row">{{ riga.taglia.value | escape }}</th>
        <td>{{ riga.torace.value | escape }}</td>
        <td>{{ riga.vita.value | escape }}</td>
      </tr>
    {%- endfor -%}
  </table>
{%- endif -%}

Errori comuni

• Namespace o chiave sbagliati: custom.materiale non è custom.Materiale. Copia l’identificativo dalla definizione, non riscriverlo a memoria.
• Manca .value: senza, su molti tipi ottieni l’oggetto e non il contenuto.
• Elenco trattato come valore singolo: se il tipo è “Elenco di valori”, serve un ciclo for (o metafield_tag).
• Valori vuoti non gestiti: senza il controllo != blank restano etichette senza contenuto.
• Voci di metaobject in bozza: se il metaobject prevede lo stato attivo/bozza, una voce in bozza in Liquid risulta vuota.
• Modifiche sul tema pubblicato: anche qui, si lavora su una copia del tema.

Domande frequenti

Conclusione