Von der Order Printer-App zu Shopify Order Printer migrieren

Die Liquid-Implementierung bei Shopify Order Printer unterscheidet sich etwas von der ursprünglichen Order Printer-App. Um deine Vorlagen zu migrieren, musst du den Code manuell aus deinen vorhandenen Vorlagen kopieren, in die neue App einfügen und die erforderlichen Anpassungen wie in diesem Leitfaden beschrieben vornehmen. Benutzerdefinierte CSS-Dateien, die du deinen Vorlagen hinzugefügt hast, müssen ebenfalls in die neue App übertragen und entsprechend angepasst werden.

Hinweis

Die neuen Vorlagen, Rechnungen und Lieferscheine der Shopify Order Printer-App wurden optimiert, sodass sie weniger Papier und Tinte verwenden und zusätzliche Informationen enthalten. Bevor du deine vorhandenen Order Printer-Vorlagen migrierst, solltest du die neuen Vorlagen überprüfen und abwägen, ob die neuen Vorlagen u. .U besser zu deinen Anforderungen passen.

Aus dem globalen Namensraum entfernte Bestellattribute

Um auf Bestellattribute zuzugreifen, stelle ihnen order. voran. Zum Beispiel kannst du auf billing_address jetzt mit order.billing_address zugreifen.

Der Einfachheit halber sind einige häufig verwendete Bestellattribute auch ohne das Präfix order. zugänglich:

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

Auf diese Variablen kann entweder mit fulfillments oder mitorder.fulfillments zugegriffen werden.

Hinweis

Du kannst deine eigenen Aliase innerhalb des Vorlagentextes mit der Liquid-Syntax {% assign fulfillments_count = order.fulfillments | size %} erstellen und dann mit der Syntax {{ fulfillments_count }} im Vorlagentext darauf verweisen.

Veraltete Felder

Gemäß dem aktuellsten Shopify-Datenmodell wurden mehrere Felder in mehreren Objekten umbenannt oder als veraltet eingestuft, wobei ein Ersatz oder eine Umgehung in den folgenden Abschnitten bereitgestellt wird. Wenn deine Vorlagen auf eines dieser Felder zugreifen, ersetze sie durch die bereitgestellten Ersatzfelder oder Codefragmente.

Bestellung

Unterschiede bei der Implementierung:

• line_items – Zurückerstattete Positionen sind nicht in den line_items-Bezügen enthalten. Auf zurückerstattete Positionen kannst du mit refunds.<each>.refunded_line_items zugreifen.

Veraltete Felder mit angegebenen Ersetzungen:

• credit_card – Verwende die Zahlungsdetails basierend auf jeder Transaktion in der Bestellung: transactions.each.payment_details.
• current_shipping_price – Verwende stattdessen shipping_price.
• date – Verwende stattdessen created_at.
• gateways – Verwende stattdessen unique_gateways oder transactions.<each>.gateway.
• order_currency – Verwende stattdessen currency.
• processed_at – Verwende stattdessen created_at.
• payment_transactions – Filtere order.transactions nach Art und Status in der Liquid-Syntax mit der where-Anweisung oder mit einer Schleife mit enthaltener if-Anweisung.
• refund_transactions – Filtere order.transactions nach Art und Status in der Liquid-Syntax mit der where-Anweisung oder mit einer Schleife mit enthaltener if-Anweisung.
• shipping_line – Verwende shipping_methods | first.
• shipping_lines – Verwende shipping_methods.
• show_line_item_taxes – Verwende tax_lines.size > 0. Du kannst das Feld als Variable am Anfang der Vorlage definieren und mehrfach darauf verweisen: {% assign show_line_item_taxes = tax_lines.size > 0 %}.
• total_tax – Verwende tax_price.
• total_paid – Verwende net_payment.

Einzelartikel

Veraltete Felder mit angegebenen Ersetzungen:

• fulfillable_quantity – Verwende quantity - successfully_fulfilled_quantity.
• fulfilled – Berechne die Bedingung quantity == successfully_fulfilled_quantity.
• name – Verwende title.
• product_title – Verwende product.title.
• unit_discount – Berechne quantity ? total_iscount / quantity : 0.
• variant_title – Verwende variant.title.
• weight – Verwende grams.

Fulfillment

Veraltete Felder mit angegebenen Ersetzungen:

• date – Verwende created_at.

Shop

Veraltete Felder mit angegebenen Ersetzungen:

• owner – Verwende account_owner.name.

Verweise mit shop.address.<field_name> auf die folgenden Felder:

• address – Verwende shop.address.address1.
• address2 – Verwende shop.address.address2.
• city – Verwende shop.address.city.
• country – Verwende shop.address.city.
• country_code – Verwende shop.address.country_code.
• province – Verwende shop.address.province.
• province_code – Verwende shop.address.province_code.
• zip – Verwende shop.address.zip.

Adresse

Veraltete Felder mit angegebenen Ersetzungen:

• latitude – Wenn von location auf address verwiesen wird, sind Breiten- und Längengrad im Objekt location vorhanden.
• Longitude – Wenn von location auf address verwiesen wird, sind Breiten- und Längengrad im Objekt location vorhanden.

Zurückerstatten

Veraltete Felder mit angegebenen Ersetzungen:

• date – Verwende created_at.

Versandzeile

Veraltete Felder mit angegebenen Ersetzungen:

• current_price – Verwende price.
• price – Verwende original_price.

Transaktion

Entfernte Felder:

• authorization
• message
• test

Variante

Veraltete Felder mit angegebenen Ersetzungen:

• grams – Verwende weight.

Veraltete Filter

Veraltete Felder mit angegebenen Ersetzungen:

• files_url – Verwende file_url.
• payment_method, payment_methods – Verwende das Feld transaction.gateway_display_name für Bestelltransaktionen. Zahlungsmethoden werden nicht mehr in bestimmte Arten unterteilt, z. B. {credit card, debit card, bank transfer}. Die alte Order Printer-App ordnete diesen Kategorien nur eine kleine Teilmenge der derzeit funktionierenden Zahlungs-Gateways zu. Die Anbieter von Zahlungs-Gateways verwalten die von den Kunden verwendeten Zahlungsarten auf ihrer Seite.