Importuotų „Order Printer“ šablonų trikčių šalinimas

Kai migruojate savo šablonus iš „legacy Order Printer“ programėlės į naująją „Shopify Order Printer“ programėlę, jūsų „Liquid“ kintamieji yra atnaujinami, siekiant užtikrinti suderinamumą su nauja programėle. Retais atvejais gali tekti šalinti importuotų šablonų triktis.

Jei jūsų importuoti šablonai spausdinami neteisingai, gali tekti rankiniu būdu redaguoti šablono kodą naujojoje „Shopify Order Printer“ programėlėje. Peržiūrėkite šias dažniausiai pasitaikančias priežastis, kodėl šablonai gali būti importuojami neteisingai:

  • Šablonuose yra pasirinktinis CSS
  • Šablonuose yra metalaukų
  • „Liquid“ kintamieji gali būti atnaujinti netinkamai

Šiame puslapyje rasite išsamią informaciją apie tai, kaip šalinti galimas triktis, kylančias importuojant pasirinktinius šablonus į naująją „Shopify Order Printer“ programėlę.

Įprastų CSS dizaino pritaikymų atnaujinimas

Jei Jūsų perkeliamuose šablonuose yra pasirinktinio CSS, gali reikėti rankiniu būdu atnaujinti CSS kodą šablonuose, kad būtų tinkamai rodomi dizaino elementai, pvz., vaizdai, pasirinktiniai šriftai, logotipai arba brūkšniniai kodai.

Metalaukų kintamųjų atnaujinimas

Norėdami pasiekti metalauką, turite nurodyti metalauko vardų sritį, ir prie kintamojo nereikia pridėti .value. Sužinokite daugiau apie metalaukų apibrėžimus.

Pavyzdžiui, vietoj kintamojo product.metafields.custom.manufacturerid.value naudokite kintamąjį product.metafields.custom.manufacturerid.

Norėdami identifikuoti kiekvieno metalauko vardų srities vertes, žr. puslapį Pasirinktiniai duomenys savo „Shopify“ administratoriaus skydelyje. Metalaukų apibrėžimai sugrupuoti pagal objektus, su kuriais jie susiję, pvz., produktus, variantus arba užsakymus.

Įprastų „Liquid“ kintamųjų atnaujinimas

Daugeliu atvejų Jūsų „Liquid“ kintamieji automatiškai atnaujinami migracijos proceso metu. Tačiau, jei Jūsų šablonai nėra tinkamai migruojami ir Jūs naudojate bet kurį iš šiame skyriuje nurodytų kintamųjų, gali reikėti rankiniu būdu pakeisti senus kintamuosius naujais. „Shopify Order Printer“ programėlė naudoja kitokius kintamuosius nei senoji „Order Printer“ programėlė.

Pavyzdžiui, jei naudojate kintamąjį date, jį reikia pakeisti kintamuoju created_at.

Užsakymo kintamieji

Užsakymų kintamieji „Shopify Order Printer“ programėlėje naudojami kitaip. Norėdami pasiekti užsakymo kintamuosius, turite pridėti priešdėlį order.. Pavyzdžiui, norėdami pasiekti kintamąjį billing_address, turite naudoti order.billing_address.

Šie toliau nurodyti dažnai naudojami užsakymų kintamieji yra pasiekiami be priešdėlio order.:

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

Pavyzdžiui, jei norite pasiekti prekių pozicijų kintamąjį, galite naudoti line_items arba order.line_items.

Taip pat galite susikurti savo pseudonimus šablonui. Pavyzdžiui, galite naudoti „Liquid“ sintaksę {% assign fulfillments_count = order.fulfillments | size %} ir tada savo kode ją nurodyti naudojant {{ fulfillments_count }}.

