- 简介
- shop
- linklists
- link
- customer
- customer_level
- order
- payment
- shipment
- line_item
- tracker
- discount_record
- refund_record
- address
- area
- product
- image
- variant
- type
- vendor
- discount
- discount_off
- page
- page_snippet
- search
- pagination
- part
- situation
- item
- sort
- stock_avail
- form
- blog
- blog_author
- blog_tag
- social_account
- post
- post_tag
- post_dir
product
对象product
用于显示商品详情。
可以调用product
对象的页面:
页面 | 路径 | 对象 | 主题文件 |
---|---|---|---|
商品列表 | /products | products | 查看 |
分类商品列表页面 | /types/[handle] | products | 查看 |
品牌商品列表页面 | /vendors/[handle] | products | 查看 |
优惠商品列表页面 | /discounts/[handle] | products | 查看 |
自定义页面 | /pages/[handle] | page_snippet.products | 查看 |
所有页面的pages 中 |
- | page_snippet.products | - |
商品详情页面 | /products/[handle] | product | 查看 |
对象product
,包含以下属性:
- product.handle
- product.name
- product.short_desc
- product.content_id
- product.content_html
- product.price_varies
- product.price
- product.price_max
- product.price_min
- product.compare_price_varies
- product.compare_price_max
- product.compare_price_min
- product.available
- product.sale
- product.page_url
- product.page_title
- product.page_desc
- product.page_keywords
- product.feature_image
- product.images
- product.options
- product.variants
- product.types
- product.vendor
- product.video_url
- product.video_cover_url
- product.metas
对象option
,包含以下属性(为product.options
数组内的元素):
product.handle
商品编号,系统生成的唯一标识 。 例如: p000001。
product.name
商品名称。
product.short_desc
商品简介。
product.content_id
商品描述富文本文档id
。
可调用 content_html方法 获取具体内容,获取后即为product.content_html
。
product.content_html
商品描述富文本。
product.price_varies
商品售价是否有多个售价:
- true:有
- false:无
product.price
商品售价(实际销售价格) 。
当 product.price_varies
为 true
时,product.price
等于 product.price_min
以分为单位的整型数值,可调用 money方法 格式化显示。
product.price_max
商品最高售价(实际销售价格) 。 以分为单位的整型数值,可调用 money方法 格式化显示。
product.price_min
商品最低售价(实际销售价格)。
以分为单位的整型数值,可调用 money方法 格式化显示。
product.compare_price_varies
商品原价是否有多个原价:
- true:有
- false:无
product.compare_price_max
商品最高原价。
product.compare_price_min
商品最低原价。
product.available
商品是否可售:
- true:表示商品至少有一个种类库存可售
- false:表示商品没有可售的种类
product.sale
商品销量。
product.page_url
商品链接地址。
product.page_title
商品页面标题,用于 SEO 优化。
product.page_desc
商品页面描述,用于 SEO 优化。
product.page_keywords
商品页面网页关键词,用于 SEO 优化。
product.feature_image
商品封面图片对象 。 可使用 product_image_url方法 生成图片链接地址。
product.images
商品包含的图片列表,类型为数组。
输入:
{% for image in product.images %}
<img src="{{ image | product_image_url: 330, 330 }}" alt="{{ product.name }}">
{% endfor %}
输出:
<img src="//asset.youhaosuda.com/image/53fe27c44321305f73000010/1_330x330.jpg" alt="衣服">
<img src="//asset.youhaosuda.com/image/53fe27c44321305f73000010/2_330x330.jpg" alt="腰带">
<img src="//asset.youhaosuda.com/image/53fe27c44321305f73000010/3_330x330.jpg" alt="裤子">
product.options
商品包含的选项列表,类型为数组,详见下方 option 的属性描述。
输入:
{% for option in product.options %}
{{ option.name }}
{% endfor %}
输出:
颜色 尺寸 材料
product.variants
商品包含的种类列表 。 例如:【XL,白色】和【XXL,白色】是两种不同的种类,类型为数组。
product.types
商品所属的商品分类列表,类型为数组 。 例如:T-Shirt 或上衣等。
product.vendor
商品所属的商品品牌对象,类型为对象 。 例如:Gap、H&M 等。
product.video_url
主图视频 URL
product.video_cover_url
主图视频封面 URL
product.metas
访问商品的 Metafield 数据。
option 属性描述
option.id
选项id。
option.name
选项名称,例如:尺寸。
option.position
商品属性排序,整型,从 1 开始。