Biến toàn cục
Những biến dưới đây có mặt ở mọi trang, không cần khai báo gì thêm. Biến riêng của từng loại trang nằm ở Biến theo trang.
customlà biến của cửa hàng, do chủ cửa hàng tự thêm. Nếu bạn cần tuỳ chọn thuộc về bộ giao diện (màu sắc, số cột, bật/tắt khối), hãy dùng Thiết lập giao diện vớisettings.*.
Hai ngoại lệ cần nhớ
content và debug chỉ có trong theme.html — tệp khung bao ngoài. Đây là
nơi bạn đặt {{ content }} để chèn nội dung trang đã dựng. Trong một template
trang (ví dụ product/detail.html) hai biến này không tồn tại.
Trang thanh toán (checkout) không dùng bộ biến chung. Ở đó không có menus
và customer, còn store chỉ có mỗi trường name. Nếu giao diện của bạn dùng
chung một header.html cho mọi trang, hãy kiểm tra trước khi đọc:
{% if customer %}
<a href="/tai-khoan">{{ customer.name }}</a>
{% endif %}
Danh sách
| Biến | Kiểu | Mô tả | Ví dụ | Từ phiên bản |
|---|---|---|---|---|
custom |
map<string, string> |
Biến tuỳ chỉnh của cửa hàng, khai báo trong Quản trị → Website → Biến tuỳ chỉnh. | {{ custom.hotline }} |
1.0 |
settings |
map<string, string | boolean | integer> |
Thiết lập của bộ giao diện đang dùng, khai báo trong config/settings_schema.json và chỉnh trong Quản trị → Website → Giao diện. KHÔNG có ở trang checkout. | {{ settings.accent_color }} |
1.1 |
store |
StoreSettings |
Thông tin cửa hàng: tên, logo, liên hệ, mạng xã hội. Riêng trang checkout chỉ có store.name. | {{ store.name }} |
1.0 |
menus |
map<string, MenuItem[]> |
Các menu điều hướng đã cấu hình, tra theo mã menu. KHÔNG có ở trang checkout. | {% for item in menus.main %} |
1.0 |
nav_categories |
Category[] |
Danh mục gốc dùng cho thanh điều hướng chính. | {% for cat in nav_categories %} |
1.0 |
category_tree |
CategoryNode[] |
Cây danh mục hai cấp cho mega menu: danh mục gốc kèm danh sách danh mục con trong children. KHÔNG có ở trang checkout. | {% for cat in category_tree %}{{ cat.title }}{% for sub in cat.children %}{{ sub.title }}{% endfor %}{% endfor %} |
1.2 |
customer |
Customer | null |
Khách đang đăng nhập; null khi là khách vãng lai. KHÔNG có ở trang checkout. | {% if customer %}Chào {{ customer.name }}{% endif %} |
1.0 |
cart_count |
integer |
Tổng số sản phẩm đang có trong giỏ hàng của khách. | {{ cart_count }} |
1.0 |
content |
string |
HTML của trang đã dựng. CHỈ có trong theme.html, không có trong template trang. | {{ content }} |
1.0 |
head_injections |
string |
Mã chèn vào (GTM và script khai báo ở Quản trị → Website → Script). | {{ head_injections }} |
1.0 |
body_start_injections |
string |
Mã chèn ngay sau thẻ mở. | {{ body_start_injections }} |
1.0 |
body_end_injections |
string |
Mã chèn ngay trước thẻ . | {{ body_end_injections }} |
1.0 |
theme_preview |
boolean |
Trang đang được xem trước bằng liên kết ký số của một bộ giao diện chưa xuất bản. CHỈ có trong theme.html. | {% if theme_preview %}Bản xem trước{% endif %} |
1.1 |
debug |
boolean |
Đang ở chế độ gỡ lỗi hay không. CHỈ có trong theme.html. | {% if debug %}…{% endif %} |
1.0 |