Order Printer 앱에서 Shopify Order Printer로 마이그레이션하기
기존 Order Printer 앱에 사용자 지정 템플릿이 있는 경우 템플릿을 Shopify Order Printer 앱으로 마이그레이션해야 합니다.
템플릿을 마이그레이션하기 위해 기존 템플릿을 Shopify Order Printer 앱으로 가져올 수 있습니다. 그러나 새로운 Shopify Order Printer 앱은 기존 Order Printer 앱과는 약간 다르게 구현됩니다. 즉, 일부 기존 템플릿이 초기에 작동하지 않을 수 있으며 템플릿 코드를 일부 조정해야 할 수 있습니다.
새 앱에서 템플릿이 작동하도록 하려면 기존 변수를 새 변수로 교체해야 합니다. 예를 들어, date
변수를 사용 중이라면 created_at
변수로 교체해야 합니다.
이 페이지에서는 Shopify Order Printer 앱에서 새 변수로 교체해야 할 변수 목록을 확인할 수 있습니다.
이 페이지의 정보
기존 템플릿 마이그레이션 시 고려 사항
기존 템플릿을 Shopify Order Printer 앱으로 마이그레이션하기 전에 다음 고려 사항을 검토하세요.
- 기존 템플릿을 마이그레이션하려면 HTML, CSS 및 Liquid에 익숙해야 합니다. Shopify 테마 지원팀에서는 Shopify 디자인 정책 범위 내에서 사소한 조정에 도움을 드립니다.
- 지원되는 모든 템플릿 사용자 지정은 Shopify Order Printer의 Liquid 변수 및 필터 참조를 검토하세요.
- 기존 템플릿에서 사용자 지정 CSS를 사용하는 경우 새 앱에서 코드를 수동으로 전송하고 조정해야 합니다.
- Shopify Order Printer 앱에서 주문 변수에 액세스하려면 주문 접두사를 추가해야 합니다.
- 기존 템플릿을 가져올 때 메타 필드는 가져오지 않습니다. 메타 필드가 포함된 템플릿을 수동으로 마이그레이션해야 할 수 있습니다.
기존 템플릿을 Shopify Order Printer 앱으로 마이그레이션
기존 Order Printer 앱에 기존 템플릿이 있는 경우 템플릿을 Shopify Order Printer 앱으로 가져올 수 있습니다. 특정 템플릿은 가져올 수 없으며 모든 템플릿을 동시에 가져와야 합니다.
단계:
- Shopify 관리자에서 설정 > 앱 및 판매 채널을 클릭합니다.
- Order Printer을(를) 클릭합니다.
앱 열기 를 클릭합니다.
템플릿을 클릭합니다.
가져오기를 클릭합니다.
대화 상자에서 가져오기를 클릭합니다.
템플릿을 미리 보고 템플릿이 올바르게 표시되는지 확인하세요.
선택 사항: 테스트 문서를 인쇄합니다.
Shopify Order Printer 앱에서 주문 변수 사용하기
주문 변수는 Shopify Order Printer 앱에서 다르게 사용됩니다. 주문 변수에 액세스하려면 order.
접두사를 추가해야 합니다. 예를 들어, billing_address
변수에 액세스하려면 order.billing_address
를 사용해야 합니다.
다음의 일반적으로 사용되는 여러 주문 변수는 order.
접두사 없이 액세스할 수 있습니다.
-
line_items
-
tax_lines
-
fulfillments
-
transactions
-
refunds
-
shipping_methods
-
customer
예를 들어, 품목 변수에 액세스하려는 경우 line_items
또는 order.line_items
를 사용할 수 있습니다.
템플릿에 나만의 별칭을 만들 수도 있습니다. 예를 들어, {% assign fulfillments_count = order.fulfillments | size %}
Liquid 구문을 사용한 다음 코드에서 {{ fulfillments_count }}
를 사용하여 참조할 수 있습니다.
변수 매핑
Shopify Order Printer 앱은 기존 Order Printer 앱에 다양한 변수를 사용합니다. 기존 템플릿이 이 섹션에 나열된 변수 중 하나를 사용하는 경우 기존 변수를 새 변수로 교체해야 합니다.
예를 들어, date
변수를 사용 중이라면 created_at
변수로 교체해야 합니다.
주문 변수
기존 Order Printer 앱의 변수 | 새로운 Shopify Order Printer 앱의 변수 |
---|---|
line_items |
|
credit_card |
transactions.<each>.payment_details 변수를 사용하여 주문의 각 거래를 기반으로 결제 세부 정보를 사용하세요. |
current_shipping_price |
shipping_price |
날짜 |
created_at 변수를 사용합니다. 날짜 필터를 사용하여 타임 스탬프의 형식을 지정합니다(예: {{ order.created_at | date: "%B %e, %Y" }} ). |
게이트웨이 |
unique_gateways 또는 transactions.<each>.gateway
|
order_currency |
통화 |
processed_at |
created_at 변수를 사용합니다. 해당 변수는 GraphQL API의 order.processed_at 값을 보유합니다. 즉 Shopify로 주문을 가져온 시간이 아니라 주문이 처리된 실제 시간을 의미합니다. 이는 기존 Order Printer 앱의 order.processed_at 과 동일합니다. 날짜 필터를 사용하여 타임 스탬프의 형식을 지정할 수 있습니다(예: {{ order.created_at | date: "%B %e, %Y" }} ). |
payment_transactions |
where 또는 루프 및
|
refund_transactions |
다음 예시와 같이 where 또는 루프 및 if 가 포함된 Liquid 구문에서 종류 상태에 대해 order.transactions 를 필터링합니다.{% 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 . 다음 예제와 같이 템플릿의 첫 부분에 변수로 정의하고 여러 번 참조할 수 있습니다.{% 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 변수
기존 Order Printer 앱의 변수 | 새로운 Shopify Order Printer 앱의 변수 |
---|---|
fulfillable_quantity |
quantity - successfully_fulfilled_quantity |
주문 처리됨 |
quantity == successfully_fulfilled_quantity |
이름 |
제목 |
product_title |
제품.이름 |
unit_discount |
quantity ? line_level_total_discount / quantity : 0 |
variant_title |
variant.title |
weight |
그램 |
주문 처리 변수
기존 Order Printer 앱의 변수 | 새로운 Shopify Order Printer 앱의 변수 |
---|---|
날짜 |
created_at |
상점 변수
기존 Order Printer 앱의 변수 | 새로운 Shopify Order Printer 앱의 변수 |
---|---|
소유자 |
account_owner.name |
주소 |
shop.address.address1 |
address2 |
shop.address.address2 |
city |
shop.address.city |
국가 |
shop.address.country |
country_code |
shop.address.country_code |
province |
shop.address.province |
province_code |
shop.address.province_code |
우편 번호 |
shop.address.zip |
주소 변수
기존 Order Printer 앱의 변수 | 새로운 Shopify Order Printer 앱의 변수 |
---|---|
위도 |
주소 변수가 위치 속성에서 참조된 경우, 위치 개체 자체에서 위도 및 경도를 사용할 수 있습니다. |
경도 |
주소 변수가 위치 속성에서 참조된 경우, 위치 개체 자체에서 위도 및 경도를 사용할 수 있습니다. |
환불 변수
기존 Order Printer 앱의 변수 | 새로운 Shopify Order Printer 앱의 변수 |
---|---|
날짜 |
created_at 변수를 사용합니다. 날짜 필터를 사용하여 타임 스탬프의 형식을 지정합니다(예: {{ order.created_at | date: "%B %e, %Y" }} ). |
ShippingLine 변수
기존 Order Printer 앱의 변수 | 새로운 Shopify Order Printer 앱의 변수 |
---|---|
current_price |
가격 |
가격 |
original_price |
거래 변수
다음 거래 변수가 제거되어 Shopify Order Printer 앱에서 교체할 수 없습니다.
-
authorization
-
message
-
test
이형 상품 변수
기존 Order Printer 앱의 변수 | 새로운 Shopify Order Printer 앱의 변수 |
---|---|
그램 |
weight |
메타 필드 변수
메타 필드에 액세스하려면 메타 필드의 네임스페이스를 지정해야 하며 변수에 .value
를 추가할 필요가 없습니다. 자세한 내용은 메타 필드 정의를 참조하세요.
예를 들어 product.metafields.manufacturerid.value
변수 대신 product.metafields.custom.manufacturerid
변수를 사용하세요.
각 메타 필드에 대한 네임스페이스 값을 식별하려면 Shopify 관리자의 사용자 지정 데이터 페이지를 참조하세요. 메타 필드 정의는 제품, 이형 상품 또는 주문과 같이 참조하는 개체로 그룹화됩니다.
필터 매핑
기존 Order Printer 앱의 필터 이름 | 새로운 Shopify Order Printer 앱의 필터 이름 |
---|---|
files_url |
file_url |
payment_method 및 payment_methods
|
transaction.gateway_display_name 필드를 주문 거래에 사용합니다. 결제 방법을 더 이상 {신용 카드, 직불 카드, 은행 송금} 등의 특정 유형으로 범주화할 수 없습니다. 기존 Order Printer 앱은 현재 작동 중인 전자결제 대행사의 작은 하위 집합만 이 범주로 매핑했습니다. 전자결제 대행사 공급업체는 고객 측에서 사용하는 결제 방법 유형을 관리합니다. |