序言

本文档面向使用 BadouCMS 商城插件进行模板开发的用户，介绍商城标签的用途、约定与阅读方式。

1. 关于商城插件

商城插件（shop 模块）为 BadouCMS 提供一套完整且支持多语言的电商能力，
在保留 CMS 内容管理优势的同时，补齐了从商品到交易的全链路。

核心能力包括：

• 商品、分类、品牌与 SKU 管理
• 购物车、结算、下单、订单与售后
• 优惠券、支付、物流与收藏评价
• 多语言商品内容与多币种展示
• 商品扩展字段与多条件筛选

2. 设计思路

商城插件遵循「CMS 管展示、shop 管交易」的分工：

• 商品标题、详情、多图、SEO 等内容由 CMS 内容表维护，天然支持多语言
• 价格、库存、SKU、订单等交易数据由商城表维护，全语言共享
• 两套数据通过 aucode 桥接，前台模板可同时取到内容与交易字段

因此，商品列表与详情既保留了 CMS 的栏目、标签、SEO 能力，
又具备商城的价格、库存、加购等交易属性。

3. 文档约定

为便于阅读，本系列文档统一采用以下约定：

• 标签统一写作 {shop:xxx}，成对标签以 {shop:xxx} 开始、{/shop:xxx} 结束
• 变量统一写作 {$goods.title} 形式，字段含义见各标签的「调用标签」表
• 金额字段为原始数值，展示时建议使用 {:currency($goods['min_price'], true)} 格式化
• 商城数据默认跟随前台语言，取不到时回退默认语言
• 示例代码中的 $goods、$brand 等变量名由标签的 alias 参数决定

4. 目录导航

5. 使用前提

• 商城插件已安装并启用
• 已创建商城商品栏目，并维护了上架商品
• 模板位于 template/cms/shop/ 目录，可参考插件自带模板

满足以上条件后，在模板中直接使用 {shop:xxx} 标签即可调用商城数据。