Tài liệu xStore

Hướng dẫn phát triển giao diện storefront

HomeBox

Một khối sản phẩm theo danh mục ở trang chủ (biến toàn cục home_boxes).

Trường

Trường Kiểu Mô tả Từ phiên bản
category CategoryNode Danh mục của khối. Chỉ có id, title, slug, url và image_url; danh mục con nằm ở trường children của khối, KHÔNG ở category.children. 1.2
children CategoryNode[] Danh mục con dùng làm liên kết tắt trên đầu khối; rỗng nếu không có. 1.2
products Product[] Sản phẩm của khối; số lượng theo cài đặt home_box_product_count (4–24). Khối luôn có ít nhất một sản phẩm. 1.2

Mã đầy đủ

In ra mọi trường của HomeBox. Đổi home_box 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 HomeBox {% endcomment %}
{% if home_box.category %}
  {{ home_box.category.id }}
  {{ home_box.category.title }}
  {{ home_box.category.slug }}
  {{ home_box.category.url }}
  {{ home_box.category.image_url }}
  {% comment %} home_box.category.children: CategoryNode[] — xem trang CategoryNode {% endcomment %}
{% endif %}
{% for category_node in home_box.children %}
  {{ category_node.id }}
  {{ category_node.title }}
  {{ category_node.slug }}
  {{ category_node.url }}
  {{ category_node.image_url }}
  {% comment %} category_node.children: CategoryNode[] — xem trang CategoryNode {% endcomment %}
{% endfor %}
{% for product in home_box.products %}
  {% comment %} product.variants: Variant[] — xem trang Variant {% endcomment %}
  {% comment %} product.images: Image[] — xem trang Image {% endcomment %}
  {% 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 %}
  {% comment %} product.brand: Brand — xem trang Brand {% endcomment %}
  {% comment %} product.flash: FlashDeal — xem trang FlashDeal {% endcomment %}
  {% 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 %}
  {% comment %} product.specs: AttributeItem[] — xem trang AttributeItem {% endcomment %}
  {{ product.promotion_count }}
  {{ product.default_variant_id }}
  {{ product.effective_price | money }}
  {{ product.created_at | date_vi }}
{% endfor %}

Xuất hiện ở

Những trang dưới đây nhận sẵn một biến mang kiểu HomeBox.

Trang Biến Kiểu
home/index home_boxes HomeBox[]