产品模块
💡 本篇你将完成：检查首页产品分类、默认特色产品列表，以及用推荐产品模块统一产品图片大小。预计 8 分钟。
首页至少要让客户看到“你卖什么”和“哪些产品最重要”。新手先检查默认首页有没有产品模块，不要一上来就删除重做。
先找到操作入口
操作路径： AllinCMS 工作台站点列表 → 目标站点 → 进入后台 → 主题 → 当前主题页面 → Home 或目标页面
模块顺序
一、分类模块 Category Showcase
进入 主题 / Themes -> 页面 / Pages -> Home -> Design。
先看首页有没有分类展示模块。如果没有，再添加。
添加分类展示模块有两种方式：
- 对 AI 对话输入：
在轮播图后面添加产品分类展示模块。 - 手动查找：
Catalog->Category Showcase。
添加后，在右侧属性面板选择要展示的分类、每行数量和图片样式。
第一轮只展示 3 到 4 个主要类别。类别太多会让首页很乱。
图片不整齐时先看规范。 分类封面和产品图准备前，先看 图片规范。尺寸和比例统一，首页产品模块会更整齐。
二、默认特色产品列表 Featured Product List
Featured Product List 是默认模板里常见的特色产品列表。它的作用是把重点产品放在首页，客户不用进入产品页，也能先看到你想推荐的产品。
第一轮如果这个模块已经存在，先不要删除。你可以先检查：
- 显示的产品是不是你自己的产品。
- 产品点击后能不能进入详情页。
- 产品排序是不是符合你的推荐顺序。
- 图片有没有明显大小不一、裁切严重的问题。
如果只是产品内容不对，先去 添加产品 修改产品信息，或者看 首页推荐产品 调整排序。
如果你后面用 Recommended Products 替换默认列表，记得删除或隐藏原来的 Featured Product List。两个模块同时放，首页会重复展示产品。
三、推荐产品模块 Recommended Products
很多客户希望首页每个产品图片都一样大。遇到这种情况，可以用 Recommended Products 模块替换默认的 Featured Product List。
适合替换的情况：
- 产品卡片图片高低不一致。
- 想一行展示 4 个产品，或更多产品。
- 想让产品列表更像整齐的网格。
- 想在右侧属性里统一设置
Detail Page。
添加方式：
- 对 AI 对话输入：
在产品分类模块后面添加一个产品推荐模块。 - 手动查找：
Catalog->Recommended Products。
添加后，在右侧属性里重点检查：
| 设置 | 怎么选 |
|---|---|
| 每行数量 / Columns | 常用 4 个，也可以按版面选择更多 |
| 产品来源 | 选择要展示的推荐产品或产品集合 |
| 图片显示方式 | 图片要整齐时，优先统一产品主图比例 |
Detail Page | 选择 /products |
想让图片一样大，先统一产品主图。 模块可以让卡片更整齐，但产品主图本身也要统一。建议产品主图都用正方形，上传前看 图片规范。
四、详情页 Detail Page
不管你用默认的 Featured Product List，还是新加的 Recommended Products，最容易出错的都是详情页链接。
右侧属性里的 Detail Page 必须选择：
/products
文章模块同理：文章详情页选择 /posts。
如果 Detail Page 选错，客户点击产品后很可能看到 404。
五、发布后检查
发布页面后，到前台检查：
- 首页能看到产品分类和推荐产品。
- 点击分类能进入
/products?category=分类slug。 - 点击产品能进入产品详情页。
- 产品图大小基本一致，没有严重裁切。
- 前台没有模板测试产品。
避坑汇总
| 坑 | 后果 | 怎么避 |
|---|---|---|
🔴 没设置 Detail Page | 产品点击 404 | 选择 /products |
| 🟡 同时保留两个产品模块 | 首页重复展示产品 | 替换时删除或隐藏旧模块 |
| 🟡 分类没有封面图 | 首页模块不好看 | 给主要分类传封面 |
| 🟡 产品图比例混乱 | 列表不整齐 | 参考 图片规范 |
| 🔴 后台没有产品 | 推荐产品模块空白 | 先补产品再改模块 |