Referenz für Liquid-Variablen und Filter in Shopify Order Printer

Diese Seite wurde gedruckt um Jul 26, 2024. Die neueste Version findest du unter https://help.shopify.com/de/manual/orders/printing-orders/shopify-order-printer/liquid-variables-and-filters-reference.

Du kannst Liquid nutzen, um mit der Shopify Order Printer-App deine eigenen benutzerdefinierten Vorlagen zu erstellen. Mit Liquid kannst du Textvorlagen erstellen und sie basierend auf den eindeutigen Daten jeder Bestellung rendern.

Die auf dieser Seite aufgeführten Liquid-Referenzen sind eine Erweiterung der Open-Source-Version von Liquid und sind für die Verwendung mit der Shopify Order Printer-App gedacht. Um Informationen basierend auf den Attributenorder und shop zu rendern, kannst du die Liste der Objekte, Tags und Filter aus dieser Referenz verwenden, um deine Vorlagen anzupassen. Du kannst auch die Admin GraphQL API-Dokumente verwenden, um mehr über Objektfelder zu erfahren.

Auf dieser Seite

Variablen und Attribute verwenden

In den Shopify Order Printer-Vorlagen sind die Kerndatenobjekte order und shop. Du kannst order.variable_name verwenden, um auf die Bestellattribute zuzugreifen.

Auf die folgenden häufig verwendeten Bestellattribute kann ohne das Präfix order. zugegriffen werden:

  • line_items
  • tax_lines
  • fulfillments
  • transactions
  • discounts
  • refunds
  • shipping_methods
  • customer

Wenn du beispielsweise auf die Variable "Positionen" zugreifen möchtest, kannst du line_items oder order.line_items verwenden.

In Shopify Order Printer verfügbare Liquid-Variablen

Die folgenden Klassen sind verfügbar. Attribute werden in alphabetischer Reihenfolge aufgeführt.

Bestellung

Die folgenden Bestellattribute sind in Shopify Order Printer verfügbar:

  • attributes
  • b2b
  • billing_address
  • cancel_reason
  • cancel_reason_label
  • cancelled
  • cancelled_at
  • cart_level_discount_applications
  • checkout_id
  • checkout_payment_collection_url
  • company
  • company_location
  • confirmation_number
  • created_at. Der Zeitpunkt, an dem die Bestellung bearbeitet wurde. Das entspricht order.processed_at aus der GraphQL API. Verwende den Filter date, um den Zeitstempel zu formatieren, z. B. mit {{ order.created_at | date: "%B %e, %Y" }}.
  • customer
  • discounts. Veraltet, da nicht alle Rabattarten und -details erfasst werden. Die Eigenschaft order.discounts wurde durch order.discount_applications ersetzt.
  • discounts_amount. Veraltet, da nicht alle Rabattarten und -details erfasst werden. Die Eigenschaft order.discounts wurde durch order.total_discounts ersetzt.
  • discount_applications
  • discounts_savings. Veraltet, da nicht alle Rabattarten und -details erfasst werden. Die Eigenschaft order.discounts wurde durch - ersetzt.
  • email
  • fees
  • financial_status
  • financial_status_label
  • fulfilled_line_items
  • fulfillment_aborted
  • fulfillment_status
  • fulfillments
  • gateway
  • id
  • item_count
  • landing_site
  • landing_site_ref
  • line_items
  • line_items_subtotal_price
  • location
  • metafields
  • name
  • net_payment
  • note
  • order_name
  • order_number
  • order_status_url
  • payment
  • payment_details
  • po_number
  • refunds
  • requires_shipping
  • shipping_address
  • shipping_method
  • shipping_methods
  • shipping_price
  • shop
  • shop_name
  • subtotal_price
  • tags
  • tax_lines
  • tax_price
  • tip_line_items
  • total_discounts
  • total_duties
  • total_landed_cost_additional_fees
  • total_net_amount
  • total_outstanding
  • total_price
  • total_refunded_amount
  • total_tip
  • transactions
  • unacceptable_risks
  • unfulfilled_line_items
  • unique_gateways
  • user
  • void_transactions

