Metavelden in sjablonen

Metavelden zijn aangepaste gegevens die jij of je apps in Shopify opslaan: een cadeaubericht bij een bestelling, een wasvoorschrift bij een product, het klantnummer van een klant. Sjablonen kunnen ze printen met Liquid. Het tabblad Metavelden in de code-editor toont de syntaxis voor elk soort.

Voordat je begint: controleer welke metavelden Foliant laadt

Foliant laadt metavelden samen met de bestelling, en kan ze niet allemaal laden. Zo werkt het:

Je winkel heeft minstens één metavelddefinitie nodig (in de Shopify-beheeromgeving, Instellingen › Aangepaste data). Zonder definitie worden er geen metavelden geladen.
Voor elk soort (bestellingen, conceptbestellingen, klanten, producten en varianten) laadt Foliant de definities die je hebt vastgezet, tot 10 per soort, in de volgorde waarin ze zijn vastgezet.
Heeft een soort geen vastgezette definities, dan laadt Foliant de eerste 10 metavelden die het ervoor vindt.

Wil je zeker weten dat een metaveld wordt geprint? Geef het dan een definitie en zet het vast in Instellingen › Aangepaste data. Het kan tot een uur duren voordat wijzigingen in definities zichtbaar zijn in documenten.

Een metaveld printen

Vervang namespace en key door de namespace en key van je metaveld (bijvoorbeeld custom.gift_message):

Metaveld van	Liquid
De bestelling of conceptbestelling	`{{ order.metafields.namespace.key }}`
De klant	`{{ customer.metafields.namespace.key }}`
Een product	`{{ line_item.product.metafields.namespace.key }}`
Een variant	`{{ line_item.variant.metafields.namespace.key }}`

Metavelden van producten en varianten gelden per artikel. Gebruik ze daarom binnen de loop van de artikelregels:

{% for line_item in line_items %}
  {{ line_item.title }}
  {% if line_item.product.metafields.custom.care_instructions != blank %}
    <br>{{ line_item.product.metafields.custom.care_instructions }}
  {% endif %}
{% endfor %}

Hoe metaveldtypen worden geprint

Type	Wat je krijgt
Tekst, URL, datum, kleur…	De waarde als tekst
Geheel getal, decimaal getal	Een getal waarmee je kunt vergelijken of rekenen
Waar of onwaar	`true` of `false`, voor `{% if %}`
Rich text	De tekst, zonder opmaak
Gewicht, afmeting, volume	`.value` en `.unit`, bijvoorbeeld `{{ … .weight.value }} {{ … .weight.unit }}`
Geld	`.value` (zoals `23.00`) en `.unit` (de valutacode). Niet in centen.
Beoordeling	`.value`, `.scale_min` en `.scale_max`
JSON, lijsten	Een lijst of object waar je met een loop doorheen kunt gaan

Goed om te weten

Een leeg of ontbrekend metaveld print niets. Gebruik != blank om het bijbehorende label weg te laten.
In visuele sjablonen print je metavelden met een blok Aangepaste Liquid.
Picklijsten kunnen metavelden van producten of varianten als kolommen tonen, via de instellingen voor Picklijst van het sjabloon.

Welkom

Aan de slag

Afdrukken

Sjablonen

Sjablooneditor

Ontwerpen

PDF-levering

E-mailtemplates

Klantaccounts

Exports

Facturen en nummering

Belasting en juridisch

Integraties

Facturering en abonnementen

Instellingen

Problemen oplossen

Juridisch

Voordat je begint: controleer welke metavelden Foliant laadt

Een metaveld printen

Hoe metaveldtypen worden geprint

Goed om te weten

Gerelateerde artikelen