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 앱으로 가져올 수 있습니다. 특정 템플릿은 가져올 수 없으며 모든 템플릿을 동시에 가져와야 합니다.

단계:

1. Shopify 관리자에서 설정 > 앱 및 판매 채널을 클릭합니다.
2. Order Printer을(를) 클릭합니다.

3. 앱 열기 를 클릭합니다.

4. 템플릿을 클릭합니다.

5. 가져오기를 클릭합니다.

6. 대화 상자에서 가져오기를 클릭합니다.

7. 템플릿에서 레거시 변수를 사용할지 여부를 검토한 다음 해당 변수를 새 변수로 교체합니다.

8. 템플릿을 미리 보고 템플릿이 올바르게 표시되는지 확인하세요.

9. 선택 사항: 테스트 문서를 인쇄합니다.

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	환불된 품목은 line_items 변수에 포함되지 않습니다. 다음 세부 정보를 검토하세요. refunds.<each>.refund_line_items 변수를 사용하여 환불된 품목에 액세스할 수 있습니다. 다음 예제를 검토하세요. {% assign refunded_line_items = refunds | map: "refund_line_items" | map: "line_item" %} 원하는 경우 환불된 품목을 line_items 컬렉션에 포함할 수 있습니다. 다음 예제를 검토하세요. {% 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 %} 환불된 품목의 중복을 방지하기 위해 | uniq 필터를 반드시 포함해야 합니다. 팁 품목은 line_items 변수에 포함되지 않습니다. 다음 세부 정보를 검토하세요. tip_line_items 변수를 사용하여 팁 품목에 액세스할 수 있습니다. 원하는 경우 tip_line_items를 line_items 컬렉션에 포함할 수 있습니다. 다음 예제를 검토하세요. {% assign line_items_with_tips = order.line_items | concat: order.tip_line_items %} 기존 Order Printer line_items 컬렉션을 모방하기 위해 다음 예제 코드를 사용할 수 있습니다. {% 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	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 또는 루프 및 if가 포함된 Liquid 구문에서 종류 상태에 대해 order.transactions를 필터링합니다. 다음 예제를 검토하세요. {% 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" %} 거래 ID: {{ transaction.id }} 종류: {{ transaction.kind }} 금액: {{ 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	다음 예시와 같이 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 변수

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 변수

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 앱은 현재 작동 중인 전자결제 대행사의 작은 하위 집합만 이 범주로 매핑했습니다. 전자결제 대행사 공급업체는 고객 측에서 사용하는 결제 방법 유형을 관리합니다.