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

Liquid-implementeringen i Shopifys Order Printer skiljer sig något från den ursprungliga Order Printer. Om du vill migrera dina mallar måste du kopiera koden manuellt från dina befintliga mallar, klistra in dem i den nya appen och göra nödvändiga justeringar enligt beskrivningen i den här guiden. Eventuell anpassad CSS som lagts till i dina mallar måste också överföras och justeras i den nya appen.

Observera

De nya mallarna, fakturorna och följesedlarna för Shopify Order Printer-appen har optimerats för att använda mindre papper och bläck och för att rymma ytterligare information. Granska de nya mallarna för att avgöra om de passar dina behov bättre innan du migrerar dina befintliga Order Printer-mallar.

Orderattribut tas bort från den globala namnrymden

Om du vill komma åt orderattribut ska de föregås av order.. Till exempel är billing_address nu tillgänglig som order.billing_address.

För din bekvämlighet finns flera vanliga orderattribut fortfarande tillgängliga utan prefixet order.:

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

Dessa variabler kan nås antingen som fulfillments eller order.fulfillments och så vidare.

Observera

Du kan skapa dina egna alias inuti mallen med Liquid-syntaxen {% assign fulfillments_count = order.fulfillments | size %} och sedan referera till den med syntaxen {{ fulfillments_count }} i malltexten.

Inaktuella fält

I och med den uppdaterade Shopify-datamodellen döptes flera fält på flera objekt om, eller blev inaktuella med en ersättning eller en lösning som anges nedan. Om dina mallar använder någon av dem ska du ersätta dem med de angivna ersättningsfälten eller kodfragmenten.

Beställ

Skillnader i implementeringen:

• line_items. Återbetalade poster ingår inte i line_items-produktserien. Få tillgång till återbetalade poster via refunds.<each>.refunded_line_items.

Inaktuella fält med angivna ersättningar:

• credit_card. Använd betalningsuppgifter baserat på varje transaktion från ordern: transactions.each.payment_details.
• current_shipping_price. Använd shipping_price istället.
• date. Använd created_at istället.
• gateways. Använd unique_gateways eller transactions.<each>.gateway istället.
• order_currency. Använd currency istället.
• processed_at. Använd created_at istället.
• payment_transactions. Filtrera order.transactions på sort och status i Liquid-syntaxen med where eller med looping och if inbäddat.
• refund_transactions. Filtrera order.transactions på sort och status i Liquid-syntaxen med where eller med looping och if inbäddat.
• shipping_line. Använd shipping_methods | first.
• shipping_lines. Använd shipping_methods.
• show_line_item_taxes. Kontrollera att tax_lines.size > 0. Du kan definiera den som en variabel i början av mallen och referera flera gånger: {% assign show_line_item_taxes = tax_lines.size > 0 %}.
• total_tax. Använd tax_price.
• total_paid. Använd net_payment.

LineItem

Inaktuella fält med angivna ersättningar:

• fulfillable_quantity. Använd quantity - successfully_fulfilled_quantity.
• fulfilled. Beräkna villkor för quantity == successfully_fulfilled_quantity.
• name. Använd title.
• product_title. Använd product.title.
• unit_discount. Beräkna quantity ? total_iscount / quantity : 0.
• variant_title. Använd variant.title.
• weight. Använd grams.

Distribution

Inaktuella fält med angivna ersättningar:

• date. Använd created_at.

Shop

Inaktuella fält med angivna ersättningar:

• owner – Använd account_owner.name.

Följande fält refereras till som shop.address.<field_name>:

• address – Använd shop.address.address1.
• address2 – Använd shop.address.address2.
• city – Använd shop.address.city.
• country – Använd shop.address.city.
• country_code – Använd shop.address.country_code.
• province – Använd shop.address.province.
• province_code – Använd shop.address.province_code.
• zip – Använd shop.address.zip.

Adress

Inaktuella fält med angivna ersättningar:

• latitude – om address refererades från location finns latitud och longitud tillgängliga för själva location-objektet.
• Longitude – om address refererades från location finns latitud och longitud tillgängliga för själva location-objektet.

Återbetalning

Inaktuella fält med angivna ersättningar:

• date. Använd created_at.

Leveranspost

Inaktuella fält med angivna ersättningar:

• current_price. Använd price.
• price. Använd original_price.

Transaktion

Borttagna fält:

• authorization
• message
• test

Variant

Inaktuella fält med angivna ersättningar:

• grams. Använd weight.

Inaktuella filter

Inaktuella fält med angivna ersättningar:

• files_url. Använd file_url.
• payment_method, payment_methods. Använd fältet transaction.gateway_display_name för ordertransaktioner. Betalningsmetoder kategoriseras inte längre i specifika typer, till exempel {credit card, debit card, bank transfer}. Den äldre Order Printer kopplade endast en liten delmängd av de betalnings-gateways som för närvarande fungerar till dessa kategorier. Leverantörer av betalnings-gateways hanterar de typer av betalningsmetoder som används av kunder på sin sida.