Rozwiązywanie problemów z zaimportowanymi szablonami Order Printer

Podczas migracji szablonów ze starszej aplikacji Order Printer do nowej aplikacji Shopify Order Printer zmienne Liquid są uaktualniane w celu zapewnienia zgodności z nową aplikacją. W sporadycznych przypadkach może być konieczne rozwiązanie problemów z zaimportowanymi szablonami.

Jeśli zaimportowane szablony nie są drukowane poprawnie, konieczna może być ręczna edycja kodu szablonu w nowej aplikacji Shopify Order Printer. Zapoznaj się z najczęstszymi przyczynami, przez które importowanie pliku HTML może się nie powieść:

• Szablony zawierają niestandardowy kod CSS
• Szablony zawierają metapola
• Zmienne Liquid mogą nie uaktualniać się poprawnie

Na tej stronie można znaleźć szczegółowe informacje na temat rozwiązywania potencjalnych problemów podczas importowania niestandardowych szablonów do nowej aplikacji Shopify Order Printer.

Uaktualnianie typowych dostosowań projektu CSS

Jeśli przenoszone szablony zawierają niestandardowy kod CSS, może być konieczne ręczne uaktualnienie kodu CSS w szablonach, aby poprawnie wyświetlać elementy projektu, takie jak obrazy, czcionki niestandardowe, logo lub kody kreskowe.

Uwaga

Pomoc techniczna ds. szablonów Shopify może zapewnić wsparcie przy niewielkich dostosowaniach objętych Polityką Shopify w zakresie projektowania. W przypadku złożonych dostosowań rozważ zatrudnienie zewnętrznego projektanta.

• Dodaj logo do szablonu
• Dodaj obrazy do szablonu
• Ustaw szerokości tabeli na 100%
• Wyświetl miniatury produktów
• Dodaj szczegóły zamówienia
• Dodaj kod kreskowy do szablonu
• Dodaj kod QR do szablonu
• Użycie czcionki Google w szablonie
• Zwiększanie rozmiaru czcionki

Uaktualnianie zmiennych metapól

Aby uzyskać dostęp do metapola, należy określić przestrzeń nazw metapola i nie dodawać .value do zmiennej. Dowiedz się więcej o definicjach metapól.

Na przykład, zamiast zmiennejproduct.metafields.custom.manufacturerid.value , użyj product.metafields.custom.manufacturerid.

Aby zidentyfikować wartości przestrzeni nazw dla każdego metapola, zapoznaj się ze stroną Dane niestandardowe w panelu administracyjnym Shopify. Definicje metapól są pogrupowane według obiektów, do których się odwołują, takich jak produkty, warianty lub zamówienia.

Uaktualnianie wspólnych zmiennych Liquid

W większości przypadków zmienne Liquid są automatycznie uaktualniane podczas procesu migracji. Jeśli jednak szablony nie zostaną poprawnie poddane migracji i używasz którejkolwiek ze zmiennych wymienionych w tej sekcji, może być konieczne ręczne zastąpienie starych zmiennych nowymi. Aplikacja Shopify Order Printer wykorzystuje inne zmienne niż starsza aplikacja Order Printer.

Na przykład, jeśli używasz zmiennej date, musisz zastąpić ją zmienną created_at.

Zmienne zamówienia

Zmienne zamówienia są wykorzystywane inaczej w aplikacji Shopify Order Printer. Aby uzyskać dostęp do zmiennych zamówienia, musisz dodać prefiks order.. Na przykład, aby uzyskać dostęp do zmiennejbilling_address, musisz użyć order.billing_address.

Wymienione poniżej często używane zmienne zamówienia są dostępne bez prefiksu order.:

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

Na przykład, jeśli chcesz uzyskać dostęp do zmiennej pozycji pojedynczej, możesz użyć atrybutu line_items lub order.line_items.

Możesz także tworzyć własne aliasy dla swojego szablonu. Na przykład możesz użyć składni {% assign fulfillments_count = order.fulfillments | size %}Liquid, a następnie odwoływać się do niej za pomocą {{ fulfillments_count }} w Twoim kodzie.

Zmienna zamówienia

