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[]