公众服务页面
公众服务页面是公众号侧的自定义图文页面库:一条记录就是一个页面,正文以 HTML 形式保存,配图从微信图片资料管理里挑。微信菜单定义的超链接按钮、自动回复定义的图文消息,都通过「选择网页」把顾客带到这些页面上。列表只列自定义页面(页面类型为空或 0),系统自动生成的页面不在本页维护。
一、功能概述
菜单位置:O2O业务 → 微信公众号 → 公众服务页面(页面地址 /admin/o2o/wxhtmlpage/)

| 用途 | 说明 |
|---|---|
| 新建自定义页面 | 填页面说明即建一页,页面ID 与页面GUID 由系统生成 |
| 编排正文 | 在「编译页面」里用工具栏排版,也可以直接改 HTML 源码 |
| 页面插图 | 从图片库挑图,复制成该页专属的图片副本并生成微信外链 |
| 供菜单与回复跳转 | 页面建好后,在菜单定义或自动回复定义里用「选择网页」挂上去 |
客户端把「页面编译」与「页面图片」分成两个窗口,网页版合并成一个独立页「编译页面」,左侧编正文、右侧管图片。
本窗口管什么、不管什么
| 事项 | 在哪里定 |
|---|---|
| 页面正文、页面内的图片副本 | 本窗口 |
| 图片素材本身(上传、标题、文件名) | 微信图片资料管理 |
| 哪个菜单按钮跳哪个页面 | 微信菜单定义(事件类型选 view) |
| 关注后回复的图文内容 | 自动回复定义(消息类型 2) |
| 系统自动生成的页面(充值、会员卡等) | 由程序生成,不在本页列表内,本页不改其标题、不删 |
二、界面布局说明
列表页
| 区域 | 内容 |
|---|---|
| 工具栏 | 新增、导出、打印(选中行后另出现导出选中);本表无删除标志列,不出现「回收站」 |
| 搜索框 | 提示文字「搜索...」,按页面说明、页面GUID 模糊搜 |
| 表格 | 列依次为页面ID、页面说明(超链,点开编辑)、页面GUID、页面类型;页面ID 与页面说明两列固定在左侧 |
| 排序 | 按页面ID 升序 |
| 分页 | 底部「共 N 条」「共 N 页」,每页 10 / 20 / 30 / 50 / 100 / 200 条 |
列表只显示页面类型为空或 0 的记录,系统页面不出现。但菜单与回复里的「选择网页」弹窗列的是全部页面,系统页面在其中带「[系统]」标记,仍可以被选中挂到菜单上。
编辑窗口
表单只有一个区块,四个字段:
| 字段 | 控件与提示 |
|---|---|
| 页面说明 | 文本,最长 200 字符;列表超链显示的就是它 |
| 页面GUID | 文本,最长 50 字符;提示「新增留空时自动生成 GUID」 |
| 页面类型 | 数值输入;提示「自定义页面固定为 0(新增自动填 0)」 |
| 页面HTML | 多行文本框,12 行高,占整行宽 |
页面ID 新增时不出现,由系统取号,编辑态只读。制单人等审计列不在本表单显示。
已保存的记录,表单上方会多出一条链接「编译页面 / 页面图片」(在新标签页打开),旁边提示「页面 HTML 也可在本表单直接编辑」。新增尚未保存时这条链接不出现,要先保存再进编译页。
表单工具栏左侧为返回、编辑、保存(下拉含「保存并继续编辑」「保存并新增下一个」「保存并返回列表」)、取消、刷新、上一行、下一行;右侧为历史版本、附件、删除。本页没有图片上传面板,也没有明细页签。
编译页面(独立页)
| 区域 | 内容 |
|---|---|
| 顶部 | 标题「编译页面」,右侧提示「{页面ID} {页面说明}|保存后 HTML 生效,未被引用的图片会被清理」;按钮保存、返回(返回该页的编辑表单) |
| 工具栏 | B 加粗、I 斜体、U 下划线、标题、正文、• 列表、引用、链接、插入图片、清除格式、HTML |
| 左侧 | 正文编辑区,直接在里面打字排版 |
| 右侧 | 面板「页面图片」,提示「图片来自微信图片资料库,保存时未引用的图片会被删除」,按钮「+ 从图片库添加」;无图时显示「暂无图片」 |
- 图片项显示缩略图与「#图片ID 文件名」,每项带「删除」按钮,点击先确认「确定删除该图片吗?」。
- 点「+ 从图片库添加」或工具栏「插入图片」,弹出「选择图片」窗口,搜索框提示「按标题/文件名过滤」,逐行显示图片标题与文件名(无标题的显示「(未命名)」);库里没图时显示「请先定义图片资源!」,接口异常时显示「图片库加载失败」。
- 「链接」按钮弹出输入框「请输入链接地址」,默认值
http://;「HTML」按钮弹出「编辑 HTML 源码」,可直接改标签。 - 保存成功弹「已保存」并自动返回编辑表单;失败弹「保存失败」或接口返回的具体消息。
三、业务操作步骤
步骤 1:先备好图片素材
到微信图片资料管理上传要用的图片(单张不超过 5MB),填好图片标题便于挑选。本页不提供上传入口,编译页只能从图片库里挑已有的图。
步骤 2:新建一个页面
- 点「新增」;
- 填「页面说明」,例如「新品上市介绍」,这个名字会出现在列表和「选择网页」弹窗里;
- 「页面GUID」留空,「页面类型」留空或填 0;
- 点「保存」。系统按
WX_HTMLPage取号(基数 100)生成页面ID,自动生成形如{大写UUID}的页面GUID,页面类型补 0。
保存后表单上方出现「编译页面 / 页面图片」链接。
步骤 3:编排正文
- 点「编译页面 / 页面图片」,在新标签页打开编译页;
- 在左侧编辑区输入文字,用「标题」「正文」「• 列表」「引用」排版,用 B / I / U 强调;
- 需要外链时选中文字点「链接」,填地址;
- 点「保存」,弹「已保存」后回到编辑表单。正文写入
fHTML列。
也可以不进编译页,直接在编辑表单的「页面HTML」里改标签后保存,两处写的是同一列。
步骤 4:给页面插图
- 在编译页点「+ 从图片库添加」;
- 在「选择图片」弹窗里按标题或文件名过滤,点中要用的那一行;
- 系统把该图从图片库复制一份到本页的图片表,分配页内图片ID(从 1 起递增),按微信服务参数生成外链,并在光标处插入这张图;
- 右侧「页面图片」列表同步出现「#图片ID 文件名」,缩略图走登录态预览地址。
插进去的是副本:之后在图片库里换图或删图,不会改动已经插进本页的这一份。
步骤 5:把页面挂到菜单或自动回复
回填的链接形如 {微信服务地址}/wechat.php/ACTION_HTML?srvid={服务号}&page_id={页面ID}。未配置微信服务地址时,弹窗会提示「未配置微信服务地址(Opt_SysInfo/TWXOption/WXServiceUrl),生成的链接缺少域名,可手工补全」。
页面保存好不等于公众号菜单已更新,菜单内容的推送不在本页,也不在菜单定义页的界面上。
步骤 6:改文字、换图
- 改文字:进编译页直接改,保存即覆盖整段 HTML。
- 换图:先插新图,再在编辑器里删掉旧图那张
<img>,最后到右侧「页面图片」把旧图那一项点「删除」。只删右侧列表不会改正文,正文里的旧图会变成裂图。
步骤 7:停用或删除页面
本表没有删除标志列,删除页面行后记录可能仍在,图片副本却会被清掉:点「删除」后可能提示已删除,刷新后页面记录可能仍在,而该页的图片副本已被清掉,正文里的图随之失效。
因此不建议用「删除」来停用一个页面。要下线某页,改菜单按钮或自动回复的跳转指向更稳妥;确需清理记录与图片时,联系深圳市安仕达管理软件有限公司技术支持在数据库层处理。
四、字段详细说明
页面主表 WX_HTMLPage
| 界面字段 | 落库字段 | 含义与取值 |
|---|---|---|
| 页面ID | fPageId | 主键,新增时 EXEC GetOnlyNum 'WX_HTMLPage', 100, 1 取号,编辑态只读 |
| 页面GUID | fPageGUID | 最长 50 字符;新增留空时自动填 {大写UUID},已有值不覆盖 |
| 页面说明 | fExplain | 最长 200 字符,页面标题,列表超链与「选择网页」弹窗显示的就是它 |
| 页面HTML | fHTML | 文本列,页面正文就存在这一列;表单与编译页都写它 |
| (不显示) | fRichView | 富文本二进制列,不在界面出现,网页版不再写入 |
| 页面类型 | fPageType | 空或 0 = 自定义页面;非 0 = 系统页面,列表不显示、禁改标题、禁删 |
本表没有状态、备注、排序、有效期列,页面建好即可被引用,是否对外可见取决于菜单与回复怎么挂。
页面图片表 WX_HTMLPageImage
| 落库字段 | 含义与取值 |
|---|---|
fPageId + fImageId | 复合主键;图片ID 按页内 ISNULL(MAX(fImageId),0)+1 递增,与图片库的图片ID 不是同一套编号 |
fFileName | 文件名,最长 50 字符,取自图片库同名列 |
fImageType | 图片类型,按文件名后缀判定:.png → image/png,.gif → image/gif,其余一律 image/jpeg |
fImage | 图片二进制副本,从图片库复制而来 |
fImageUrl | 微信侧外链,最长 300 字符,插入时按服务参数生成 |
fImageFileName | 图片文件名,最长 100 字符,写入与 fFileName 相同的值 |
fImageCRC32 | 校验列,网页版插入时不写入 |
图片外链的两种格式
外链取租户库 Opt_SysInfo 中 fOptionName='TWXOption' 的参数,按 UseOldWeixinServer 分支:
| 条件 | 生成的外链 |
|---|---|
UseOldWeixinServer = 1 | /wechat.php/ACTION_IMAGE?srvid={WXServiceNo}&page_id={页面ID}&img_id={图片ID} |
| 其它值或未配置 | {WXServiceUrl}/File.do?FileType=custom_page_image&pageid={页面ID}&imgid={图片ID}&appid={WEIXIN_APPID} |
参数未配置时
WXServiceUrl 为空时,第二种格式生成的是以 /File.do 开头、缺域名的相对地址,顾客侧打不开。插图前先确认微信服务地址、服务号、公众号 AppID 已配置;旧服务分支只带服务号,不带域名。
编译页右侧的缩略图走的是另一条登录态预览地址(…/image/{图片ID}/raw/,响应头 Cache-Control: private, max-age=300),与写进正文的微信外链不是同一个地址:后台能看到图,不代表顾客侧能看到。
校验与提示原文
| 触发位置 | 提示原文 |
|---|---|
| 修改系统页面的页面说明 | 系统网页不允许修改标题! |
| 删除系统页面(单条或批量) | 系统自动生成的页面不允许删除! |
| 编译页 / 保存 / 插图 / 删图时页面已不存在 | 页面不存在 |
| 保存 / 插图 / 删图接口收到非 POST 请求 | 仅支持POST |
| 编译保存的请求体解析失败 | 提交数据格式错误 |
| 插图 / 删图传入的图片ID 不是整数 | 图片ID格式错误 |
| 插图时图片库里查不到该ID | 图片库中未找到该图片 |
| 编译保存成功 | 页面已保存(界面弹「已保存」) |
| 删除页面图片成功 | 图片已删除 |
| 图片库为空 | 请先定义图片资源! |
| 图片库接口异常 | 图片库加载失败 |
| 删除页面图片前的确认 | 确定删除该图片吗? |
批量删除时若选中项里含系统页面,会先提示「系统自动生成的页面不允许删除!」,其余自定义页面继续走删除流程。
五、典型使用场景
场景一:新品上市图文页挂菜单。 先在图片库传好新品海报,新建页面「新品上市介绍」并保存,进编译页写文案、插海报,保存后到微信菜单定义把某个按钮的事件类型设为 view,用「选择网页」挑这一页。菜单推送后顾客点按钮即看到该页。
场景二:关注后自动回复图文。 新建一页「门店指引」,编好地址、营业时间与门头照片;到自动回复定义新增一条消息类型为 2 的记录,用「选择网页」挑这一页,顾客关注公众号后收到图文并跳转到该页。
场景三:活动页换主视觉。 活动改期只需换海报:在图片库传新图,进编译页插新图、删掉正文里的旧图,再到右侧「页面图片」删掉旧图那一项,保存。页面ID 与外链不变,菜单和回复不用重新挂。
场景四:直接维护 HTML。 需要精确控制标签(例如加一段自定义样式或表格)时,在编译页点「HTML」编辑 HTML 源码,或直接在编辑表单的「页面HTML」里改。两处写同一列,后保存的一方覆盖前一方。
场景五:多个页面共用一张素材。 同一张图可以插进多个页面,每页各存一份副本,互不影响;图片库里改图或删图,已插入的页面仍显示插入时的那一份。要统一换图,需逐页重新插入。
六、权限控制与前置条件
- 本页为网页端新迁移的编码窗体,权限映射里标注为「客户端无对应菜单 / Django 新增,始终放行」,可见性跟随 O2O业务 → 微信公众号 分组;看不到入口时联系深圳市安仕达管理软件有限公司确认账套开通范围。
- 微信服务参数(
WXServiceUrl、WXServiceNo、UseOldWeixinServer、WEIXIN_APPID)需先配置,否则插图生成的外链缺域名,「选择网页」回填的链接同样缺域名。 - 插图前需先在微信图片资料管理上传素材,本页与编译页都不提供上传入口。
- 系统页面(页面类型非 0)不在列表内,不允许改标题、不允许删除;「选择网页」弹窗仍会列出并标「[系统]」,可以挂到菜单上。
- 页面保存成功不代表公众号侧已生效:菜单内容的推送、自动回复的下发都不在本页,网页端也未提供相应按钮。
- 编译页的图片预览需要登录态,顾客侧访问的是微信服务外链;排查「后台有图、前台无图」时先分清这两个地址。
七、常见问题
问:新增后为什么找不到「编译页面 / 页面图片」链接? 答:该链接只在记录已保存时出现。先填页面说明点「保存」,回到编辑态即可看到。
问:列表里搜不到某个页面? 答:列表只显示页面类型为空或 0 的自定义页面,系统页面不在其中。搜索按页面说明与页面GUID 匹配,页面ID 不参与搜索;系统页面可在菜单或回复的「选择网页」弹窗里找到,带「[系统]」标记。
问:改页面说明时报「系统网页不允许修改标题!」? 答:该记录的页面类型不是 0,属系统自动生成的页面,标题受保护。自定义页面把页面类型保持为 0 即可正常改名。
问:客户端编好的页面,网页版编译页打开是空白? 答:编译页只载入 fHTML 列。客户端用富文本编辑的正文存在二进制列 fRichView 里,网页版不读也不写该列,这类页面在网页版可能显示为空,需要重新排版后保存。老页面接手前先确认正文来源。
问:后台能看到图,顾客打开页面图裂了? 答:先看正文里那张图的外链是否带完整域名——WXServiceUrl 未配置时生成的是缺域名的相对地址;再确认该图片副本是否还在(右侧「页面图片」列表里有没有对应项)。后台缩略图走登录态预览地址,与顾客侧外链不是同一个地址。
问:提示「保存时未引用的图片会被删除」,我在编辑器里删了图,右侧列表怎么还在? 答:在编辑器里删掉 <img> 后保存,右侧列表可能仍保留该项。要清掉图片副本,请点右侧那一项的「删除」按钮。实际清理效果以实际版本为准。
问:点了右侧「删除」,正文里的图变成裂图? 答:「删除」删的是页面图片副本,不会同步修改 HTML。需要同时在编辑器里删掉那张图再保存,两边都清掉才不留裂图。
问:点了表单的「删除」,记录还在但图没了? 答:本表没有删除标志列,删除页面行后记录可能仍在,而页面图片会被真删。不要用「删除」来停用页面,改菜单或自动回复的跳转指向更稳妥;确需清理时联系技术支持在数据库层处理。
问:右侧的「#1」「#2」是图片库里的图片ID 吗? 答:不是。那是页内图片编号,每页从 1 起递增;图片库的ID 只在插入时用来取素材,插入后两边各自独立。
问:页面HTML 和编译页,改哪个才算数? 答:两处写的是同一列 fHTML,后保存的一方覆盖前一方。编译页保存是整段覆盖,若同时开着两个标签页编辑,注意先刷新再改,避免互相覆盖。
