Product
Một sản phẩm trong cửa hàng.
Trường
| Trường | Kiểu | Mô tả | Từ phiên bản |
|---|---|---|---|
variants |
Variant[] |
Biến thể của sản phẩm. CHỈ có ở API /public/v1 (chi tiết sản phẩm); Liquid lấy qua một lời gọi riêng. | 1.2 |
images |
Image[] |
Ảnh sản phẩm, ảnh chính đứng đầu. CHỈ có ở API /public/v1 (chi tiết sản phẩm). | 1.2 |
category_ids |
string[] |
Mã các danh mục chứa sản phẩm. CHỈ có ở API /public/v1 (chi tiết sản phẩm). | 1.2 |
id |
string |
Mã sản phẩm. | 1.0 |
title |
string |
Tên sản phẩm. | 1.0 |
slug |
string |
Định danh dạng chữ; dùng để tra cứu, KHÔNG dùng để ghép đường dẫn. | 1.0 |
url |
string | null |
Đường dẫn riêng của sản phẩm. LUÔN kiểm tra null trước khi tạo liên kết. | 1.0 |
price |
integer | null |
Giá thấp nhất trong các phiên bản, đơn vị đồng. | 1.0 |
compare_at_price |
integer | null |
Giá gốc để gạch ngang; null nếu không giảm giá. | 1.0 |
cover_image_url |
string | null |
Ảnh đại diện, đã ghép sẵn tên miền lưu trữ. | 1.0 |
short_description |
string | null |
Mô tả ngắn. | 1.0 |
description |
string | null |
Mô tả đầy đủ dạng HTML. Chỉ có ở trang chi tiết. | 1.0 |
tags |
string[] |
Danh sách thẻ của sản phẩm. | 1.0 |
brand |
Brand | null |
Thương hiệu của sản phẩm. | 1.0 |
flash |
FlashDeal | null |
Thông tin giảm giá chớp nhoáng; chỉ có ở trang chủ và trang flash sale. | 1.0 |
metafields |
map<string, map<string, string>> |
Dữ liệu tuỳ chỉnh của sản phẩm, tra theo nhóm rồi tới khoá. CHỈ có ở trang chi tiết sản phẩm. | 1.1 |
sku |
string | null |
Mã SKU của phiên bản rẻ nhất; null khi phiên bản chưa đặt mã. | 1.2 |
rating_avg |
float | null |
Điểm đánh giá trung bình (1–5, làm tròn 1 chữ số); NULL khi chưa có đánh giá nào — luôn kiểm tra null trước khi tính sao, đừng để hiển thị thành 0 sao. | 1.2 |
review_count |
integer |
Số đánh giá đã duyệt; 0 khi chưa có. | 1.2 |
available_quantity |
integer |
Tồn khả dụng của cả sản phẩm = tồn kho trừ số đang giữ, cộng trên mọi phiên bản đang bán. | 1.2 |
in_stock |
boolean |
true khi available_quantity > 0; dùng cho nhãn "Còn hàng" / "Hết hàng". | 1.2 |
specs |
AttributeItem[] |
Tối đa 4 thông số ngắn để in lên thẻ sản phẩm; rỗng khi sản phẩm chưa khai thông số. | 1.2 |
promotion_count |
integer |
Số khuyến mại đang áp dụng cho sản phẩm; 0 khi không có (dùng cho nhãn "N khuyến mại"). | 1.2 |
default_variant_id |
string | null |
Mã phiên bản để thêm thẳng vào giỏ từ thẻ sản phẩm. NULL khi sản phẩm có nhiều hơn một phiên bản — khi đó thẻ phải dẫn sang trang sản phẩm để khách tự chọn. | 1.2 |
effective_price |
integer | null |
Giá thực tế đã trừ khuyến mại, dùng để sắp xếp. CHỈ có giá trị khi đang sắp theo giá (sort=price_asc/price_desc), ngoài ra là null — để hiển thị hãy dùng price. | 1.2 |
created_at |
string | null |
Thời điểm tạo sản phẩm (UTC), dùng cho nhãn "Hàng mới về". Dùng bộ lọc date_vi để hiển thị. | 1.2 |
Mã đầy đủ
In ra mọi trường của Product. Đổi product thành tên biến thật của trang bạn đang viết — xem mục Xuất hiện ở bên dưới.
{% comment %} Đối tượng Product {% endcomment %}
{% for variant in product.variants %}
{{ variant.id }}
{{ variant.sku }}
{{ variant.title }}
{{ variant.label }}
{% for entry in variant.option_values %}{{ entry[0] }}: {{ entry[1] }}{% endfor %}
{{ variant.price | money }}
{{ variant.compare_at_price | money }}
{{ variant.stock_quantity }}
{% if variant.is_active %}…{% endif %}
{% endfor %}
{% for image in product.images %}
{{ image.id }}
{{ image.url }}
{{ image.alt_text }}
{% if image.is_primary %}…{% endif %}
{{ image.sort_order }}
{% endfor %}
{% for item in product.category_ids %}{{ item }}{% endfor %}
{{ product.id }}
{{ product.title }}
{{ product.slug }}
{{ product.url }}
{{ product.price | money }}
{{ product.compare_at_price | money }}
{{ product.cover_image_url }}
{{ product.short_description }}
{{ product.description }}
{% for item in product.tags %}{{ item }}{% endfor %}
{% if product.brand %}
{{ product.brand.id }}
{{ product.brand.title }}
{{ product.brand.slug }}
{{ product.brand.logo_url }}
{% endif %}
{% if product.flash %}
{{ product.flash.deal_price | money }}
{{ product.flash.ends_at | date_vi }}
{{ product.flash.remaining }}
{% endif %}
{% for entry in product.metafields %}{{ entry[0] }}: {{ entry[1] }}{% endfor %}
{{ product.sku }}
{{ product.rating_avg }}
{{ product.review_count }}
{{ product.available_quantity }}
{% if product.in_stock %}…{% endif %}
{% for attribute_item in product.specs %}
{{ attribute_item.title }}
{{ attribute_item.value }}
{% endfor %}
{{ product.promotion_count }}
{{ product.default_variant_id }}
{{ product.effective_price | money }}
{{ product.created_at | date_vi }}
Xuất hiện ở
Những trang dưới đây nhận sẵn một biến mang kiểu Product.
| Trang | Biến | Kiểu |
|---|---|---|
home/index |
featured_products |
Product[] |
home/index |
flash_deals |
Product[] |
product/index |
products |
Product[] |
product/detail |
product |
Product |
product/detail |
related_products |
Product[] |
product/category |
products |
Product[] |
product/collection-detail |
products |
Product[] |
product/search |
products |
Product[] |
product/flash-sale |
products |
Product[] |