Odpravljanje težav pri uvoženih predlogah za Order Printer

Ko prenesete predloge iz starejše različice (legacy) aplikacije Order Printer v novo aplikacijo Shopify Order Printer, se vaše spremenljivke Liquid posodobijo, da se zagotovi združljivost z novo aplikacijo. V redkih primerih boste morda morali odpraviti težave z uvoženimi predlogami.

Če se uvožene predloge ne tiskajo pravilno, boste morda morali ročno urediti kodo predloge v novi aplikaciji Shopify Order Printer. Preverite naslednje najpogostejše razloge za nepravilen uvoz predlog:

  • Predloge vključujejo prilagojene sezname slogov (CSS)
  • Predloge vsebujejo metapolja
  • Spremenljivke Liquid se morda niso pravilno posodobile

Na tej strani so podrobne informacije o tem, kako odpraviti morebitne težave pri uvažanju prilagojenih predlog v novo aplikacijo Shopify Order Printer.

Posodabljanje pogostih prilagoditev zasnove CSS

Če predloge, ki jih prenašate, vključujejo prilagojene sezname slogov (CSS), boste morda morali ročno posodobiti kodo CSS v svojih predlogah, da se bodo pravilno prikazovali elementi zasnove, kot so slike, prilagojene pisave, logotipi ali črtne kode.

Posodabljanje spremenljivk metapolj

Za dostop do metapolja morate določiti imenski prostor metapolja, pri čemer spremenljivki ni treba dodati .value. Več informacij o definicijah metapolj.

Namesto spremenljivke product.metafields.custom.manufacturerid.value na primer uporabite spremenljivko product.metafields.custom.manufacturerid.

Za ugotavljanje vrednosti imenskih prostorov posameznih metapolj glejte stran Podatki po meri v skrbniku Shopify. Definicije metapolj so razvrščene po predmetih, na katere se nanašajo, kot so izdelki, različice ali naročila.

Posodabljanje pogostih spremenljivk Liquid

V večini primerov se vaše spremenljivke Liquid samodejno posodobijo med postopkom prenašanja. Če pa se vaše predloge ne prenesejo pravilno in uporabljate katero od spremenljivk, navedenih v tem razdelku, boste morda morali stare spremenljivke ročno zamenjati z novimi. Aplikacija Shopify Order Printer uporablja drugačne spremenljivke kot starejša različica (legacy) aplikacije Order Printer.

Če na primer uporabljate spremenljivko date, jo morate zamenjati s spremenljivko created_at.

Spremenljivke naročila

Spremenljivke naročila se v aplikaciji Shopify Order Printer uporabljajo drugače. Za dostop do spremenljivk naročila morate dodati predpono order.. Za dostop do spremenljivke billing_address morate na primer uporabiti order.billing_address.

Naslednje pogosto uporabljene spremenljivke naročila so dostopne brez predpone order.:

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

Če želite na primer dostopati do spremenljivke za postavke, lahko uporabite line_items ali order.line_items.

Za predlogo lahko ustvarite tudi svoje lastne vzdevke. Uporabite lahko na primer sintakso Liquid {% assign fulfillments_count = order.fulfillments | size %} in se nato v kodi sklicujete nanjo z {{ fulfillments_count }}.

