Az importált Order Printer-sablonokkal kapcsolatos problémák hibaelhárítása

Amikor migrálja a sablonjait a régi Order Printer alkalmazásból az új Shopify Order Printer alkalmazásba, a Liquid-változók frissülnek, hogy biztosítsák a kompatibilitást az új alkalmazással. Ritka esetekben szükség lehet az importált sablonok hibaelhárítására.

Ha az importált sablonok nem nyomtatnak megfelelően, akkor lehet, hogy manuálisan kell szerkesztenie a sablon kódját az új Shopify Order Printer alkalmazásban. Tekintse át a következő leggyakoribb okokat, amelyek miatt a sablonok importálása sikertelen lehet:

A sablonok egyéni CSS-t tartalmaznak
A sablonok metamezőket tartalmaznak
A Liquid-változók esetleg nem frissülnek megfelelően

Ezen az oldalon részletes információkat talál az esetlegesen felmerülő problémák hibaelhárításáról, amikor egyéni sablonjait importálja az új Shopify Order Printer alkalmazásba.

Ezen az oldalon

Gyakori CSS-tervezési testreszabások frissítése

Ha az áthelyezett sablonok egyéni CSS-t tartalmaznak, akkor lehetséges, hogy manuálisan kell frissítenie a sablonok CSS-kódját a designelemek, például képek, egyéni betűtípusok, logók vagy vonalkódok helyes megjelenítéséhez.

A metamező-változók frissítése

Egy metamező eléréséhez meg kell adnia a metamező névterét, és nem kell a .value-t a változóhoz adnia. További információ a metamezők meghatározásáról.

Például a product.metafields.custom.manufacturerid.value változó helyett használja a product.metafields.custom.manufacturerid változót.

Az egyes metamezők névtérértékeinek azonosításához tekintse meg a Egyéni adatok oldalt a Shopify adminisztrációs felületén. A metamezők meghatározásai az általuk hivatkozott objektumok, például termékek, változatok vagy rendelések szerint vannak csoportosítva.

A gyakori Liquid változók frissítése

A legtöbb esetben a Liquid változók automatikusan frissülnek a migrációs folyamat során. Ha azonban a sablonok migrálása nem megfelelő, és az ebben a szakaszban felsorolt változók bármelyikét használja, akkor lehetséges, hogy manuálisan kell lecserélnie a régi változókat az újakra. A Shopify Order Printer alkalmazás más változókat használ, mint a régi Order Printer alkalmazás.

Például ha a date változót használja, akkor azt le kell cserélnie a created_at változóra.

Rendelési változók

A rendelési változók használata eltérő a Shopify Order Printer alkalmazásban. A rendelési változók eléréséhez hozzá kell adnia az order. előtagot. Például a billing_address változó eléréséhez az order.billing_address címet kell használnia.

Az alábbi gyakran használt rendelési változók az order. előtag nélkül is elérhetők:

line_items
tax_lines
fulfillments
transactions
refunds
shipping_methods
customer

Például ha a sorelemek változóját szeretné elérni, használhatja a line_items vagy az order.line_items változót.

Saját aliasokat is létrehozhat a sablonhoz. Például használhatja a {% assign fulfillments_count = order.fulfillments | size %} Liquid szintaxist, majd a kódjában a {{ fulfillments_count }} használatával hivatkozhat rá.

