Migrer fra Order Printer-appen til Shopify Order Printer
Hvis du har tilpassede skabeloner i den ældre Order Printer-app, skal du migrere dine skabeloner til Shopify Order Printer-appen.
Hvis du vil migrere dine skabeloner, kan du kopiere dine eksisterende skabeloner til Shopify Order Printer-appen. Implementering i den nye Shopify Order Printer-app er dog en smule forskellig fra implementering i den ældre Order Printer-app. Dette betyder, at nogle af dine eksisterende skabeloner muligvis ikke vil virke først, og at du skal foretage justeringer af skabelonernes kode.
Du skal erstatte de ældre variabler med de nye variabler for at få dine skabeloner til at fungere i den nye app. Hvis du f.eks. bruger variablen date
, skal du erstatte den med variablen created_at
.
På denne side kan du finde en liste over de variabler, du muligvis skal erstatte med nye variabler i Shopify Order Printer-appen.
På denne side
Overvejelser i forbindelse med migrering af eksisterende skabeloner
Gennemgå følgende overvejelser, inden du migrerer dine eksisterende skabeloner til Shopify Order Printer-appen:
- Hvis du vil migrere dine eksisterende skabeloner, skal du have kendskab til HTML, CSS og Liquid. Shopify Theme Support kan hjælpe dig med mindre justeringer, der er omfattet af Shopifys designpolitik.
- Se Referencer for Liquid-variabler og -filtre til Shopify Order Printer for alle understøttede skabelontilpasninger.
- Hvis dine eksisterende skabeloner bruger tilpasset CSS, skal du manuelt overføre og justere koden i den nye app.
- Du skal tilføje ordrepræfikset for at kunne tilgå ordrevariabler i Shopify Order Printer-appen.
- Når du importerer eksisterende skabeloner, importeres metafelter ikke. Du skal muligvis migrere skabeloner, der indeholder metafelter, manuelt.
Sådan migrerer du eksisterende skabeloner til Shopify Order Printer-appen
Hvis du har eksisterende skabeloner fra den ældre Order Printer-app, kan du importere dem til Shopify Order Printer-appen . Du kan ikke importere udvalgte skabeloner. Du kan kun importere alle dine skabeloner samtidigt.
Trin:
- Klik på Indstillinger > Apps- og Salgskanaler i Shopify-administrator.
- Klik på Order Printer.
Klik på Åbn app.
Klik på Skabeloner.
Klik på Importér.
Klik på Importér i dialogboksen.
Se en forhåndsvisning af dine skabeloner og kontrollér, at skabelonerne vises korrekt.
Valgfrit: Udskriv testdokumenter.
Sådan bruger du ordrevariabler i Shopify Order Printer-appen
Ordrevariabler bruges på en anden måde i Shopify Order Printer-appen. Du skal tilføje order.
-præfikset for at kunne tilgå ordrevariabler. Du skal f.eks. bruge order.billing_address
for at kunne tilgå variablen billing_address
.
Følgende almindeligt anvendte ordrevariabler er tilgængelige uden præfikset order.
:
-
line_items
-
tax_lines
-
fulfillments
-
transactions
-
refunds
-
shipping_methods
-
customer
Hvis du f.eks. vil have adgang til varelinjevariablen, kan du bruge line_items
eller order.line_items
.
Du kan også oprette dine egne aliasser for din skabelon. Du kan f.eks. bruge Liquid-syntaksen {% assign fulfillments_count = order.fulfillments | size %}
og derefter referere til den ved at bruge {{ fulfillments_count }}
i din kode.
Variabelkortlægning
Shopify Order Printer-appen bruger andre variabler end den ældre Order Printer-app. Hvis dine eksisterende skabeloner bruger nogle af de variabler, der er angivet i dette afsnit, skal du erstatte de gamle variabler med nye variabler.
Hvis du f.eks. bruger variablen date
, skal du erstatte den med variablen created_at
.
Ordrevariabler
Variabel i den ældre Order Printer-app | Variabel i den nye Shopify Order Printer-app |
---|---|
line_items |
|
credit_card |
Brug betalingsoplysninger baseret på hver transaktion fra ordren med variablen transactions.<each>.payment_details . |
current_shipping_price |
shipping_price |
dato |
Brug variablen created_at . Brug filteret date til at formatere tidsstemplet, f.eks. med {{ order.created_at | date: "%B %e, %Y" }} . |
gateways |
unique_gateways eller transactions.<each>.gateway
|
order_currency |
valuta |
processed_at |
Brug variablen created_at . Den indeholder værdien af order.processed_at fra GraphQL API'en, og det betyder det faktiske tidspunkt, hvor ordren behandles, i stedet for det tidspunkt, hvor ordren importeres til Shopify. Det er det samme som order.processed_at fra den ældre Order Printer-app. Du kan bruge filteret date til at formatere tidsstemplet, f.eks. med {{ order.created_at | date: "%B %e, %Y" }} . |
payment_transactions |
Filtrer
|
refund_transactions |
Filtrer order.transactions efter statussen type i Liquid-syntaksen med where eller med looping og en if indeni, som i det følgende eksempel.{% 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 definere den som en variabel i begyndelsen af skabelonen og referere til den flere gange som i det følgende eksempel.{% 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
Variabel i den ældre Order Printer-app | Variabel i den nye Shopify Order Printer-app |
---|---|
fulfillable_quantity |
quantity - successfully_fulfilled_quantity |
klargjort |
quantity == successfully_fulfilled_quantity |
navn |
titel |
product_title |
product.title |
unit_discount |
quantity ? line_level_total_discount / quantity : 0 |
variant_title |
variant.title |
vægt |
gram |
Klargøringsvariabler
Variabel i den ældre Order Printer-app | Variabel i den nye Shopify Order Printer-app |
---|---|
dato |
created_at |
Butiksvariabler
Variabel i den ældre Order Printer-app | Variabel i den nye Shopify Order Printer-app |
---|---|
ejer |
account_owner.name |
adresse |
shop.address.address1 |
adresse2 |
shop.address.address2 |
by |
shop.address.city |
land |
shop.address.country |
country_code |
shop.address.country_code |
landsdel |
shop.address.province |
province_code |
shop.address.province_code |
postnummer |
shop.address.zip |
Adressevariabler
Variabel i den ældre Order Printer-app | Variabel i den nye Shopify Order Printer-app |
---|---|
breddegrad |
Hvis variablen address blev refereret fra attributten location , er både breddegrad og længdegrad tilgængelige i selve location -objektet. |
længdegrad |
Hvis variablen address blev refereret fra attributten location , er både breddegrad og længdegrad tilgængelige i selve location -objektet. |
Refusionsvariabler
Variabel i den ældre Order Printer-app | Variabel i den nye Shopify Order Printer-app |
---|---|
dato |
Brug variablen created_at . Brug filteret date til at formatere tidsstemplet, f.eks. med {{ order.created_at | date: "%B %e, %Y" }} . |
ShippingLine-variabler
Variabel i den ældre Order Printer-app | Variabel i den nye Shopify Order Printer-app |
---|---|
current_price |
pris |
pris |
original_price |
Transaktionsvariabler
Følgende transaktionsvariabler blev fjernet og kan ikke erstattes i Shopify Order Printer-appen:
-
authorization
-
message
-
test
Variantvariabler
Variabel i den ældre Order Printer-app | Variabel i den nye Shopify Order Printer-app |
---|---|
gram |
vægt |
Metafeltvariabler
For at få adgang til et metafelt skal du angive metafeltets Navneområde, og du behøver ikke at føje .value
til variablen. Få mere at vide om metafeltdefinitioner.
I stedet for variablen product.metafields.manufacturerid.value
kan du for eksempel bruge variablen product.metafields.custom.manufacturerid
.
Du kan identificere værdier for Navneområder for hvert metafelt ved at se siden Tilpassede data i din Shopify-administrator. Metafeltdefinitioner grupperes efter de objekter, de henviser til, f.eks. produkter, varianter eller ordrer.
Filtrerkortlægning
Filternavn i den ældre Order Printer-app | Filternavn i den nye Shopify Order Printer-app |
---|---|
files_url |
file_url |
payment_method og payment_methods
|
Brug feltet transaction.gateway_display_name i ordretransaktioner. Betalingsmetoder kategoriseres ikke længere i specifikke typer, som f.eks. {kreditkort, debetkort, bankoverførsel} . Den ældre Order Printer-app registrerede kun en mindre del af de betalingsgateways, der fungerer på nuværende tidspunkt, til disse kategorier. Udbydere af betalingsgateways administrerer de typer betalingsmetoder, som kunderne bruger, på deres side. |