组件文档 · 商品与分类
这两个区块里没有内容，
只有指向后台的指针
另外九个区块的字都要你自己填，改一次变一次。这两个不存内容： 它们指向「商品与分类」里的记录，后台改了，前台跟着变 —— 反过来说，后台没改对，区块里怎么调都没用。
组件六
商品列表
一组商品卡片，点进商品详情页。首页的「主推产品」、分类页的列表都用它。
product-grid一页最多 4 个站点商品超过 200 个时只取最近更新的 200 个
区块标题由系统按当前站点语言自动填（中文站是「主推产品」、 英文站是 Featured products），不需要也不能自己改。 想用别的标题，在它上面放一个「图文内容」写 <h2>。
| 字段 | 怎么填 |
|---|---|
| 商品来源下拉 · 全部商品 / 按分类 | 「全部商品」按下面的数量取前几个；「按分类」只显示该分类下的商品。 这两个选项的差别不在显示结果，而在以后要不要回来改： 选了「按分类」，以后往这个分类里加新品，首页自动就有了； 选「全部商品」，加新品不会进这一块。 |
| 哪个分类下拉 · 来自本站分类 | 来源选「按分类」时必填。下拉里的选项来自「商品与分类」页，刚建的分类刷新页面就会出现。 分类被删掉之后，这一格会变空，区块退回「全部商品」——不会报错，但要记得回来改。 |
| 显示数量数字 · 1 到 24 · 默认 6 | 想要"两行三列"就是 6 个。数量超过了分类下的实际商品数时，显示实际有的那些， 不会留空位。 |
| 每行几个下拉 · 2 / 3 / 4 | 手机上会自动降到一行一个，这一格只影响桌面宽屏。 |
| 显示价格开关 · 默认开 | 关掉后卡片只剩图、名称和一句话。外贸站按图纸或批量报价时通常关掉 —— 开着但没填价格，每张卡片都会挂一行「Price on request」， 六张连排时看着像六个占位符。 这个开关只作用于列表，商品详情页不受影响（那里有完整上下文，询盘按钮就在旁边）。 |
显示顺序是「最近编辑过的在前」
不是后台列表里你看到的顺序，也不是创建时间。想让某个商品在前台排前面， 去「商品与分类」打开它、随便改一个字再保存 —— 它的更新时间一变，就排到前面了。
这是当前实现的取舍（没有单独的可拖拽排序字段）。如果你的品类需要固定顺序， 用「按分类」再配一个专门的分类页，比在首页硬调更稳。
组件七
分类导航
一组分类卡片，点进去是该分类下的商品列表。让访客自己走到他要的那一类。
category-grid最多 12 个分类留空 = 显示全部分类
自动标题是「我们制造什么」（英文站 What we make）。 这个区块最值得放在首页中段：买家的第二个问题是"你们还做别的东西吗"， 一屏分类卡片就把经营范围说完了。
| 字段 | 怎么填 |
|---|---|
| 要展示的分类多选 · 最多 12 个 | 从本站分类里选，选中的顺序就是页面上的顺序。 留空不是"隐藏这个区块"，而是显示本站全部分类 —— 只建了两三个分类时这样最省事，等分类多了再挑。 |
| 每行几个下拉 · 2 / 3 / 4 | 同上，只影响桌面。分类只有 2 个时选 4 会显得很空，选 2 更好。 |
| 显示商品数量开关 · 默认关 | 在分类名旁边显示「12 件商品」。分类下商品普遍不多时建议关掉，否则一眼看去全是「0 件」。 |
区块里配置的分类如果已经被删掉，会静默跳过，不会显示一个点进去 404 的卡片。 所以删分类之后页面不会报错，只是少一张卡 —— 记得回来检查一下。
两个区块共用的前提
商品要出现在前台，得同时满足三条
少一条就不显示，而且都不报错 —— 这是"我明明加了商品，首页是空的"的全部原因。
- 状态是「已上架」。草稿和下架的商品不出现，也不进 sitemap。上新之后回到「商品与分类」确认一下状态。
- 有自己语言的名称。商品名按语言存。英文站上，只有中文名的商品显示不出来（或者显示成空标题）。 只做一种语言时不会有这个问题，开了多语言就要逐个补。
- 在区块的取数范围内。站点商品超过 200 个时，页面只取最近更新的 200 个参与渲染； 「按分类」的商品如果不在这个范围内，也不会出现。
没有封面图的商品不会消失，会显示一个写着名称前两个字的占位块。 这比一张破图好，但一张都没有的首页看起来仍然像没做完 —— 上架时顺手把封面补上。
对照自查
这几个现象，原因都在这篇里
- 商品列表整块不见了
- 一个商品都没取到时，这个区块整个不渲染（不是显示一个空框）。 去「商品与分类」看状态是不是已上架、来源选的那个分类里有没有商品。
- 改了商品，前台没变
- 前台是重新打开才刷新。改完保存后在另一个标签页硬刷新一次； 如果页面设了缓存，等一两分钟。
- 顺序和我预期的不一样
- 按更新时间倒序，不是后台列表顺序、也不是创建时间。见上面商品列表那一节。
- 分类导航里出现了我不想展示的分类
- 「要展示的分类」留空时会显示全部分类。把要展示的那几个逐个选上， 顺序按你选的来。
- 每张卡片都挂着「Price on request」
- 关掉「显示价格」。外贸站按图纸报价时，一行"面议"重复六遍会显得很空。