Riešenie problémov pre importované šablóny aplikácie Order Printer

Keď migrujete svoje šablóny zo staršej aplikácie Order Printer do novej aplikácie Shopify Order Printer, vaše premenné Liquid sa aktualizujú, aby sa zaistila kompatibilita s novou aplikáciou. V zriedkavých prípadoch možno budete musieť pri importovaných šablónach riešiť problémy.

Ak sa vaše importované šablóny netlačia správne, možno budete musieť manuálne upraviť kód šablóny v novej aplikácii Shopify Order Printer. Pozrite si nasledujúce najčastejšie dôvody, prečo sa šablóny nemusia importovať správne:

Šablóny obsahujú vlastné CSS
Šablóny obsahujú metapolia
Premenné Liquid sa nemusia aktualizovať správne

Na tejto stránke nájdete podrobné informácie o tom, ako riešiť potenciálne problémy pri importe vlastných šablón do novej aplikácie Shopify Order Printer.

Na tejto stránke

Aktualizácia bežných prispôsobení dizajnu CSS

Ak šablóny, ktoré prenášate, obsahujú vlastné CSS, možno budete musieť manuálne aktualizovať kód CSS vo svojich šablónach, aby sa správne zobrazovali prvky dizajnu, ako napríklad obrázky, vlastné písma, logá alebo čiarové kódy.

Aktualizácia premenných metapolí

Ak chcete získať prístup k metapoľu, musíte zadať menný priestor metapoľa, pričom do premennej nemusíte pridávať parameter .value. Získajte ďalšie informácie o definíciách metapolí.

Napríklad namiesto premennej product.metafields.custom.manufacturerid.value použite premennú product.metafields.custom.manufacturerid.

Hodnoty menného priestoru pre jednotlivé metapolia nájdete na stránke Vlastné údaje v administrátorovi Shopify. Definície metapolí sú zoskupené podľa objektov, na ktoré odkazujú, ako sú napríklad produkty, varianty alebo objednávky.

Aktualizácia bežných premenných Liquid

Vo väčšine prípadov sa vaše premenné Liquid automaticky aktualizujú počas procesu migrácie. Ak sa však vaše šablóny nenamigrujú správne a používate niektorú z premenných uvedených v tejto časti, možno budete musieť manuálne nahradiť staré premenné novými. Aplikácia Shopify Order Printer používa iné premenné ako staršia aplikácia Order Printer.

Ak napríklad používate premennú date, musíte ju nahradiť premennou created_at.

Premenné objednávky

Premenné objednávky sa v aplikácii Shopify Order Printer používajú inak. Na prístup k premenným objednávky musíte pridať predponu order.. Ak chcete napríklad získať prístup k premennej billing_address, musíte použiť order.billing_address.

K nasledujúcim bežne používaným premenným objednávky je možné pristupovať bez predpony order.:

line_items
tax_lines
fulfillments
transactions
refunds
shipping_methods
customer

Ak napríklad chcete získať prístup k premennej samostatných položiek, môžete použiť line_items alebo order.line_items.

Pre svoju šablónu si môžete vytvoriť aj vlastné aliasy. Môžete napríklad použiť syntax jazyka Liquid {% assign fulfillments_count = order.fulfillments | size %} a potom na ňu vo svojom kóde odkazovať pomocou {{ fulfillments_count }}.

