Skip to content

商城模块管理 ​

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

一、功能概述 ​

菜单位置:O2O业务 → 微信商城 → 商城模块管理(页面地址 /admin/o2o/wxmodules/)

商城模块管理列表:表格列为模块名称、模块标题、是否启用、图片文件名

用途说明
改入口名称「模块名称」是模块的标识名,「模块标题」是展示给会员看的标题
换入口图标通过「模块图片」面板上传,单张不超过 5MB
控制露出「是否启用」开关决定该模块是否启用
图片缓存判断上传后系统自动记录图片类型与图片CRC32,供小程序端判断是否需要重新拉图

本页维护的是模块档案本身:入口对应的业务规则(签到送什么、拼团怎么开、券怎么领)在商城活动 各方案里配置;首页的整体视觉与楼层布置在商城装修 维护。模块与前端入口的对应关系由小程序端读取模块记录实现,具体露出位置以现场小程序版本为准。

二、界面布局说明 ​

区域内容
列表工具栏新增、导出、打印(打印为分裂按钮,下拉里有「打印模板管理」);本页列表没有「回收站」按钮
列表列模块名称、模块标题、是否启用、图片文件名
进入编辑点「模块名称」打开编辑页
搜索与排序搜索覆盖模块名称、模块标题;列表按模块ID排序

编辑页分两个分组:

  • 基本信息:模块名称(必填)、模块标题、是否启用(开关)。
  • 图片信息(折叠):图片CRC32、图片文件名,两项都是只读,由上传动作写入。

主表单下方是「图片」区块里的模块图片面板:按钮为「上传图片」「删除图片」;还没有图片时显示「暂无图片」;主记录尚未保存时显示「请先保存主记录」,此时不能上传。顶部工具栏为返回、保存(下拉含「保存并继续编辑」「保存并新增下一个」「保存并返回列表」)、取消、刷新、上一行、下一行、历史版本、删除。

三、业务操作步骤 ​

步骤 1:新增或打开一个模块 ​

  1. 点「新增」,填模块名称(必填)与模块标题。
  2. 名称为空保存时提示「模块名称不能为空」。本表没有独立编号字段,因此不做编号唯一性校验,模块之间靠名称区分。
  3. 点「保存」先落主记录——图片面板要在主记录存在后才能上传。

步骤 2:上传模块图标 ​

  1. 在「模块图片」面板点「上传图片」,选择本地图片文件。
  2. 超过 5MB 时弹出「图片大小超过5120KB限制」,压缩后重传。
  3. 上传成功回显「图片已上传」,面板出现预览;列表的「图片文件名」列同步显示文件名。
  4. 系统同时写入图片类型与图片CRC32(8 位十六进制校验码),小程序端据此判断缓存是否失效。
  5. 需要换图时先「删除图片」(回显「图片已删除」),再上传新图。

步骤 3:启用或停用模块 ​

打开记录,切换「是否启用」后保存。停用只改模块档案的启用状态,不会删除模块,也不会改动对应活动方案的配置。

步骤 4:到小程序端核对 ​

保存后重新进入小程序首页查看入口名称与图标。图标是否立即更新取决于小程序端的缓存判断与发布版本,若仍显示旧图,可先退出重进或清理小程序缓存再核对。

四、字段详细说明 ​

落库表 WX_Modules,主键为模块ID(fModuleId)。

界面字段落库字段含义与取值
模块名称fModuleName必填,长度 20;模块的标识名,列表首列与编辑入口
模块标题fModuleTitle长度 20;展示标题,可与模块名称不同
是否启用fIsUsed开关,决定模块启用状态
模块图片fImage二进制图片,表单里不直接编辑,只能通过「模块图片」面板上传或删除
图片类型fImageType上传时按文件类型写入,长度 50
图片CRC32fImageCRC32只读,上传时按图片内容计算的 8 位十六进制校验码,供小程序端缓存判断
图片文件名fImageFileName只读,上传时写入的原始文件名

五、典型使用场景 ​

场景一:活动期改入口标题。 大促前把限时购一类入口的「模块标题」改成活动口号,活动结束再改回常规说法,模块名称与图标保持不变。

场景二:统一换图标风格。 门店升级品牌形象时,逐个模块删除旧图、上传新图;上传后 CRC32 变化,小程序端更容易识别到需要重新拉图。

场景三:临时收起一个入口。 某项玩法暂停时把「是否启用」关掉,档案与图片都保留,恢复时打开开关即可,不用重新配图。

六、权限控制与前置条件 ​

  • 本页属于网页端新增的商城配置菜单,权限映射表里没有对应的老 ERP 菜单项,登录网页后台即可进入;数据按当前账套隔离。
  • 上传图片前必须先保存主记录,否则面板显示「请先保存主记录」。
  • 图片单张上限 5MB;建议按小程序端展示尺寸准备方图,避免过大文件拖慢首页加载。
  • 入口背后的活动方案需要另行配置并生效,见商城活动。

七、常见问题 ​

问:上传了图标,小程序首页还是旧图? 答:图片存在服务端,小程序端按 CRC32 与本地缓存判断是否重拉。先退出重进小程序,必要时清理缓存;若仍旧,确认上传是否回显「图片已上传」、列表「图片文件名」是否已更新。

问:为什么没有「回收站」按钮? 答:回收站只对带删除标志的档案表显示,本表不在其列。删除入口在编辑页的「删除」按钮,确认框为「确认删除该记录?此操作不可恢复。」,删除前请确认该模块不再被前端引用。

问:模块名称能重复吗? 答:本页不做编号唯一性校验,名称重复不会被拦下,但会造成运营辨认困难,也会让前端按名称匹配时出现歧义,建议一个入口一条记录、名称保持唯一。

问:改了模块标题,活动规则会跟着变吗? 答:不会。本页只改展示名称、标题、图标与启用状态;签到、拼团、限时购、领券等规则在对应的活动方案里配置。