Rendelési változó
Változó a régi Order Printer alkalmazásban	Változó az új Shopify Order Printer alkalmazásban
`line_items`	Visszatérített sorelemek nem szerepelnek a `line_items` változóban. Tekintse át a következő részleteket: A visszatérített sorelemeket a `refunds.<each>.refund_line_items` változó segítségével érheti el. Tekintse meg a következő példát. `{% assign refunded_line_items = refunds \| map: "refund_line_items" \| map: "line_item" %}` Kívánság szerint a visszatérített sorelemeket a `line_items` gyűjteményhez is hozzáfűzheti. Tekintse meg a következő példát. `{% 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 %}` A visszatérített sorelemek duplikálásának elkerülése érdekében győződjön meg arról, hogy használja a `\| uniq` szűrőt. Borravaló sorelemek nem szerepelnek a `line_items` változóban. Tekintse át a következő részleteket: A borravaló sorelemeket a `tip_line_items` változóval érheti el. Kívánság szerint a `tip_line_items` elemeket a `line_items` gyűjteményhez is hozzáfűzheti. Tekintse meg a következő példát. `{% assign line_items_with_tips = order.line_items \| concat: order.tip_line_items %}` A korábbi Order Printer `line_items` gyűjteményének szimulálásához a következő példakódot használhatja. `{% 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`	Használja a rendelés minden egyes tranzakcióján alapuló fizetési adatokat a `transactions.<each>.payment_details` változóval.
`current_shipping_price`	`shipping_price`
`date`	Használja a `created_at` változót. Az időbélyeg formázásához használja a `date` szűrőt, például a következőképpen: `{{ order.created_at \| date: "%B %e, %Y" }}`.
`gateways`	`unique_gateways` vagy `transactions.<each>.gateway`
`order_currency`	`currency`
`processed_at`	Használja a `created_at` változót. Ez a GraphQL API-ból származó `order.processed_at` értékét tartalmazza, és a rendelés tényleges feldolgozásának időpontját jelenti, nem pedig a rendelés Shopifyba való importálásának időpontját. Megegyezik a régi Order Printer alkalmazásból származó `order.processed_at` változóval. Az időbélyeg formázásához használhatja a `date` szűrőt, például a `{{ order.created_at \| date: "%B %e, %Y" }}` kóddal.
`payment_transactions`	Szűrjön az `order.transactions` között a `kind` állapotra a Liquid szintaxisban a where segítségével, vagy egy cikluson belüli `if` utasítással. Tekintse át a következő példákat. `{% 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_transactions`	Szűrjön az `order.transactions` elemen belül a `kind` állapotra a Liquid szintaxisban a where paranccsal, vagy ciklus és egy beágyazott `if` feltétel segítségével, ahogy a következő példában látható. `{% 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`. Ezt változóként is definiálhatja a sablon elején, és többször is hivatkozhat rá, ahogy a következő példában látható. `{% 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-változók

LineItem-változó
Változó a régi Order Printer alkalmazásban	Változó az új Shopify Order Printer alkalmazásban
`fulfillable_quantity`	`quantity - successfully_fulfilled_quantity`
`fulfilled`	`quantity == successfully_fulfilled_quantity`
`name`	`title`
`product_title`	`product.title`
`unit_discount`	`quantity ? line_level_total_discount / quantity : 0`
`variant_title`	`variant.title`
`weight`	`grams`

Teljesítési változók

Teljesítési változó
Változó a régi Order Printer alkalmazásban	Változó az új Shopify Order Printer alkalmazásban
`date`	`created_at`

Áruház változói

Áruház változó
Változó a régi Order Printer alkalmazásban	Változó az új Shopify Order Printer alkalmazásban
`owner`	`account_owner.name`
`address`	`shop.address.address1`
`address2`	`shop.address.address2`
`city`	`shop.address.city`
`country`	`shop.address.country`
`country_code`	`shop.address.country_code`
`province`	`shop.address.province`
`province_code`	`shop.address.province_code`
`zip`	`shop.address.zip`

Címváltozók

Címváltozó
Változó a régi Order Printer alkalmazásban	Változó az új Shopify Order Printer alkalmazásban
`latitude`	Ha az `address` változó a `location` attribútumból lett meghivatkozva, akkor a szélességi és hosszúsági fokok magán a `location` objektumon érhetők el.
`longitude`	Ha az `address` változó a `location` attribútumból lett meghivatkozva, akkor a szélességi és hosszúsági fokok magán a `location` objektumon érhetők el.

Visszatérítési változók

Visszatérítési változó
Változó a régi Order Printer alkalmazásban	Változó az új Shopify Order Printer alkalmazásban
`date`	Használja a `created_at` változót. Az időbélyeg formázásához használja a `date` szűrőt, például a következőképpen: `{{ order.created_at \| date: "%B %e, %Y" }}`.

ShippingLine-változók

ShippingLine-változó
Változó a régi Order Printer alkalmazásban	Változó az új Shopify Order Printer alkalmazásban
`current_price`	`price`
`price`	`original_price`

Tranzakciós változók

A következő tranzakciós változókat eltávolították, és nem helyettesíthetők a Shopify Order Printer alkalmazásban:

authorization
message
test

Változat-változók

Változat-változó
Változó a régi Order Printer alkalmazásban	Változó az új Shopify Order Printer alkalmazásban
`grams`	`weight`

Metamező-változók

Egy metamező eléréséhez meg kell adnia a metamező Namespace-ét, és nem szükséges a .value-t a változóhoz hozzáadnia. További információ a metamező-meghatározásokról.

Például a product.metafields.manufacturerid.value változó helyett használja a product.metafields.custom.manufacturerid változót.

Az egyes metamezők Namespace-értékeinek azonosításához tekintse meg a Shopify adminisztrációs felületén található Egyéni adatok oldalt. A metamező-meghatározások a hivatkozott objektumok – például termékek, változatok vagy rendelések – szerint vannak csoportosítva.

Szűrők megfeleltetése

Szűrők megfeleltetése
Szűrő neve a régi Order Printer alkalmazásban	Szűrő neve az új Shopify Order Printer alkalmazásban
`files_url`	`file_url`
`payment_method` és `payment_methods`	Használja a transaction.gateway_display_name mezőt a rendelési tranzakciókon. A fizetési módok már nincsenek meghatározott típusokba sorolva, mint például `{hitelkártya, betéti kártya, banki átutalás}`. A régi Order Printer alkalmazás a jelenleg működő fizetési átjáróknak csak egy kis részét feleltette meg ezeknek a kategóriáknak. A fizetési átjárók szolgáltatói a saját oldalukon kezelik a vásárlók által használt fizetési módok típusait.