Shop

Überprüfe die folgende Liste der Shop-Attribute, die in Shopify Order Printer verfügbar sind:

  • accepts_gift_cards
  • account_owner
  • allows_discounts
  • checkout
  • checkout_requires_confirmation_step
  • collections_count
  • contact_information
  • currency
  • customer_accounts_enabled
  • customer_accounts_optional
  • description
  • domain
  • email
  • email_accent_color
  • email_logo_url
  • email_logo_width
  • email_marketing
  • enabled_currencies
  • enabled_locales
  • enabled_payment_types
  • features
  • id
  • latitude
  • legal_notice
  • longitude
  • metafields
  • money_format
  • money_with_currency_format
  • name
  • password_message
  • permanent_domain
  • phone
  • policies
  • privacy_policy
  • products_count
  • refund_policy
  • secure_url
  • shipping_policy
  • subscription_policy
  • terms_of_sale
  • terms_of_service
  • types
  • url

Einzelartikel

Überprüfe die folgende Liste der Positionsattribute, die in Shopify Order Printer verfügbar sind:

  • aggregated_update
  • applied_discounts. Veraltet, da nicht alle Rabattarten und -details verfügbar sind. Die Eigenschaft line_item.discounts wurde durch line_item.discount_allocations ersetzt.
  • current_quantity
  • discount_allocations
  • discounts. Veraltet, da nicht alle Rabattarten und -details verfügbar sind. Die Eigenschaft line_item.discounts wurde durch line_item.discount_allocations ersetzt.
  • final_line_price
  • final_price
  • fulfillment
  • fulfillment_service
  • gift_card
  • grams
  • groups
  • id
  • image
  • index
  • item_updates
  • json_filter
  • key
  • line_level_discount_allocations
  • line_level_total_discount
  • line_price. Veraltet, da Rabatte aus automatischen Rabatten und Rabattcodes nicht enthalten sind. Die Eigenschaft line_item.line_price wurde durch line_item.final_line_price ersetzt.
  • message
  • options_with_values
  • original_line_price
  • original_price
  • price. Veraltet, da Rabatte aus automatischen Rabatten und Rabattcodes nicht enthalten sind. Die Eigenschaft line_item.price wurde durch line_item.final_price ersetzt.
  • product
  • product_id
  • properties
  • quantity
  • refunded_quantity
  • requires_shipping
  • selling_plan_allocation
  • sku
  • successfully_fulfilled_quantity
  • tax_lines
  • taxable
  • title
  • total_discount. Veraltet, da Rabatte aus automatischen Rabatten und Rabattcodes nicht enthalten sind. Die Eigenschaft line_item.total_discount wurde durch line_item.line_level_total_discount ersetzt.
  • unit_price
  • unit_price_measurement
  • url
  • url_to_remove
  • variant
  • variant_id
  • vendor

Fulfillment

Überprüfe die folgende Liste der Fulfillmentattribute, die in Shopify Order Printer verfügbar sind:

  • created_at. Verwende den Filter date, um den Zeitstempel zu formatieren, z. B. mit {{ fulfillment.created_at | date: "%B %e, %Y" }}.
  • estimated_delivery_at
  • fulfillment_line_items
  • item_count
  • line_items
  • requires_shipping
  • tracking_company
  • tracking_number
  • tracking_numbers
  • tracking_url
  • tracking_urls
  • updated_at

Adresse

Überprüfe die folgende Liste der Adressattribute, die in Shopify Order Printer verfügbar sind:

  • address1
  • address2
  • city
  • company
  • country
  • country_code
  • country_upper
  • errors
  • first_name
  • id
  • last_name
  • name
  • phone
  • province
  • province_code
  • street
  • summary
  • translated_country_name
  • translated_province_name
  • url
  • zip

