Migrera från Order Printer-appen till Shopify Order Printer

Om du har några anpassade mallar i den föråldrade Order Printer-appen så måste du migrera dina mallar till Shopify Order Printer-appen.

För att migrera dina mallar kan du importera befintliga mallar till Shopify Order Printer-appen. Den nya Shopify Order Printer-appen har dock en lite annan implementering än den föråldrade Order Printer-appen. Det innebär att vissa av dina befintliga mallar kanske till en början inte fungerar och du kan behöva göra vissa justeringar av mallens kod.

Du måste ersätta de föråldrade variablerna med de nya variablerna för att få mallarna att fungera i den nya appen. Om du till exempel använder variabeln date så måste du ersätta den med created_at-variabeln.

På den här sidan kan du hitta en lista över variabler som du kan behöva ersätta med nya variabler i Shopify Order Printer-appen.

Överväganden för att migrera dina befintliga mallar

Granska följande överväganden innan du migrerar dina befintliga mallar till Shopify Order Printer-appen:

• Om du vill migrera dina befintliga mallar så måste du känna till HTML, CSS och Liquid. Shopifys temasupport kan hjälpa till med mindre justeringar inom ramen för Shopifys designpolicy.
• Granska Referensen för Liquid-variabler och filter för Shopify Order Printer för alla mallanpassningar som stöds.
• Om dina befintliga mallar använder anpassad CSS så måste du överföra och justera koden manuellt i den nya appen.
• Du måste lägga till orderprefixet för att komma åt ordervariabler i Shopify Order Printer-appen.
• Metafält importeras inte när du importerar befintliga mallar. Du kan behöva migrera mallar som innehåller metafält manuellt.

Migrera befintliga mallar till Shopify Order Printer-appen

Om du har befintliga mallar från den äldre Order Printer-appen kan du importera dem till Shopify Order Printer-appen . Du kan inte importera specifika mallar, du kan bara importera alla dina mallar samtidigt.

Steg:

1. Klicka på Inställningar > Appar och försäljningskanaler från din Shopify-admin.
2. Klicka på Order Printer.

3. Klicka på Öppna app.

4. Klicka på Mallar.

5. Klicka på Importera.

6. Klicka på Importera i dialogrutan.

7. Kontrollera om dina mallar använder någon av de äldre variablerna och ersätt dem sedan med de nya variablerna.

8. Förhandsgranska mallarna och se till att de visas på ett korrekt sätt.

9. Valfritt: Skriv ut testdokument.

Använda ordervariabler i Shopify Order Printer-appen

Ordervariabler används på ett annat sätt i Shopify Order Printer-appen. Du måste lägga till prefixet order. för att komma åt ordervariabler. Du måste till exempel använda variabelnorder.billing_address för att komma åt billing_address.

Följande vanliga ordervariabler är tillgängliga utan prefixet order.:

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

Om du till exempel vill komma åt postvariablen så kan du använda line_items eller order.line_items.

Du kan även skapa egna alias för mallen. Du kan till exempel använda Liquid-syntaxen {% assign fulfillments_count = order.fulfillments | size %} och sedan referera till den genom att använda {{ fulfillments_count }} i koden.

Variabelmappning

Shopify Order Printer-appen använder andra variabler än den föråldrade Order Printer-appen. Om dina befintliga mallar använder någon av variablerna som listas i det här avsnittet så måste du ersätta de gamla variablerna med nya.

Om du till exempel använder variabeln date måste du ersätta den med variabeln created_at.

Ordervariabler

Ordervariabel

