Metafelder in Vorlagen

Metafelder sind benutzerdefinierte Daten, die Sie oder Ihre Apps in Shopify speichern: eine Geschenknachricht zu einer Bestellung, ein Pflegehinweis zu einem Produkt, die Kontonummer eines Kunden. Vorlagen können sie mit Liquid drucken. Der Tab Metafelder im Code-Editor zeigt die Syntax für jede Art.

Bevor Sie beginnen: Prüfen Sie, welche Metafelder Foliant lädt

Foliant lädt Metafelder zusammen mit der Bestellung, kann aber nicht alle laden. So funktioniert es:

Ihr Shop benötigt mindestens eine Metafeld-Definition (im Shopify-Adminbereich unter Einstellungen › Benutzerdefinierte Daten). Ohne Definition werden keine Metafelder geladen.
Für jede Art (Bestellungen, Bestellentwürfe, Kunden, Produkte und Varianten) lädt Foliant die Definitionen, die Sie angeheftet haben, bis zu 10 pro Art, in der angehefteten Reihenfolge.
Hat eine Art keine angehefteten Definitionen, lädt Foliant die ersten 10 Metafelder, die es dafür findet.

Damit ein Metafeld sicher gedruckt wird, legen Sie also eine Definition dafür an und heften Sie sie unter Einstellungen › Benutzerdefinierte Daten an. Änderungen an Definitionen können bis zu einer Stunde dauern, bis sie in Dokumenten erscheinen.

Ein Metafeld drucken

Ersetzen Sie namespace und key durch den Namespace und den Schlüssel Ihres Metafelds (zum Beispiel custom.gift_message):

Metafeld von	Liquid
Der Bestellung oder dem Bestellentwurf	`{{ order.metafields.namespace.key }}`
Dem Kunden	`{{ customer.metafields.namespace.key }}`
Einem Produkt	`{{ line_item.product.metafields.namespace.key }}`
Einer Variante	`{{ line_item.variant.metafields.namespace.key }}`

Produkt- und Variantenmetafelder gelten pro Artikel. Verwenden Sie sie deshalb innerhalb der Schleife über die Positionen:

{% 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 %}

Wie Metafeldtypen gedruckt werden

Typ	Was Sie erhalten
Text, URL, Datum, Farbe…	Den Wert als Text
Ganzzahl, Dezimalzahl	Eine Zahl, mit der Sie vergleichen oder rechnen können
Wahr oder falsch	`true` oder `false`, für `{% if %}`
Rich Text	Den Text, ohne Formatierung
Gewicht, Abmessung, Volumen	`.value` und `.unit`, zum Beispiel `{{ … .weight.value }} {{ … .weight.unit }}`
Geld	`.value` (etwa `23.00`) und `.unit` (den Währungscode). Nicht in Cent.
Bewertung	`.value`, `.scale_min` und `.scale_max`
JSON, Listen	Eine Liste oder ein Objekt, über das Sie eine Schleife laufen lassen können

Gut zu wissen

Ein leeres oder fehlendes Metafeld druckt nichts. Verwenden Sie != blank, um seine Beschriftung wegzulassen.
Drucken Sie Metafelder in visuellen Vorlagen mit einem Block Benutzerdefiniertes Liquid.
Picklisten können Produkt- oder Variantenmetafelder als Spalten anzeigen, in den Einstellungen Pickliste der Vorlage.

Willkommen

Erste Schritte

Drucken

Vorlagen

Vorlagen-Editor

Designs

PDF-Versand

E-Mail-Vorlagen

Kundenkonten

Exporte

Rechnungen und Nummerierung

Steuern und Recht

Integrationen

Abrechnung und Tarife

Einstellungen

Fehlerbehebung

Rechtliches

Bevor Sie beginnen: Prüfen Sie, welche Metafelder Foliant lädt

Ein Metafeld drucken

Wie Metafeldtypen gedruckt werden

Gut zu wissen

Verwandte Artikel