Kunde

Überprüfe die folgende Liste der Kundenattribute, die in Shopify Order Printer verfügbar sind:

  • accepts_marketing
  • account_activation_url
  • addresses
  • addresses_count
  • b2b?
  • default_address
  • email
  • first_name
  • has_account
  • id
  • last_name
  • last_order
  • metafields
  • name
  • new_address
  • orders
  • orders_count
  • payment_methods
  • phone
  • reset_password_url
  • subscribe_url
  • tags
  • tax_exempt
  • total_spent

Rabattanwendung

Überprüfe die folgende Liste der Rabattanwendungsattribute, die in Shopify Order Printer verfügbar sind:

  • target_selection
  • target_type
  • title
  • total_allocated_amount
  • type
  • value_type
  • value

Rabatte drucken

Rabatte können auf die gesamte Bestellung oder auf bestimmte Positionen angewendet werden:

  • Rabatte auf Bestellungsebene: Diese gelten für die gesamte Bestellung. Du kannst diese Rabatte beim Drucken deiner Bestellrechnung unten getrennt anzeigen.
  • Rabatte auf Positionsebene: Diese gelten für einzelne Artikel. Du kannst diese Rabatte erwähnen, wenn du Details zu einzelnen Artikeln im Positionenabschnitt druckst.

Du kannst mit den folgenden Variablen auf die Rabattinformationen zugreifen:

  • Greife mit dem Wert order.total_discounts und der Kollektion order.discount_applications auf alle Rabatte zu, die auf die Bestellung oder die Positionen darin angewendet werden.

  • Greife mit dem Wert line_item.line_level_total_discount oder der Kollektion line_item.line_level_discount_allocations auf Rabatte für Positionen zu.

    • Greife mit dem Wert line_item.original_price auf den Preis der Position vor der Anwendung von Rabatten zu.
    • Greife mit dem Wert line_item.final_price auf den Preis der Position zu, der entsteht, nachdem alle Rabatte auf Positionsebene angewendet wurden.
    • Die Werte line_item.original_line_price und line_item.final_line_price entsprechen den Werten line_item.original_price und line_item.final_price multipliziert mit line_item.quantity.

  • Greife mit der Kollektion order.cart_level_discount_applications auf Rabatte auf Bestellungsebene zu.

Beispielcodeblock für das Drucken von Rabatten auf Positionsebene:

{% for line_item in order.line_items %}
  <tr>
    <td>{{ line_item.quantity }}</td>
    <td>{{ line_item.title }}
    {% if line_item.line_level_discount_allocations.size > 0 %}
      <span class="subduedText">
        {% for discount_allocation in line_item.line_level_discount_allocations %}
        <br>{{ discount_allocation.discount_application.title }} (-{{ discount_allocation.amount | money }})
        {% endfor %}
      </span>
    {% endif %}
    </td>
    <td style="text-align: right;">
      {% if line_item.original_price != line_item.final_price %}
        <span class="subduedText"><s>{{ line_item.original_price | money }}</s></span>
      {% endif %}
      {{ line_item.final_price | money }}
    </td>
  </tr>
{% endfor %}

Beispielcodeblock für das Drucken von Rabatten auf Bestellungsebene:

{% for discount_application in order.cart_level_discount_applications %}
<tr>
  <td colspan="2" style="text-align: right;">{% if discount_application.title %}<span class="subduedText">{{ discount_application.title }}</span>{% endif %}</td>
  <td style="text-align: right;">-{{ discount_application.total_allocated_amount | money }}</td>
</tr>
{% endfor %}

Rabattzuweisung

Überprüfe die folgende Liste der Rabattzuweisungsattribute, die in Shopify Order Printer verfügbar sind:

  • amount
  • discount_application

Rabatt

