가져온 Order Printer 템플릿 문제 해결하기
레거시 Order Printer 앱에서 새로운 Shopify Order Printer 앱으로 템플릿을 마이그레이션하면 새 앱과의 호환성을 위해 Liquid 변수가 업데이트됩니다. 드물게 가져온 템플릿의 문제를 해결해야 할 수도 있습니다.
가져온 템플릿이 올바르게 인쇄되지 않는 경우 새 Shopify Order Printer 앱에서 템플릿 코드를 수동으로 편집해야 할 수 있습니다. 다음은 템플릿을 올바르게 가져오지 못할 수 있는 가장 일반적인 이유입니다.
- 템플릿에 사용자 지정 CSS 포함
- 템플릿에 메타 필드 포함
- Liquid 변수가 올바르게 업데이트되지 않을 수 있음
이 페이지에서는 사용자 지정 템플릿을 새 Shopify Order Printer 앱으로 가져올 때 발생할 수 있는 잠재적 문제를 해결하는 방법에 대한 자세한 정보를 찾을 수 있습니다.
일반적인 CSS 디자인 맞춤 설정 업데이트
전송하는 템플릿에 사용자 지정 CSS가 포함된 경우, 이미지, 커스텀 폰트, 로고 또는 바코드와 같은 디자인 요소를 올바르게 표시하려면 템플릿의 CSS 코드를 수동으로 업데이트해야 할 수 있습니다.
메타 필드 변수 업데이트
메타 필드에 액세스하려면 메타 필드의 네임스페이스를 지정해야 하며 변수에 .value를 추가할 필요가 없습니다. 메타 필드 정의에 대해 자세히 알아보십시오.
예를 들어 product.metafields.custom.manufacturerid.value 변수 대신 product.metafields.custom.manufacturerid 변수를 사용하십시오.
각 메타 필드의 네임스페이스 값을 확인하려면 Shopify 관리자의 사용자 지정 데이터 페이지를 참조하십시오. 메타 필드 정의는 제품, 이형 상품, 주문 등 참조하는 개체별로 그룹화됩니다.
일반적인 Liquid 변수 업데이트
대부분의 경우 Liquid 변수는 마이그레이션 프로세스 중에 자동으로 업데이트됩니다. 하지만 템플릿이 올바르게 마이그레이션되지 않고 이 섹션에 나열된 변수를 사용하는 경우 이전 변수를 새 변수로 수동으로 바꿔야 할 수 있습니다. Shopify Order Printer 앱은 레거시 Order Printer 앱과 다른 변수를 사용합니다.
예를 들어 date 변수를 사용하는 경우 created_at 변수로 바꿔야 합니다.
주문 변수
주문 변수는 Shopify Order Printer 앱에서 다르게 사용됩니다. 주문 변수에 액세스하려면 order. 접두사를 추가해야 합니다. 예를 들어 billing_address 변수에 액세스하려면 order.billing_address를 사용해야 합니다.
다음의 일반적으로 사용되는 주문 변수는 order. 접두사 없이 액세스할 수 있습니다.
line_itemstax_linesfulfillmentstransactionsrefundsshipping_methodscustomer
예를 들어 품목 변수에 액세스하려면 line_items 또는 order.line_items를 사용할 수 있습니다.
템플릿에 대한 자신만의 별칭을 만들 수도 있습니다. 예를 들어 {% assign fulfillments_count = order.fulfillments | size %} Liquid 구문을 사용한 다음 코드에서 {{ fulfillments_count }}를 사용하여 참조할 수 있습니다.
| 레거시 Order Printer 앱의 변수 | 새 Shopify Order Printer 앱의 변수 |
|---|---|
line_items |
|
credit_card | transactions.<each>.payment_details 변수를 사용하여 주문의 각 거래에 대한 결제 세부 정보를 사용하십시오. |
current_shipping_price | shipping_price |
date | created_at 변수를 사용하십시오. 예를 들어 {{ order.created_at | date: "%B %e, %Y" }}와 같이 date 필터를 사용하여 타임스탬프의 서식을 지정하십시오. |
gateways | unique_gateways 또는 transactions.<each>.gateway |
order_currency | currency |
processed_at | created_at 변수를 사용하십시오. GraphQL API의 order.processed_at 값을 포함하며, 주문이 Shopify로 가져온 시간이 아닌 주문이 처리된 실제 시간을 의미합니다. 레거시 Order Printer 앱의 order.processed_at와 동일합니다. date 필터를 사용하여 타임스탬프의 서식을 지정할 수 있습니다(예: {{ order.created_at | date: "%B %e, %Y" }}). |
payment_transactions |
where를 사용하거나 루핑 및 내부
|
refund_transactions | 다음 예시와 같이 where를 사용한 Liquid 구문 또는 루프와 내부 if를 사용하여 order.transactions에서 kind 상태를 필터링합니다.{% 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 |
fulfilled | quantity == successfully_fulfilled_quantity |
name | title |
product_title | product.title |
unit_discount | quantity ? line_level_total_discount / quantity : 0 |
variant_title | variant.title |
weight | grams |
주문 처리 변수
| 레거시 Order Printer 앱의 변수 | 새 Shopify Order Printer 앱의 변수 |
|---|---|
date | created_at |
Shop 변수
| 레거시 Order Printer 앱의 변수 | 새 Shopify Order Printer 앱의 변수 |
|---|---|
owner | account_owner.name |
address | shop.address.address1 |
address2 | shop.address.address2 |
city | shop.address.city |
country | shop.address.country |
country_code | shop.address.country_code |
province | shop.address.province |
province_code | shop.address.province_code |
zip | shop.address.zip |
주소 변수
| 레거시 Order Printer 앱의 변수 | 새 Shopify Order Printer 앱의 변수 |
|---|---|
latitude | address 변수가 location 특성에서 참조된 경우 위도 및 경도는 location 개체 자체에서 사용할 수 있습니다. |
longitude | address 변수가 location 특성에서 참조된 경우 위도 및 경도는 location 개체 자체에서 사용할 수 있습니다. |
환불 변수
| 레거시 Order Printer 앱의 변수 | 새 Shopify Order Printer 앱의 변수 |
|---|---|
date | created_at 변수를 사용하십시오. 예를 들어 {{ order.created_at | date: "%B %e, %Y" }}와 같이 date 필터를 사용하여 타임스탬프의 서식을 지정하십시오. |
ShippingLine 변수
| 레거시 Order Printer 앱의 변수 | 새 Shopify Order Printer 앱의 변수 |
|---|---|
current_price | price |
price | original_price |
거래 변수
다음 거래 변수는 제거되었으며 Shopify Order Printer 앱에서 바꿀 수 없습니다.
authorizationmessagetest
이형 상품 변수
| 레거시 Order Printer 앱의 변수 | 새 Shopify Order Printer 앱의 변수 |
|---|---|
grams | 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 앱은 현재 작동하는 전자결제 대행사의 일부만 이러한 범주에 매핑했습니다. 전자결제 대행사 제공업체는 고객이 사용하는 결제 방법 유형을 자체적으로 관리합니다. |