Variabel i den föråldrade Order Printer-appen	Variabel i den nya Shopify Order Printer-appen
line_items	Återbetalade poster ingår inte i variabeln line_items. Granska följande uppgifter: Du kan få tillgång till återbetalade poster med hjälp av variabeln refunds.<each>.refund_line_items. variabel. Granska följande exempel. {% assign refunded_line_items = refunds | map: "refund_line_items" | map: "line_item" %} Du kan lägga till de återbetalade posterna i produktserien line_items om du vill. Granska följande exempel. {% assign refunded_line_items = order.refunds | map: "refund_line_items" | map: "line_item" %} {% assign line_items_with_refunded = order.line_items | concat: refunded_line_items | uniq %} Kontrollera att du inkluderar filtret | uniq för att undvika duplicering av de återbetalade posterna. Dricksposter ingår inte i variabeln line_items . Granska följande uppgifter: Du kan komma åt dricksposter med hjälp av variabeln tip_line_items. Du kan lägga till tip_line_items i produktserien line_items om du vill. Granska följande exempel. {% assign line_items_with_tips = order.line_items | concat: order.tip_line_items %} Du kan använda följande exempelkod att efterlikna den föråldrade produktserien Order Printer line_items . {% assign refunded_line_items = refunds | map: "refund_line_items" | map: "line_item" %} {% assign all_line_items = order.line_items | concat: refunded_line_items | concat: order.tip_line_items | uniq %} {% for line_item in all_line_items %} ... {% endfor %}
credit_card	Använd betalningsuppgifter baserat på varje transaktion från ordern med variabeln transactions.<each>.payment_details .
current_shipping_price	shipping_price
Datum	Använd variabeln created_at. Använd filtret date för att formatera tidsstämpeln, till exempel med {{ order.created_at | date: "%B %e, %Y" }}.
gateways	unique_gateways eller transactions.<each>.gateway
order_currency	valuta
processed_at	Använd variabeln created_at. Den innehar värdet på order.processed_at från GraphQL API, och det innebär den faktiska tiden som ordern behandlas vid, snarare än den tidpunkt då ordern importeras till Shopify. Den är den samma som order.processed_at från den äldre Order Printer-appen. Du kan använda filtret date för att formatera tidsstämpeln, till exempel med {{ order.created_at | date: "%B %e, %Y" }}.
payment_transactions	Filtrera med order.transactions för statusen kind i Liquid-syntaxen med where, eller med looping och ett inbäddat if. Granska följande exempel. {% assign sale_transactions = order.transactions | where: "kind", "sale" %} {% assign capture_transactions = order.transactions | where: "kind", "capture" %} {% for transaction in transactions %} {% if transaction.kind == "sale" or transaction.kind == "capture" %} Transaktions-ID: {{ transaction.id }} Sort: {{ transaction.kind }} Belopp: {{ transaction.amount | money }} {% endif %} {% endfor %} {% assign sale_transactions = order.transactions | where: "kind", "sale" %} {% assign capture_transactions = order.transactions | where: "kind", "capture" %} {% assign payment_transactions = sale_transactions | concat: capture_transactions %}
refund_transactions	Filtrera med order.transactions för statusen kind i Liquid-syntaxen med where, eller med looping och ett inbäddat if, som i följande exempel. {% assign refund_transactions = order.transactions | where: "kind", "refund" %}
shipping_line	shipping_methods | first
shipping_lines	shipping_methods
show_line_item_taxes	tax_lines.size > 0. Du kan definiera den som en variabel i början av mallen och referera till den flera gånger, som i följande exempel. {% if tax_lines.size > 0 %} {% assign show_line_item_taxes = true %} {% else %} {% assign show_line_item_taxes = false %} {% endif %}
total_tax	tax_price
total_paid	net_payment

LineItem-variabler

LineItem-variabel

Variabel i den föråldrade Order Printer-appen	Variabel i den nya Shopify Order Printer-appen
fulfillable_quantity	quantity - successfully_fulfilled_quantity
distribuerad	kvantitet == successfully_fulfilled_quantity
namn	Titel
product_title	product.title
unit_discount	kvantitet ? line_level_total_discount/kvantitet: 0
variant_title	variant.title
vikt	gram

Distributionsvariabler

distributionsvariabel

Variabel i den föråldrade Order Printer-appen	Variabel i den nya Shopify Order Printer-appen
Datum	created_at

Butiksvariabler

Shop-variabel

Variabel i den föråldrade Order Printer-appen	Variabel i den nya Shopify Order Printer-appen
ägare	account_owner.name
adress	shop.address.address1
adress2	shop.address.address2
stad	shop.address.city
land	shop.address.country
country_code	shop.address.country_code
provins	shop.address.province
province_code	shop.address.province_code
postnummer	shop.address.zip

Adressvariabler

Adressvariabel

Variabel i den föråldrade Order Printer-appen	Variabel i den nya Shopify Order Printer-appen
latitud	Om variabeln address refererades till från attributet location så finns latitud och longitud tillgängliga för själva objektet location.
longitud	Om variabeln address refererades till från attributet location så finns latitud och longitud tillgängliga för själva objektet location.

Återbetalningsvariabler

Återbetalningsvariabel

Variabel i den föråldrade Order Printer-appen	Variabel i den nya Shopify Order Printer-appen
Datum	Använd variabeln created_at. Använd filtret date för att formatera tidsstämpeln, till exempel med {{ order.created_at | date: "%B %e, %Y" }}.

ShippingLine-variabler

ShippingLine-variabel

Variabel i den föråldrade Order Printer-appen	Variabel i den nya Shopify Order Printer-appen
current_price	pris
pris	original_price

Transaktionsvariabler

Följande transaktionsvariabler togs bort och kan inte bytas ut i Shopify Order Printer-appen:

• authorization
• message
• test

Variantvariabler

variantvariabel

Variabel i den föråldrade Order Printer-appen	Variabel i den nya Shopify Order Printer-appen
gram	vikt

Metafältvariabler

Om du vill komma åt ett metafält måste du ange metafältets Namnrymd. Du behöver inte lägga till .value i variabeln. Mer information om definitioner för metafält.

Till exempel: istället för variabeln product.metafields.manufacturerid.value använder du variabeln product.metafields.custom.manufacturerid.

Se sidan Anpassade data i din Shopify-admin om du vill identifiera namnrymd-värden för varje metafält. Metafältdefinitioner grupperas efter objekt som de hänvisar till, till exempel produkter, produktvarianter eller ordrar.

Filtrera mappning

Filtrera mappning

Filtrera namn i den föråldrade Order Printer-appen	Filtrera namn i den nya Shopify Order Printer-appen
files_url	file_url
payment_method och payment_methods	Använd fältet transaction.gateway_display_name för ordertransaktioner. Betalningsmetoder kategoriseras inte längre i specifika typer, som till exempel {credit card, debit card, bank transfer}. Den föråldrade Order Printer-appen mappade endast en liten delmängd av för närvarande fungerande betalnings-gateways till dessa kategorier. Betalnings-gateways hanterar de typer av betalningsmetoder som används av kunderna på deras sida.