商城模块管理
小程序首页那一排功能入口——签到、拼团、限时购、积分兑换、领券、自取、外卖一类——各自叫什么名字、显示什么标题、配哪张图标、要不要露出,都在商城模块管理里维护。想给入口换个更贴合门店活动的说法,或者临时收起某个入口,改这一页即可,不必动小程序代码。
一、功能概述
菜单位置:O2O业务 → 微信商城 → 商城模块管理(页面地址 /admin/o2o/wxmodules/)

| 用途 | 说明 |
|---|---|
| 改入口名称 | 「模块名称」是模块的标识名,「模块标题」是展示给会员看的标题 |
| 换入口图标 | 通过「模块图片」面板上传,单张不超过 5MB |
| 控制露出 | 「是否启用」开关决定该模块是否启用 |
| 图片缓存判断 | 上传后系统自动记录图片类型与图片CRC32,供小程序端判断是否需要重新拉图 |
本页维护的是模块档案本身:入口对应的业务规则(签到送什么、拼团怎么开、券怎么领)在商城活动 各方案里配置;首页的整体视觉与楼层布置在商城装修 维护。模块与前端入口的对应关系由小程序端读取模块记录实现,具体露出位置以现场小程序版本为准。
二、界面布局说明
| 区域 | 内容 |
|---|---|
| 列表工具栏 | 新增、导出、打印(打印为分裂按钮,下拉里有「打印模板管理」);本页列表没有「回收站」按钮 |
| 列表列 | 模块名称、模块标题、是否启用、图片文件名 |
| 进入编辑 | 点「模块名称」打开编辑页 |
| 搜索与排序 | 搜索覆盖模块名称、模块标题;列表按模块ID排序 |
编辑页分两个分组:
- 基本信息:模块名称(必填)、模块标题、是否启用(开关)。
- 图片信息(折叠):图片CRC32、图片文件名,两项都是只读,由上传动作写入。
主表单下方是「图片」区块里的模块图片面板:按钮为「上传图片」「删除图片」;还没有图片时显示「暂无图片」;主记录尚未保存时显示「请先保存主记录」,此时不能上传。顶部工具栏为返回、保存(下拉含「保存并继续编辑」「保存并新增下一个」「保存并返回列表」)、取消、刷新、上一行、下一行、历史版本、删除。
三、业务操作步骤
步骤 1:新增或打开一个模块
- 点「新增」,填模块名称(必填)与模块标题。
- 名称为空保存时提示「模块名称不能为空」。本表没有独立编号字段,因此不做编号唯一性校验,模块之间靠名称区分。
- 点「保存」先落主记录——图片面板要在主记录存在后才能上传。
步骤 2:上传模块图标
- 在「模块图片」面板点「上传图片」,选择本地图片文件。
- 超过 5MB 时弹出「图片大小超过5120KB限制」,压缩后重传。
- 上传成功回显「图片已上传」,面板出现预览;列表的「图片文件名」列同步显示文件名。
- 系统同时写入图片类型与图片CRC32(8 位十六进制校验码),小程序端据此判断缓存是否失效。
- 需要换图时先「删除图片」(回显「图片已删除」),再上传新图。
步骤 3:启用或停用模块
打开记录,切换「是否启用」后保存。停用只改模块档案的启用状态,不会删除模块,也不会改动对应活动方案的配置。
步骤 4:到小程序端核对
保存后重新进入小程序首页查看入口名称与图标。图标是否立即更新取决于小程序端的缓存判断与发布版本,若仍显示旧图,可先退出重进或清理小程序缓存再核对。
四、字段详细说明
落库表 WX_Modules,主键为模块ID(fModuleId)。
| 界面字段 | 落库字段 | 含义与取值 |
|---|---|---|
| 模块名称 | fModuleName | 必填,长度 20;模块的标识名,列表首列与编辑入口 |
| 模块标题 | fModuleTitle | 长度 20;展示标题,可与模块名称不同 |
| 是否启用 | fIsUsed | 开关,决定模块启用状态 |
| 模块图片 | fImage | 二进制图片,表单里不直接编辑,只能通过「模块图片」面板上传或删除 |
| 图片类型 | fImageType | 上传时按文件类型写入,长度 50 |
| 图片CRC32 | fImageCRC32 | 只读,上传时按图片内容计算的 8 位十六进制校验码,供小程序端缓存判断 |
| 图片文件名 | fImageFileName | 只读,上传时写入的原始文件名 |
五、典型使用场景
场景一:活动期改入口标题。 大促前把限时购一类入口的「模块标题」改成活动口号,活动结束再改回常规说法,模块名称与图标保持不变。
场景二:统一换图标风格。 门店升级品牌形象时,逐个模块删除旧图、上传新图;上传后 CRC32 变化,小程序端更容易识别到需要重新拉图。
场景三:临时收起一个入口。 某项玩法暂停时把「是否启用」关掉,档案与图片都保留,恢复时打开开关即可,不用重新配图。
六、权限控制与前置条件
- 本页属于网页端新增的商城配置菜单,权限映射表里没有对应的老 ERP 菜单项,登录网页后台即可进入;数据按当前账套隔离。
- 上传图片前必须先保存主记录,否则面板显示「请先保存主记录」。
- 图片单张上限 5MB;建议按小程序端展示尺寸准备方图,避免过大文件拖慢首页加载。
- 入口背后的活动方案需要另行配置并生效,见商城活动。
七、常见问题
问:上传了图标,小程序首页还是旧图? 答:图片存在服务端,小程序端按 CRC32 与本地缓存判断是否重拉。先退出重进小程序,必要时清理缓存;若仍旧,确认上传是否回显「图片已上传」、列表「图片文件名」是否已更新。
问:为什么没有「回收站」按钮? 答:回收站只对带删除标志的档案表显示,本表不在其列。删除入口在编辑页的「删除」按钮,确认框为「确认删除该记录?此操作不可恢复。」,删除前请确认该模块不再被前端引用。
问:模块名称能重复吗? 答:本页不做编号唯一性校验,名称重复不会被拦下,但会造成运营辨认困难,也会让前端按名称匹配时出现歧义,建议一个入口一条记录、名称保持唯一。
问:改了模块标题,活动规则会跟着变吗? 答:不会。本页只改展示名称、标题、图标与启用状态;签到、拼团、限时购、领券等规则在对应的活动方案里配置。