Überprüfe die folgende Liste der Rabattattribute, die in Shopify Order Printer verfügbar sind:

  • amount
  • code
  • free_shipping_discount
  • id
  • savings
  • title
  • total_amount
  • total_savings

Produkt

Überprüfe die folgende Liste der Produktattribute, die in Shopify Order Printer verfügbar sind:

  • as_json
  • available
  • collections
  • compare_at_price
  • compare_at_price_max
  • compare_at_price_min
  • compare_at_price_varies
  • content
  • created_at
  • description
  • featured_image
  • featured_media
  • first_available_variant
  • gift_card?
  • handle
  • has_only_default_variant
  • id
  • images
  • json_filter
  • media
  • metafields
  • object_type
  • options
  • options_by_name
  • options_with_values
  • price
  • price_max
  • price_min
  • price_varies
  • published_at
  • requires_selling_plan
  • selected_or_first_available_selling_plan_allocation
  • selected_or_first_available_variant
  • selected_selling_plan
  • selected_selling_plan_allocation
  • selected_variant
  • selling_plan_groups
  • tags
  • template_suffix
  • title
  • type
  • url
  • variants
  • vendor

Variante

Überprüfe die folgende Liste der Variantenattribute, die in Shopify Order Printer verfügbar sind:

  • as_json
  • available
  • barcode
  • compare_at_price
  • featured_image
  • featured_media
  • id
  • image
  • incoming
  • inventory_management
  • inventory_policy
  • inventory_quantity
  • json_filter
  • metafields
  • next_incoming_date
  • option1
  • option2
  • option3
  • options
  • price
  • product
  • requires_selling_plan
  • requires_shipping
  • selected_selling_plan_allocation
  • selling_plan_allocations
  • sku
  • store_availabilities
  • taxable
  • title
  • unit_price
  • unit_price_measurement
  • url
  • weight
  • weight_in_unit
  • weight_unit

Zurückerstatten

Überprüfe die folgende Liste der Rückerstattungsattribute, die in Shopify Order Printer verfügbar sind:

  • amount
  • created_at
  • id
  • note
  • refund_line_items
  • restock
  • transactions

Versandzeile

Überprüfe die folgende Liste der Versandzeilenattribute, die in Shopify Order Printer verfügbar sind:

  • handle
  • id
  • original_price
  • tax_lines
  • title

Steuerzeile

Überprüfe die folgende Liste der Steuerzeilenattribute, die in Shopify Order Printer verfügbar sind:

  • price
  • rate
  • rate_percentage
  • title

Transaktion

Überprüfe die folgende Liste der Transaktionsattribute, die in Shopify Order Printer verfügbar sind:

  • amount
  • buyer_pending_payment_instructions
  • buyer_pending_payment_notice
  • created_at
  • gateway
  • gateway_display_name
  • id
  • kind
  • name
  • payment_details
  • receipt
  • show_buyer_pending_payment_instructions
  • status
  • status_label

Metafeld

Ein Metafeld, das an ein übergeordnetes Objekt angehängt ist. Unter Auf Metafelder zugreifen kannst du herausfinden, wie du bei einem bestimmten Objekt auf ein Metafeld zugreifen kannst.

Metafelder unterstützen mehrere Datentypen, die die Art von Informationen bestimmen, die im Metafeld gespeichert werden. Für den Zugriff auf Metafelder besteht der Zugriffspfad für Metafelder aus zwei Ebenen:

  • Namensraum – eine Gruppierung von Metafeldern, um Konflikte zu verhindern
  • Schlüssel – der Name des Metafelds

Somit kannst du auf das Metafeldobjekt mit der folgenden Syntax zugreifen: {{ resource.metafields.namespace.key }}.

Benenne: <object>.metafields.<namespace>.<key>. Beispielsweise order.metafields.shipping.express_delivery_status.

Typen:

  • String
  • Array – Verwende [] zum Indizieren. Zum Beispiel: order.metafield.shipping.express_delivery_status[0]
  • Integer
  • Boolean
  • Date

