Migracja szablonów 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.

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:

1. W panelu administracyjnym Shopify kliknij Ustawienia > Aplikacje i kanały sprzedaży.

2. Na stronie Aplikacje i kanały sprzedaży kliknij Order Printer.

3. Kliknij opcję Otwórz aplikację.

4. Kliknij Szablony.

5. Kliknij opcję Importuj

6. W oknie dialogowym kliknij opcję Importuj.

7. Sprawdź, czy w Twoich szablonach używane są starsze zmienne, a następnie zastąp je nowymi zmiennymi.

8. Wyświetl podgląd szablonów i upewnij się, że wyświetlają się prawidłowo.

9. 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.