Migracja z aplikacji Order Printer do Shopify Order Printer

Jeśli masz niestandardowe szablony w starszej aplikacji Order Printer, musisz dokonać migracji szablonów do aplikacji Shopify Order Printer.

Aby przeprowadzić migrację szablonów, możesz zaimportować istniejące szablony do aplikacji Shopify Order Printer. Implementacja nowej aplikacji Shopify Order Printer przebiega nieco inaczej niż w przypadku aplikacji Order Printer. Oznacza to, że niektóre z istniejących szablonów mogą początkowo nie działać i konieczne może być dostosowanie kodu szablonu.

Aby szablony działały w nowej aplikacji, musisz zastąpić starsze zmienne nowymi. Na przykład, jeśli używasz zmiennej date, musisz zastąpić ją zmienną created_at.

Na tej stronie znajdziesz listę zmiennych, które mogą wymagać zastąpienia nowymi zmiennymi w aplikacji Shopify Order Printer.

Na tej stronie

Informacje dotyczące migracji istniejących szablonów

Przed migracją istniejących szablonów do aplikacji Shopify Order Printer zapoznaj się z następującymi zagadnieniami:

Migracja istniejących szablonów wymaga znajomości języka HTML, CSS i Liquid. Pomoc techniczna ds. szablonów Shopify może zapewnić wsparcie przy niewielkich korektach objętych Polityką Shopify w zakresie projektowania.
Zapoznaj się z informacją o zmiennych i filtrach Liquid dla Shopify Order Printer na potrzeby wszystkich obsługiwanych dostosowań szablonów.
Jeśli istniejące szablony korzystają z niestandardowego CSS, musisz ręcznie przenieść i dostosować kod w nowej aplikacji.
Aby uzyskać dostęp do zmiennych zamówienia w aplikacji Shopify Order Printer, musisz dodać prefiks zamówienia.
Podczas importowania szablonów metapola nie są importowane. Może być konieczne przeprowadzenie ręcznej migracji szablonów zawierających metapola.

Migracja istniejących szablonów do aplikacji Shopify Order Printer

Jeśli masz szablony ze starszej aplikacji Order Printer, możesz je zaimportować do aplikacji Shopify Order Printer. Nie możesz importować konkretnych szablonów; możesz importować tylko wszystkie szablony w tym samym czasie.

Kroki:

W panelu administracyjnym Shopify przejdź do opcji: Ustawienia > Aplikacje i kanały sprzedaży.
Kliknij Order Printer.
Kliknij opcję Otwórz aplikację.
Kliknij Szablony.
Kliknij Importuj.
W oknie dialogowym kliknij opcję Importuj.
Sprawdź, czy w Twoich szablonach używane są starsze zmienne, a następnie zastąp je nowymi zmiennymi.
Wyświetl podgląd szablonów i upewnij się, że wyświetlają się prawidłowo.
Opcjonalnie: Wydrukuj dokumenty testowe.

Korzystanie ze zmiennych zamówienia w aplikacji Shopify Order Printer

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.

Mapowanie zmiennych

Aplikacja Shopify Order Printer wykorzystuje inne zmienne niż starsza aplikacja Order Printer. Jeśli Twoje istniejące szablony wykorzystują dowolną ze zmiennych wymienionych w tej sekcji, musisz zastąpić stare zmienne nowymi.

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

Zmienne zamówienia

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.