Chuyển đến nội dung chính
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ã. Khung bên trái có ba thẻ: 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.
  • 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.
  • 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.
  • 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.

Bài viết liên quan