템플릿의 메타필드 - Foliant Knowledge Base

메타필드는 직접 또는 앱이 Shopify에 저장하는 사용자 지정 데이터입니다. 주문의 선물 메시지, 제품의 관리 라벨, 고객의 계정 번호 등이 있습니다. 템플릿에서 Liquid로 메타필드를 출력할 수 있습니다. 코드 편집기의 메타필드 탭에서 종류별 구문을 확인할 수 있습니다.

시작하기 전에: Foliant가 불러오는 메타필드 확인하기

Foliant는 주문과 함께 메타필드를 불러오지만, 모든 메타필드를 불러올 수는 없습니다. 방식은 다음과 같습니다.

스토어에 메타필드 정의가 하나 이상 있어야 합니다(Shopify 관리자의 설정 › 사용자 지정 데이터). 정의가 하나도 없으면 메타필드를 불러오지 않습니다.
각 종류(주문, 임시 주문, 고객, 제품, 이형 상품)마다 Foliant는 고정한 정의를 종류당 최대 10개까지, 고정한 순서대로 불러옵니다.
고정한 정의가 없는 종류는 처음 찾은 메타필드 10개를 불러옵니다.

메타필드가 확실히 출력되도록 하려면 설정 › 사용자 지정 데이터에서 정의를 만들고 고정하세요. 정의 변경 사항이 문서에 반영되기까지 최대 1시간이 걸릴 수 있습니다.

메타필드 출력하기

namespace와 key를 메타필드의 네임스페이스와 키로 바꾸세요(예: custom.gift_message).

메타필드 대상	Liquid
주문 또는 임시 주문	`{{ order.metafields.namespace.key }}`
고객	`{{ customer.metafields.namespace.key }}`
제품	`{{ line_item.product.metafields.namespace.key }}`
이형 상품	`{{ line_item.variant.metafields.namespace.key }}`

제품 및 이형 상품 메타필드는 품목별로 다르므로 품목 반복문 안에서 사용하세요.

{% for line_item in line_items %}
  {{ line_item.title }}
  {% if line_item.product.metafields.custom.care_instructions != blank %}
    <br>{{ line_item.product.metafields.custom.care_instructions }}
  {% endif %}
{% endfor %}

메타필드 유형별 출력 방식

유형	출력 결과
텍스트, URL, 날짜, 색상 등	값이 텍스트로 출력됩니다
정수, 소수	비교하거나 계산할 수 있는 숫자입니다
참 또는 거짓	`{% if %}`에 사용할 수 있는 `true` 또는 `false`입니다
서식 있는 텍스트	서식이 없는 텍스트입니다
무게, 치수, 부피	`.value`와 `.unit`입니다. 예: `{{ … .weight.value }} {{ … .weight.unit }}`
금액	`.value`(예: `23.00`)와 `.unit`(통화 코드)입니다. 센트 단위가 아닙니다.
평점	`.value`, `.scale_min`, `.scale_max`입니다
JSON, 목록	반복할 수 있는 목록 또는 객체입니다

참고 사항

비어 있거나 없는 메타필드는 아무것도 출력하지 않습니다. 라벨을 생략하려면 != blank를 사용하세요.
시각적 템플릿에서는 사용자 지정 Liquid 블록으로 메타필드를 출력하세요.
피킹 목록에서는 템플릿의 피킹 목록 설정에서 제품 또는 이형 상품 메타필드를 열로 표시할 수 있습니다.

관련 문서