Spremenljivka naročila
Spremenljivka v starejši različici (legacy) aplikacije Order PrinterSpremenljivka v novi aplikaciji Shopify Order Printer
line_items
  • Povrnjene postavke niso vključene v spremenljivko line_items . Preglejte naslednje podrobnosti:
    • Do povrnjenih postavk lahko dostopate s spremenljivko refunds.<each>.refund_line_items. Oglejte si naslednji primer.
      {% assign refunded_line_items = refunds | map: "refund_line_items" | map: "line_item" %}
    • Če želite, lahko povrnjene postavke pridružite zbirki line_items. Oglejte si naslednji primer.
      {% 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 %}
    • Poskrbite, da boste vključili filter | uniq, da preprečite podvajanje povrnjenih postavk.
  • Postavke napitnine niso vključene v spremenljivko line_items . Preglejte naslednje podrobnosti:
    • Do postavk napitnine lahko dostopate s spremenljivko tip_line_items.
    • Če želite, lahko tip_line_items pridružite zbirki line_items. Oglejte si naslednji primer.
      {% assign line_items_with_tips = order.line_items | concat: order.tip_line_items %}
  • Če želite posnemati zbirko line_items starejše različice (legacy) aplikacije Order Printer, lahko uporabite naslednji primer kode.
    {% 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_cardUporabite podatke o plačilu glede na posamezno transakcijo iz naročila s spremenljivko transactions.<each>.payment_details.
current_shipping_priceshipping_price
dateUporabite spremenljivko created_at. Za oblikovanje časovnega žiga uporabite filter date, na primer {{ order.created_at | date: "%B %e, %Y" }}.
gatewaysunique_gateways ali transactions.<each>.gateway
order_currencycurrency
processed_atUporabite spremenljivko created_at. Ta vsebuje vrednost order.processed_at iz GraphQL API in pomeni dejanski čas obdelave naročila ter ne časa, ko je naročilo uvoženo v Shopify. To je enako kot order.processed_at iz starejše različice (legacy) aplikacije Order Printer. Za oblikovanje časovnega žiga lahko uporabite filter date, na primer {{ order.created_at | date: "%B %e, %Y" }}.
payment_transactions

Filtrirajte order.transactions glede na status kind v sintaksi Liquid s funkcijo where ali pa z zanko in pogojem if znotraj nje. Preglejte naslednje primere.

{% 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" %} Transaction ID: {{ transaction.id }} Kind: {{ transaction.kind }} Amount: {{ 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_transactionsSintakso Liquid s funkcijo where uporabite za filtriranje po order.transactions in statusu kind ali uporabite zanko z znotraj vgrajenim if, kot v naslednjem primeru.
{% assign refund_transactions = order.transactions | where: "kind", "refund" %}
shipping_lineshipping_methods | first
shipping_linesshipping_methods
show_line_item_taxestax_lines.size > 0. Lahko ga na začetku predloge določite kot spremenljivko in se nanj večkrat sklicujete, kot v naslednjem primeru.
{% if tax_lines.size > 0 %} {% assign show_line_item_taxes = true %} {% else %} {% assign show_line_item_taxes = false %} {% endif %}
total_taxtax_price
total_paidnet_payment

Spremenljivke LineItem

Spremenljivka LineItem
Spremenljivka v starejši različici (legacy) aplikacije Order PrinterSpremenljivka v novi aplikaciji Shopify Order Printer
fulfillable_quantityquantity - successfully_fulfilled_quantity
fulfilledquantity == successfully_fulfilled_quantity
nametitle
product_titleproduct.title
unit_discountquantity ? line_level_total_discount / quantity : 0
variant_titlevariant.title
weightgrams

Spremenljivke izpolnitve

spremenljivka izpolnitve
Spremenljivka v starejši različici (legacy) aplikacije Order PrinterSpremenljivka v novi aplikaciji Shopify Order Printer
datecreated_at

Spremenljivke trgovine

Spremenljivka trgovine
Spremenljivka v starejši različici (legacy) aplikacije Order PrinterSpremenljivka v novi aplikaciji Shopify Order Printer
owneraccount_owner.name
addressshop.address.address1
address2shop.address.address2
cityshop.address.city
countryshop.address.country
country_codeshop.address.country_code
provinceshop.address.province
province_codeshop.address.province_code
zipshop.address.zip

Spremenljivke naslova

Spremenljivka naslova
Spremenljivka v starejši različici (legacy) aplikacije Order PrinterSpremenljivka v novi aplikaciji Shopify Order Printer
latitudeČe se je spremenljivka address sklicevala na lastnost location, sta zemljepisna širina in dolžina na voljo na samem predmetu location.
longitudeČe se je spremenljivka address sklicevala na lastnost location, sta zemljepisna širina in dolžina na voljo na samem predmetu location.

Spremenljivke povračila

Spremenljivka povračila
Spremenljivka v starejši različici (legacy) aplikacije Order PrinterSpremenljivka v novi aplikaciji Shopify Order Printer
dateUporabite spremenljivko created_at. Za oblikovanje časovnega žiga uporabite filter date, na primer {{ order.created_at | date: "%B %e, %Y" }}.

Spremenljivke ShippingLine

Spremenljivka ShippingLine
Spremenljivka v starejši različici (legacy) aplikacije Order PrinterSpremenljivka v novi aplikaciji Shopify Order Printer
current_priceprice
priceoriginal_price

Spremenljivke transakcije

Naslednje spremenljivke transakcije so bile odstranjene in jih v aplikaciji Shopify Order Printer ni mogoče zamenjati:

  • authorization
  • message
  • test

Spremenljivke različice

spremenljivka različice
Spremenljivka v starejši različici (legacy) aplikacije Order PrinterSpremenljivka v novi aplikaciji Shopify Order Printer
gramsweight

Spremenljivke metapolja

Za dostop do metapolja morate navesti imenski prostor metapolja in spremenljivki ni treba dodati .value. Več informacij o definicijah metapolj.

Namesto spremenljivke product.metafields.manufacturerid.value na primer uporabite spremenljivko product.metafields.custom.manufacturerid.

Za prepoznavanje vrednosti za imenski prostor za vsako metapolje si oglejte stran Podatki po meri v skrbniku Shopify. Definicije metapolj so razvrščene v skupine po predmetih, na katere se nanašajo, kot so izdelki, različice ali naročila.

Preslikava filtrov

Preslikava filtrov
Ime filtra v starejši različici (legacy) aplikacije Order PrinterIme filtra v novi aplikaciji Shopify Order Printer
files_urlfile_url
payment_method in payment_methodsUporabite polje transaction.gateway_display_name pri transakcijah naročil. Načini plačila niso več razvrščeni v določene vrste, kot je {credit card, debit card, bank transfer}. Starejša različica (legacy) aplikacije Order Printer je v te kategorije preslikala le majhno podmnožico trenutno delujočih plačilnih prehodov. Ponudniki plačilnih prehodov na svoji strani upravljajo vrste načinov plačila, ki jih uporabljajo stranke.