> ## Documentation Index
> Fetch the complete documentation index at: https://foliant-help.iforiti.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Liquid 필터

> Foliant가 금액, 날짜, 문구, 주소, 이미지, 바코드, 숫자, 색상용으로 추가하는 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' }}` | 지정한 통화로 금액을 표시합니다 |

[템플릿의 금액과 통화](https://foliant-help.iforiti.com/ko/template-editor/liquid-money-and-currency.md)를 참고하세요.

## 날짜와 문구

| 필터 | 예시 | 기능 |
| - | - | - |
| `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…"). 값이 비어 있으면 아무것도 표시하지 않습니다 |

[날짜, 언어 및 번역](https://foliant-help.iforiti.com/ko/template-editor/liquid-dates-and-languages.md)을 참고하세요.

## 주소, 이미지 및 링크

| 필터 | 예시 | 기능 |
| - | - | - |
| `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 코드](https://foliant-help.iforiti.com/ko/template-editor/liquid-barcodes-and-qr-codes.md)를 참고하세요.

## 숫자와 텍스트

| 필터 | 예시 | 기능 |
| - | - | - |
| `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 등).

[세금 및 법률](https://foliant-help.iforiti.com/ko/tax-and-legal.md)을 참고하세요.

## 알아두기

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

## 관련 문서

* [템플릿의 금액과 통화](https://foliant-help.iforiti.com/ko/template-editor/liquid-money-and-currency.md)
* [날짜, 언어 및 번역](https://foliant-help.iforiti.com/ko/template-editor/liquid-dates-and-languages.md)
* [바코드와 QR 코드](https://foliant-help.iforiti.com/ko/template-editor/liquid-barcodes-and-qr-codes.md)
* [주문 객체와 일반 변수](https://foliant-help.iforiti.com/ko/template-editor/liquid-order-variables.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.