Užsakymo kintamasis
Kintamasis senojoje „Order Printer“ programėlėjeKintamasis naujoje „Shopify Order Printer“ programėlėje
line_items
  • Grąžintos prekių pozicijos neįtrauktos į line_items kintamąjį. Peržiūrėkite šią išsamią informaciją:
    • Galite pasiekti grąžintas prekių pozicijas naudodami refunds.<each>.refund_line_items kintamąjį. Peržiūrėkite šį pavyzdį.
      {% assign refunded_line_items = refunds | map: "refund_line_items" | map: "line_item" %}
    • Jei norite, galite sujungti grąžintas prekių pozicijas su line_items kolekcija. Peržiūrėkite šį pavyzdį.
      {% 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 %}
    • Turėtumėte įtraukti filtrą | uniq, kad išvengtumėte grąžintų prekių pozicijų dubliavimo.
  • Arbatpinigių prekių pozicijos neįtrauktos į line_items kintamąjį. Peržiūrėkite šią išsamią informaciją:
    • Arbatpinigių prekių pozicijas galite pasiekti naudodami kintamąjį tip_line_items.
    • Jei norite, galite sujungti tip_line_items su line_items kolekcija. Peržiūrėkite šį pavyzdį.
      {% assign line_items_with_tips = order.line_items | concat: order.tip_line_items %}
  • Norėdami atkurti senosios versijos „Order Printer“ line_items kolekciją, galite naudoti šį pavyzdinį kodą.
    {% 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_cardNaudokite mokėjimo informaciją pagal kiekvieną užsakymo operaciją su kintamuoju transactions.<each>.payment_details.
current_shipping_priceshipping_price
dateNaudokite kintamąjį created_at. Naudokite filtrą date, kad suformatuotumėte laiko žymą, pavyzdžiui, su {{ order.created_at | date: "%B %e, %Y" }}.
gatewaysunique_gateways arba transactions.<each>.gateway
order_currencycurrency
processed_atNaudokite kintamąjį created_at. Jame saugoma order.processed_at reikšmė iš GraphQL API. Tai reiškia faktinį užsakymo apdorojimo laiką, o ne laiką, kada užsakymas buvo importuotas į Shopify. Jis yra toks pat kaip order.processed_at iš senstelėjusios „Order Printer“ programėlės. Laiko žymą galite formatuoti naudodami date filtrą, pavyzdžiui, {{ order.created_at | date: "%B %e, %Y" }}.
payment_transactions

„Liquid“ sintaksėje filtruokite order.transactions pagal kind būseną, naudodami where arba ciklą su if sąlyga. Peržiūrėkite toliau pateiktus pavyzdžius.

{% 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" %} Operacijos ID: {{ transaction.id }} Tipas: {{ transaction.kind }} Suma: {{ 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_transactionsFiltruokite order.transactions pagal kind būseną „Liquid“ sintaksėje naudodami where, arba naudodami ciklą ir if sąlygą jo viduje, kaip nurodyta šiame pavyzdyje.
{% assign refund_transactions = order.transactions | where: "kind", "refund" %}
shipping_lineshipping_methods | first
shipping_linesshipping_methods
show_line_item_taxestax_lines.size > 0. Galite apibrėžti jį kaip kintamąjį šablono pradžioje ir nurodyti jį kelis kartus, kaip šiame pavyzdyje.
{% 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

„LineItem“ kintamieji

„LineItem“ kintamasis
Kintamasis senojoje „Order Printer“ programėlėjeKintamasis naujoje „Shopify Order Printer“ programėlėje
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

Užsakymo įvykdymo kintamieji

Užsakymo įvykdymo kintamasis
Kintamasis senojoje „Order Printer“ programėlėjeKintamasis naujoje „Shopify Order Printer“ programėlėje
datecreated_at

„Shop“ kintamieji

„Shop“ kintamasis
Kintamasis senojoje „Order Printer“ programėlėjeKintamasis naujoje „Shopify Order Printer“ programėlėje
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

Adreso kintamieji

Adreso kintamasis
Kintamasis senojoje „Order Printer“ programėlėjeKintamasis naujoje „Shopify Order Printer“ programėlėje
latitudeJei kintamajam address buvo priskirta nuoroda iš atributo location, platumą ir ilgumą galima rasti pačiame objekte location.
longitudeJei kintamajam address buvo priskirta nuoroda iš atributo location, platumą ir ilgumą galima rasti pačiame objekte location.

Pinigų grąžinimo kintamieji

Pinigų grąžinimo kintamasis
Kintamasis senojoje „Order Printer“ programėlėjeKintamasis naujoje „Shopify Order Printer“ programėlėje
dateNaudokite kintamąjį created_at. Naudokite filtrą date, kad suformatuotumėte laiko žymą, pavyzdžiui, su {{ order.created_at | date: "%B %e, %Y" }}.

„ShippingLine“ kintamieji

„ShippingLine“ kintamasis
Kintamasis senojoje „Order Printer“ programėlėjeKintamasis naujoje „Shopify Order Printer“ programėlėje
current_priceprice
priceoriginal_price

Operacijų kintamieji

Toliau nurodyti operacijų kintamieji buvo pašalinti ir jų negalima pakeisti „Shopify Order Printer“ programėlėje:

  • authorization
  • message
  • test

Varianto kintamieji

Varianto kintamasis
Kintamasis senojoje „Order Printer“ programėlėjeKintamasis naujoje „Shopify Order Printer“ programėlėje
gramsweight

Metalaukų kintamieji

Norėdami pasiekti metalauką, turite nurodyti metalauko vardų sritį, o prie kintamojo pridėti .value nereikia. Sužinokite daugiau apie metalaukų apibrėžimus.

Pavyzdžiui, vietoj kintamojo product.metafields.manufacturerid.value naudokite kintamąjį product.metafields.custom.manufacturerid.

Norėdami identifikuoti kiekvieno metalauko vardų srities vertes, savo „Shopify“ administratoriaus skydelyje raskite puslapį Pasirinktiniai duomenys. Metalaukų apibrėžimai sugrupuoti pagal objektus, su kuriais jie susiję, pvz., produktus, variantus arba užsakymus.

Filtrų susiejimas

Filtrų susiejimas
Filtro pavadinimas senstelėjusioje „Order Printer“ programėlėjeFiltro pavadinimas naujoje „Shopify Order Printer“ programėlėje
files_urlfile_url
payment_method ir payment_methodsUžsakymo operacijose naudokite lauką transaction.gateway_display_name. Mokėjimo būdai nebeskirstomi į konkrečius tipus, tokius kaip {kredito kortelė, debeto kortelė, banko pavedimas}. Senstelėjusi „Order Printer“ programėlė šioms kategorijoms priskyrė tik nedidelį šiuo metu veikiančių mokėjimo sietuvų poaibį. Mokėjimo sietuvų teikėjai patys valdo klientų naudojamų mokėjimo būdų tipus.