Liquid 필터

필터는 값이 출력되는 방식을 바꿉니다. 값 뒤에 파이프를 붙여 추가합니다: {{ total_price | money }}. 여러 필터를 이어서 쓸 수 있습니다: {{ note | escape | newline_to_br }}. Foliant는 Liquid의 표준 필터(escape, default, upcase, date, plus, minus, split, join, newline_to_br 등)를 지원하며, 아래 필터를 추가로 제공합니다.

금액

필터	예시	기능
`money`	`{{ total_price \| money }}`	센트 단위 금액을 주문 통화로 표시합니다
`money_with_currency`	`{{ total_price \| money_with_currency }}`	위와 같으며, 통화 코드를 함께 표시합니다(`$1.00 USD`)
`money_without_currency`	`{{ total_price \| money_without_currency }}`	숫자만 표시합니다(`1.00`)
`money_without_trailing_zeros`	`{{ 10000 \| money_without_trailing_zeros }}`	`.00`을 생략합니다(`$100`)
`money_in`	`{{ amount \| money_in: 'EUR' }}`	지정한 통화로 금액을 표시합니다

템플릿의 금액과 통화를 참고하세요.

날짜와 문구

필터	예시	기능
`date`	`{{ created_at \| date: '%d %B %Y' }}`	날짜 형식을 지정하며, 월과 요일 이름은 문서 언어로 표시합니다. 다른 언어를 쓰려면 언어를 추가하세요: `date: '%B', customer_locale`.
`t`(`translate`, `label`도 가능)	`{{ 'subtotal' \| t }}`	Foliant의 문구를 문서 언어로 표시합니다
`t_both`	`{{ 'titles.invoice' \| t_both }}`	문구를 문서 언어와 두 번째 언어로 함께 표시합니다(“Rechnung / Invoice”)
`labelled`	`{{ shop.vat_number \| labelled: 'vat_number', ' · ' }}`	레이블 뒤에 값을 표시합니다(” · VAT number NL…”). 값이 비어 있으면 아무것도 표시하지 않습니다

날짜, 언어 및 번역을 참고하세요.

주소, 이미지 및 링크

필터	예시	기능
`format_address`	`{{ shipping_address \| format_address }}`	Shopify와 같은 방식으로 주소를 여러 줄로 배치합니다
`img_url`	`{{ line_item.image \| img_url: '120x120' }}`	지정한 크기의 Shopify 이미지입니다: `'thumb'`, `'small'`, `'medium'`, `'large'` 또는 `'120x120'`
`img_tag`	`{{ line_item.image \| img_url: 'thumb' \| img_tag }}`	이미지 주소에 대한 `<img>` 태그입니다. 대체 텍스트와 클래스를 선택적으로 지정할 수 있습니다: `img_tag: 'Logo', 'logo'`
`link_to`	`{{ 'Track your order' \| link_to: order_status_url }}`	링크를 만듭니다

바코드와 QR 코드

필터	예시	기능
`barcode`	`{{ line_item.sku \| barcode }}`	바코드를 만듭니다(`'ean13'`처럼 유형을 지정하지 않으면 Code 128)
`qr`	`{{ order_status_url \| qr }}`	QR 코드를 만듭니다

바코드와 QR 코드를 참고하세요.

숫자와 텍스트

필터	예시	기능
`weight_with_unit`	`{{ line_item.grams \| weight_with_unit }}`	그램 단위 무게를 단위와 함께 표시합니다: 그램으로, 1,000g부터는 킬로그램으로 표시합니다. 변환하려면 단위를 지정하세요: `weight_with_unit: 'lb'`(`kg`, `g`, `lb` 또는 `oz`)
`format_number`	`{{ 1234.5 \| format_number: 2 }}`	문서 언어의 구분 기호로 숫자를 표시합니다(독일어에서는 `1.234,50`)
`number_with_precision`	`{{ 1.2345 \| number_with_precision: 2 }}`	지정한 소수 자릿수로 숫자를 표시합니다(`1.23`)
`pluralize`	`{{ item_count \| pluralize: 'item', 'items' }}`	개수에 따라 단수형 또는 복수형 단어를 표시합니다
`handleize`	`{{ 'Hello World!' \| handleize }}`	`hello-world`
`strip_html`	`{{ product.description \| strip_html }}`	HTML 태그를 제거합니다
`truncate_words`	`{{ product.description \| truncate_words: 20 }}`	텍스트를 지정한 단어 수로 줄입니다
`default_value`	`{{ po_number \| default_value: 'N/A' }}`	값이 비어 있을 때 대신 표시할 값입니다
`json`	`{{ shipping_address \| json }}`	값을 데이터로 표시하여 템플릿을 만드는 동안 내용을 확인할 수 있습니다

색상

필터	예시	기능
`color_mix`	`{{ shop_accent_color \| color_mix: '#ffffff', 20 }}`	두 색상을 섞습니다: 첫 번째 색상이 20%입니다
`color_contrast`	`{{ shop_accent_color \| color_contrast: '#ffffff' }}`	두 색상 간의 명암비입니다(1–21)

스니펫

두 가지 기본 제공 스니펫으로 표준 VAT 섹션을 출력합니다.

{% include 'vat_breakdown' %}: 세율별 VAT 내역 표입니다.
{% include 'legal_notes' %}: VAT 법적 고지입니다(역과세, 수출, IOSS 등).

세금 및 법률을 참고하세요.

알아두기

코드 편집기는 알 수 없는 필터에 경고를 표시합니다. 경고가 보이면 미리보기를 확인하세요.
Shopify 스토어프런트 테마의 일부 필터는 문서에서 사용할 수 없습니다. 위의 필터와 Liquid 표준 필터만 사용하세요.

환영합니다

시작하기

인쇄

템플릿

템플릿 편집기

디자인

PDF 전송

이메일 템플릿

고객 계정

내보내기

인보이스 및 번호 매기기

세금 및 법률 정보

연동

결제 및 요금제

설정

문제 해결

법적 고지

금액

날짜와 문구

주소, 이미지 및 링크

바코드와 QR 코드

숫자와 텍스트

색상

스니펫

알아두기

관련 문서