> ## 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.

# Siêu trường thông tin trong mẫu

> In siêu trường thông tin của đơn hàng, đơn hàng nháp, khách hàng, sản phẩm và mẫu mã trong mẫu, và đảm bảo Foliant tải những siêu trường thông tin bạn cần.

Siêu trường thông tin là dữ liệu tùy chỉnh mà bạn hoặc các ứng dụng của bạn lưu trong Shopify: lời nhắn quà tặng trên đơn hàng, nhãn hướng dẫn bảo quản trên sản phẩm, số tài khoản của khách hàng. Mẫu có thể in chúng bằng Liquid. Tab **Siêu trường thông tin** trong trình chỉnh sửa mã hiển thị cú pháp cho từng loại.

## Trước khi bắt đầu: kiểm tra những siêu trường thông tin Foliant tải

Foliant tải siêu trường thông tin cùng với đơn hàng, và không thể tải tất cả. Cách hoạt động như sau:

* Cửa hàng của bạn cần có ít nhất một **định nghĩa siêu trường** (trong trang quản trị Shopify, **Cài đặt › Dữ liệu tùy chỉnh**). Nếu không có định nghĩa nào, sẽ không có siêu trường thông tin nào được tải.
* Với mỗi loại (đơn hàng, đơn hàng nháp, khách hàng, sản phẩm và mẫu mã), Foliant tải các định nghĩa bạn đã **ghim**, tối đa 10 định nghĩa cho mỗi loại, theo thứ tự ghim.
* Nếu một loại không có định nghĩa nào được ghim, Foliant tải 10 siêu trường thông tin đầu tiên tìm thấy cho loại đó.

Vì vậy, để chắc chắn một siêu trường thông tin được in, bạn hãy tạo định nghĩa cho nó và ghim nó trong **Cài đặt › Dữ liệu tùy chỉnh**. Thay đổi về định nghĩa có thể mất đến một giờ mới hiển thị trong chứng từ.

## In một siêu trường thông tin

Thay `namespace` và `key` bằng namespace và key của siêu trường thông tin của bạn (ví dụ `custom.gift_message`):

| Siêu trường thông tin của | Liquid |
| - | - |
| Đơn hàng hoặc đơn hàng nháp | `{{ order.metafields.namespace.key }}` |
| Khách hàng | `{{ customer.metafields.namespace.key }}` |
| Một sản phẩm | `{{ line_item.product.metafields.namespace.key }}` |
| Một mẫu mã | `{{ line_item.variant.metafields.namespace.key }}` |

Siêu trường thông tin của sản phẩm và mẫu mã gắn với từng mặt hàng, nên bạn hãy dùng chúng bên trong vòng lặp mặt hàng:

```liquid theme={null}
{% 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 %}
```

## Cách các loại siêu trường thông tin được in

| Loại | Kết quả bạn nhận được |
| - | - |
| Văn bản, URL, ngày, màu… | Giá trị dưới dạng văn bản |
| Số nguyên, số thập phân | Một số mà bạn có thể so sánh hoặc tính toán |
| Đúng hoặc sai | `true` hoặc `false`, dùng cho `{% if %}` |
| Văn bản đa dạng thức | Văn bản, không có định dạng |
| Khối lượng, kích thước, thể tích | `.value` và `.unit`, ví dụ `{{ … .weight.value }} {{ … .weight.unit }}` |
| Tiền | `.value` (chẳng hạn `23.00`) và `.unit` (mã tiền tệ). Không tính bằng xu. |
| Đánh giá | `.value`, `.scale_min` và `.scale_max` |
| JSON, danh sách | Một danh sách hoặc đối tượng mà bạn có thể lặp qua |

## Cần biết

* Siêu trường thông tin trống hoặc không tồn tại sẽ không in ra gì. Bạn hãy dùng `!= blank` để bỏ nhãn của nó.
* Trong mẫu trực quan, bạn hãy in siêu trường thông tin bằng một khối **Liquid tùy chỉnh**.
* Danh sách lấy hàng có thể hiển thị siêu trường thông tin của sản phẩm hoặc mẫu mã dưới dạng cột, trong phần cài đặt **Danh sách lấy hàng** của mẫu.

## Bài viết liên quan

* [Mặt hàng trong mẫu](https://foliant-help.iforiti.com/vi/template-editor/liquid-line-items.md)
* [Thuộc tính đơn hàng và thuộc tính mặt hàng](https://foliant-help.iforiti.com/vi/template-editor/liquid-custom-fields.md)
* [Đối tượng đơn hàng và các biến thường dùng](https://foliant-help.iforiti.com/vi/template-editor/liquid-order-variables.md)
* [Chỉnh sửa mã của mẫu](https://foliant-help.iforiti.com/vi/template-editor/code-editor.md)


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