Hinweis Metaobject-Typ wird nicht unterstützt.

Objekte, die Metafelder unterstützen:

  • Order
  • Customer
  • Product
  • Variant
  • Location

In Shopify Order Printer verfügbare Liquid-Filter

Verwendung

Um Filter auf eine Ausgabe anzuwenden, füge den Filter und alle Filterparameter innerhalb der geschweiften Klammern {{ }} der Ausgabe hinzu und stelle den senkrechten Strich | voran. Im folgenden Beispiel ist das Produkt das Objekt, der Titel ist die Eigenschaft und Großbuchstaben ist der angewendete Filter:

{{ product.title | upcase }}

Wenn product.title den Wert Health potion hat, istHEALTH POTION die Ausgabe des Filters upcase.

Weitere Informationen zur Verwendung von Liquid-Filtern findest du in der Shopify-Themes-Liquid-Referenz im Abschnitt zu den Filtern.

Auf Adressobjekte anzuwendende Filter

  • format_address

Beispiele für die Verwendung findest du in der Shopify-Themes-Liquid-Dokumentation zu format_address.

Auf jeglichen Text/String anzuwendende Filter

  • camelcase
  • camelize
  • encode_url_component
  • format_code
  • handle
  • highlight
  • pad_spaces
  • paragraphize
  • pluralize
  • url_escape
  • url_param_escape

Beispiele für die Verwendung findest du in der Shopify-Themes-Liquid-Dokumentation zu String-Filtern.

Auf geldbezogene Zahlen anzuwendende Filter

  • money
  • money_with_currency
  • money_without_currency
  • money_without_trailing_zeros

Shopify Order Printer verwendet die im Shopify-Adminbereich konfigurierten Währungsformatierungsoptionen für E-Mail-Benachrichtigungen zur Formatierung von Geld. Du kannst die Währungsformatierung ändern. Lege die Werte für die Email with currency und die Email without currency im Shopify-Adminbereich fest, um die Formatierung der Geldfilter in Shopify Order Printer zu ändern.

Beispiele für die Verwendung findest du in der Shopify-Themes-Liquid-Dokumentation zu Geldfiltern.

Für die Konvertierung von Objekten zu JSON anzuwendende Filter

  • json

Beispiele für die Verwendung findest du in der Shopify-Themes-Liquid-Dokumentation zu JSON-Filtern.

Auf gewichtsbezogene Zahlen anzuwendende Filter

  • weight
  • weight_with_unit

Beispiele für die Verwendung findest du in der Shopify-Themes-Liquid-Dokumentation zum Gewicht mit Einheit.

Auf Tags anzuwendende Filter

  • highlight_active_tag
  • link_to_add_tag
  • link_to_remove_tag
  • link_to_tag

Beispiele für die Verwendung findest du in der Shopify-Themes-Liquid-Dokumentation zu Tag-Filtern.

Auf URLs anzuwendende Filter

  • article_img_url
  • asset_img_url
  • asset_url
  • cdn_asset_url
  • collection_img_url
  • file_img_url
  • file_url
  • global_asset_url
  • image_url
  • img_tag
  • img_url
  • link_to
  • payment_icon_png_url
  • payment_type_img_url
  • payment_type_svg_tag
  • placeholder_svg_tag
  • product_img_url
  • script_tag
  • shopify_asset_url
  • stylesheet_tag

Beispiele für die Verwendung findest du in der Shopify-Themes-Liquid-Dokumentation zu Medien- und HTML-Filtern.

Auf Kollektionen anzuwendende Filter

  • link_to_type
  • link_to_vendor
  • sort_by
  • url_for_type
  • url_for_vendor
  • within

Beispiele für die Verwendung findest du in der Shopify-Themes-Liquid-Dokumentation zu Kollektionsfiltern.

Bereit, mit Shopify zu verkaufen?

Kostenlos testen