Zmienna w starszej aplikacji Order Printer	Zmienna w nowej aplikacji Shopify Order Printer
line_items	Pozycje ze zwrotem kosztów nie są uwzględniane w zmiennej line_items. Zapoznaj się z następującymi szczegółami: Możesz uzyskać dostęp do pozycji ze zwrotem kosztów za pomocą zmiennej refunds.<each>.refund_line_items . Zapoznaj się z poniższym przykładem. {% assign refunded_line_items = refunds | map: "refund_line_items" | map: "line_item" %} Możesz dołączyć pozycje ze zwrotem kosztów do kolekcji line_items, jeśli chcesz. Zapoznaj się z poniższym przykładem. {% 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 %} Musisz dołączyć filtr | uniq, aby uniknąć duplikowania pozycji ze zwrotem kosztów. Pozycje napiwku nie są uwzględniane w zmiennej line_items. Zapoznaj się z następującymi szczegółami: Możesz uzyskać dostęp do pozycji napiwków za pomocą zmiennej tip_line_items. Możesz dołączyć zmienną tip_line_items do kolekcji line_items, jeśli chcesz. Zapoznaj się z poniższym przykładem. {% assign line_items_with_tips = order.line_items | concat: order.tip_line_items %} Aby naśladować starszą kolekcję Order Printer line_items, możesz użyć poniższego przykładowego kodu. {% 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	Użyj szczegółów płatności na podstawie każdej transakcji z zamówienia ze zmienną transactions.<each>.payment_details .
current_shipping_price	shipping_price
date	Użyj zmiennej created_at. Użyj filtra date do sformatowania znacznika czasu, na przykład za pomocą {{ order.created_at | date: "%B %e, %Y" }}.
bramki	unique_gateways lub transactions.<each>.gateway
order_currency	waluta
processed_at	Użyj zmiennej created_at. Przechowuje wartość order.processed_at z interfejsu GRAPHQL API i oznacza rzeczywisty czas przetwarzania zamówienia, a nie czas importu zamówienia do Shopify. Jest taki sam jak order.processed_at z starszej aplikacji Order Printer. Możesz użyć filtra do date sformatowania sygnatury czasowej, na przykładza pomocą .
payment_transactions	Filtruj order.transactions dla statusu kind w składni Liquid za pomocą where lub za pomocą pętli i if w środku. Zapoznaj się z poniższymi przykładami. {% 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	Filtruj order.transactions dla statusu kind w składni Liquid za pomocą where lub za pomocą pętli i if w środku, jak w poniższym przykładzie. {% 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. Możesz zdefiniować ją jako zmienną na początku szablonu i odwoływać się do niej wielokrotnie, jak w poniższym przykładzie. {% 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

Zmienne LineItem

Zmienna LineItem

Zmienna w starszej aplikacji Order Printer	Zmienna w nowej aplikacji Shopify Order Printer
fulfillable_quantity	quantity - successfully_fulfilled_quantity
zrealizowane	ilość == successfully_fulfilled_quantity
nazwa	title
product_title	product.title
unit_discount	quantity ? line_level_total_discount / quantity : 0
variant_title	variant.title
waga	gramy

Zmienne realizacji

zmienna realizacji

Zmienna w starszej aplikacji Order Printer	Zmienna w nowej aplikacji Shopify Order Printer
date	created_at

Zmienne sklepu

Zmienna Shop

Zmienna w starszej aplikacji Order Printer	Zmienna w nowej aplikacji Shopify Order Printer
właściciel	account_owner.name
adres	shop.address.address1
address2	shop.address.address2
city	shop.address.city
kraj	shop.address.country
country_code	shop.address.country_code
province	shop.address.province
province_code	shop.address.province_code
pocztowy	shop.address.zip

Zmienne adresu

Zmienna adresu

Zmienna w starszej aplikacji Order Printer	Zmienna w nowej aplikacji Shopify Order Printer
szerokość geograficzna	Jeśli zmienna address została przywołana z atrybutu location, długość i szerokość geograficzna są dostępne w samym obiekcie location.
długość geograficzna	Jeśli zmienna address została przywołana z atrybutu location, długość i szerokość geograficzna są dostępne w samym obiekcie location.

Zmienne zwrotu kosztów

Zmienna zwrotu kosztów

Zmienna w starszej aplikacji Order Printer	Zmienna w nowej aplikacji Shopify Order Printer
date	Użyj zmiennej created_at. Użyj filtra date do sformatowania znacznika czasu, na przykład za pomocą {{ order.created_at | date: "%B %e, %Y" }}.

Zmienne ShippingLine

Zmienna ShippingLine

Zmienna w starszej aplikacji Order Printer	Zmienna w nowej aplikacji Shopify Order Printer
current_price	price
price	original_price

Zmienne transakcji

Poniższe zmienne transakcji zostały usunięte i nie można ich zastąpić w aplikacji Shopify Order Printer:

• authorization
• message
• test

Zmienne wariantu

zmienna wariantu

Zmienna w starszej aplikacji Order Printer	Zmienna w nowej aplikacji Shopify Order Printer
gramy	waga

Zmienne metapola

Aby uzyskać dostęp do metapola, należy określić przestrzeń nazw metapola i nie dodawać .value do zmiennej. Dowiedz się więcej o definicjach metapól.

Na przykład, zamiast zmiennejproduct.metafields.manufacturerid.value , użyj product.metafields.custom.manufacturerid.

Aby zidentyfikować wartości przestrzeni nazw dla każdego metapola, zapoznaj się ze stroną Dane niestandardowe w panelu administracyjnym Shopify. Definicje metapól są pogrupowane według obiektów, do których się odwołują, takich jak produkty, warianty lub zamówienia.

Mapowanie filtrów

Mapowanie filtrów

Filtruj nazwę w starszej aplikacji Order Printer	Filtruj nazwę w nowej aplikacji Shopify Order Printer
files_url	file_url
payment_method i payment_methods	Użyj pola transaction.gateway_display_name dla transakcji zamówienia. Metody płatności nie są już podzielone na określone typy, takie jak {karta kredytowa, karta debetowa, przelew bankowy}. Starsza aplikacja Order Printer mapowała tylko niewielki podzbiór obecnie działającej bramki płatniczej do tych kategorii. Dostawcy bramek płatniczych zarządzają typami metod płatności używanych przez klientów.