Premenná objednávky
Premenná v staršej aplikácii Order Printer	Premenná v novej aplikácii Shopify Order Printer
`line_items`	Samostatné položky s vrátenými peniazmi nie sú zahrnuté v premennej `line_items` . Pozrite si nasledujúce podrobnosti: K vráteným samostatným položkám môžete získať prístup pomocou premennej `refunds.<each>.refund_line_items`. Pozrite si nasledujúci príklad. `{% assign refunded_line_items = refunds \| map: "refund_line_items" \| map: "line_item" %}` Ak chcete, môžete vrátené samostatné položky pripojiť do kolekcie `line_items`. Pozrite si nasledujúci príklad. `{% 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 %}` Uistite sa, že ste zahrnuli filter `\| uniq`, aby ste predišli duplikácii samostatných položiek s vrátenými peniazmi. Samostatné položky prepitného nie sú zahrnuté v premennej `line_items` . Pozrite si nasledujúce podrobnosti: K samostatným položkám prepitného môžete získať prístup pomocou premennej `tip_line_items`. Ak chcete, môžete `tip_line_items` pripojiť do kolekcie `line_items`. Pozrite si nasledujúci príklad. `{% assign line_items_with_tips = order.line_items \| concat: order.tip_line_items %}` Na napodobnenie kolekcie `line_items` staršej verzie Order Printer môžete použiť nasledujúci vzorový kód. `{% 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`	Použite podrobnosti o platbe založené na každej transakcii z objednávky s premennou `transactions.<each>.payment_details`.
`current_shipping_price`	`shipping_price`
`date`	Použite premennú `created_at`. Na formátovanie časovej pečiatky použite filter `date`, napríklad s hodnotou `{{ order.created_at \| date: "%B %e, %Y" }}`.
`gateways`	`unique_gateways` alebo `transactions.<each>.gateway`
`order_currency`	`currency`
`processed_at`	Použite premennú `created_at`. Obsahuje hodnotu `order.processed_at` z rozhrania API GraphQL a predstavuje skutočný čas spracovania objednávky, a nie čas importovania objednávky do platformy Shopify. Je to to isté ako `order.processed_at` zo staršej aplikácie Order Printer. Na formátovanie časovej pečiatky môžete použiť filter `date`, napríklad s hodnotou `{{ order.created_at \| date: "%B %e, %Y" }}`.
`payment_transactions`	Filtrujte `order.transactions` pre stav `kind` v syntaxi jazyka Liquid pomocou výrazu where alebo pomocou cyklu s vnoreným `if`. Pozrite si nasledujúce príklady. `{% 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`	V rámci `order.transactions` môžete filtrovať stav `kind` pomocou syntaxe Liquid so zápisom where alebo pomocou cyklu a vnorenej podmienky `if`, ako je to v nasledujúcom príklade. `{% 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`. Môžete to definovať ako premennú na začiatku šablóny a viackrát na ňu odkazovať, ako v nasledujúcom príklade. `{% 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`

Premenné LineItem

Premenná LineItem
Premenná v staršej aplikácii Order Printer	Premenná v novej aplikácii Shopify Order Printer
`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`

Premenné naplnenia

premenná naplnenia
Premenná v staršej aplikácii Order Printer	Premenná v novej aplikácii Shopify Order Printer
`date`	`created_at`

Premenné obchodu

Premenná obchodu
Premenná v staršej aplikácii Order Printer	Premenná v novej aplikácii Shopify Order Printer
`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`

Premenné adresy

Premenná adresy
Premenná v staršej aplikácii Order Printer	Premenná v novej aplikácii Shopify Order Printer
`latitude`	Ak sa na premennú `address` odkazovalo z atribútu `location`, tak zemepisná šírka a dĺžka sú dostupné priamo v objekte `location`.
`longitude`	Ak sa na premennú `address` odkazovalo z atribútu `location`, tak zemepisná šírka a dĺžka sú dostupné priamo v objekte `location`.

Premenné vrátenia peňazí

Premenná vrátenia peňazí
Premenná v staršej aplikácii Order Printer	Premenná v novej aplikácii Shopify Order Printer
`date`	Použite premennú `created_at`. Na formátovanie časovej pečiatky použite filter `date`, napríklad s hodnotou `{{ order.created_at \| date: "%B %e, %Y" }}`.

Premenné ShippingLine

Premenná ShippingLine
Premenná v staršej aplikácii Order Printer	Premenná v novej aplikácii Shopify Order Printer
`current_price`	`price`
`price`	`original_price`

Premenné transakcie

Nasledujúce premenné transakcie sa odstránili a v aplikácii Order Printer od Shopify ich nemožno nahradiť:

authorization
message
test

Premenné variantu

premenná variantu
Premenná v staršej aplikácii Order Printer	Premenná v novej aplikácii Shopify Order Printer
`grams`	`weight`

Premenné metapoľa

Ak chcete získať prístup k metapolu, musíte zadať jeho menný priestor (Namespace), pričom do premennej nemusíte pridávať .value. Ďalšie informácie o definíciách metapoľa.

Namiesto premennej product.metafields.manufacturerid.value použite napríklad premennú product.metafields.custom.manufacturerid.

Ak chcete identifikovať hodnoty menného priestoru (Namespace) pre každé metapole, pozrite si stránku Vlastné údaje v administrátorovi Shopify. Definície metapoľa sú zoskupené podľa objektov, na ktoré odkazujú, napríklad podľa produktov, variantov alebo objednávok.

Mapovanie filtrov

Mapovanie filtrov
Názov filtra v staršej aplikácii Order Printer	Názov filtra v novej aplikácii Order Printer od Shopify
`files_url`	`file_url`
`payment_method` a `payment_methods`	Použite pole transaction.gateway_display_name v transakciách objednávky. Spôsoby platby už nie sú kategorizované do konkrétnych typov, ako napríklad `{credit card, debit card, bank transfer}`. Staršia aplikácia Order Printer mapovala na tieto kategórie iba malú podmnožinu aktuálne fungujúcich platobných brán. Poskytovatelia platobných brán spravujú typy spôsobov platby, ktoré zákazníci používajú na ich strane.