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

# Chỉnh sửa mã của mẫu

> Chỉnh sửa Liquid, HTML và CSS của mẫu trong trình chỉnh sửa mã, chèn trường đơn hàng, dùng tài liệu tham khảo biến và sửa lỗi mã.

Trình chỉnh sửa mã cho bạn toàn quyền kiểm soát mẫu. Mẫu là HTML và CSS kèm Liquid, cùng ngôn ngữ mẫu mà Shopify dùng: `{{ order_name }}` in tên đơn hàng, `{% for line_item in line_items %}` lặp lại cho từng mặt hàng. Biến đơn hàng của Foliant theo cách đặt của Shopify Order Printer, nên phần lớn mẫu viết cho ứng dụng đó dùng được ngay. Trình chỉnh sửa mã có trên mọi gói.

## Mở trình chỉnh sửa mã

Mở mẫu trong trình chỉnh sửa và nhấp vào thẻ **Mã**. Mẫu mã mở trực tiếp tại đó. Với mẫu trực quan, trước tiên bạn sẽ thấy mã đã biên dịch; nhấp vào **Chỉnh sửa mã** để thay đổi. Xem [Chuyển giữa Trực quan và Mã](https://foliant-help.iforiti.com/vi/template-editor/visual-and-code-modes.md).

Khung bên trái có ba thẻ:

| Thẻ | Nội dung hiển thị |
| - | - |
| **Mã** | Mã của mẫu, có tô sáng cú pháp. Dòng và cột hiện tại hiển thị ở phía dưới. |
| **Biến Liquid** | Các biến và bộ lọc bạn có thể dùng, được nhóm lại (Biến chung, Chi tiết dòng mặt hàng, Chi tiết khách hàng…), kèm **Tìm trong tài liệu tham khảo**. |
| **Siêu trường thông tin** | Cách in siêu trường thông tin của đơn hàng, khách hàng, sản phẩm và mẫu mã. Xem [Siêu trường thông tin trong mẫu](https://foliant-help.iforiti.com/vi/template-editor/metafields.md). |

Khung bên phải là bản xem trước trực tiếp. Bản này cập nhật ngay sau khi bạn ngừng gõ.

## Chèn trường

1. Đặt con trỏ tại vị trí cần chèn trường.
2. Nhấp vào **Chèn trường**.
3. Tìm trường (ví dụ "tracking" hoặc "SKU") trong **Tìm trường** rồi nhấp vào trường đó.

Foliant chèn mã Liquid của trường tại con trỏ, ví dụ `{{ shipping_address.city }}`. Các trường của dòng mặt hàng, như `{{ line_item.sku }}`, chỉ hoạt động bên trong vòng lặp dòng mặt hàng: hãy chèn **Dòng mặt hàng** để có chính vòng lặp đó.

## Tìm trong mã

Nhấp vào nút tìm kiếm cạnh **Chèn trường** (hoặc nhấn ⌘F / Ctrl+F trong mã) để tìm văn bản trong mẫu.

## Lỗi mã

Trình chỉnh sửa kiểm tra mã trong lúc bạn gõ và đánh dấu vấn đề ở lề:

* **Lỗi** khiến bạn không lưu được và tạm dừng bản xem trước. Một `{{` hoặc `{%` chưa đóng là lỗi. Các lỗi được liệt kê trong biểu ngữ **Lỗi mã** phía trên trình chỉnh sửa, mỗi lỗi có nút **Đi tới dòng**.
* **Cảnh báo** chỉ ra những chỗ có thể sai nhưng không ngăn bạn lưu, ví dụ bộ lọc, thẻ hoặc đối tượng Liquid không xác định, thẻ HTML hoặc thuộc tính CSS không xác định, hoặc thẻ HTML chưa đóng.

Khi bạn lưu, Foliant cũng kiểm tra mẫu: Liquid phải đọc được, các thẻ HTML phải cân bằng, và SVG nội tuyến chỉ được chứa các phần tử vẽ. Nếu có lỗi, việc lưu thất bại và biểu ngữ **Cập nhật thất bại** liệt kê tối đa năm vấn đề, kèm số dòng nếu xác định được.

Nếu mẫu lưu được nhưng không hiển thị được bản xem trước, một biểu ngữ sẽ hiện thông báo của Liquid và số dòng, nếu xác định được.

## Viết mẫu tốt

* Giá trị tiền tính bằng xu: luôn in chúng bằng bộ lọc tiền, như `{{ total_price | money }}`. Xem [Tiền và tiền tệ trong mẫu](https://foliant-help.iforiti.com/vi/template-editor/liquid-money-and-currency.md).
* Dùng `| escape` cho văn bản do khách hàng nhập, như ghi chú và địa chỉ: `{{ note | escape }}`.
* Dùng `{{ 'subtotal' | t }}` cho câu chữ theo ngôn ngữ của chứng từ. Xem [Ngày, ngôn ngữ và bản dịch](https://foliant-help.iforiti.com/vi/template-editor/liquid-dates-and-languages.md).
* Dùng các đoạn mã có sẵn của Foliant cho VAT: `{% include 'vat_breakdown' %}` in bảng chi tiết VAT, và `{% include 'legal_notes' %}` in các ghi chú pháp lý (thuế đảo ngược, xuất khẩu, IOSS…).

## Lưu ý

* Nếu mẫu có đánh số (hóa đơn, giấy báo có hoặc báo giá) không in `document_number` ở đâu cả, Foliant sẽ thêm một dòng nhỏ ghi số đó ở cuối chứng từ. Xem [Số chứng từ trong mẫu](https://foliant-help.iforiti.com/vi/template-editor/liquid-document-numbers.md).
* Số trang và tiêu đề bảng lặp lại cho mẫu mã nằm trên trang cài đặt của mẫu, trong mục **Bố cục trang**.
* Để chuyển một mẫu từ Shopify Order Printer hoặc Order Printer Pro sang, hãy dùng **Nhập mẫu** trên trang Mẫu. Xem [Nhập mẫu từ Order Printer](https://foliant-help.iforiti.com/vi/templates/import-from-order-printer.md).

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

* [Đố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)
* [Bộ lọc Liquid](https://foliant-help.iforiti.com/vi/template-editor/liquid-filters.md)
* [Chuyển giữa Trực quan và Mã](https://foliant-help.iforiti.com/vi/template-editor/visual-and-code-modes.md)
* [Xem trước, khổ giấy và thu phóng](https://foliant-help.iforiti.com/vi/template-editor/preview-paper-and-zoom.md)


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