## 文档概述 「微信小程序配置」是 MuuCmf T6 后台管理系统中用于对接微信小程序的配置模块。 本模块以**表单形式**提供小程序的基本信息(小程序名称、小程序简介)与接口配置(原始ID、AppID、AppSecret)。管理员按小程序后台的开发者信息填写并保存后,MuuCmf 系统即可与微信小程序建立对接,实现小程序授权登录、用户信息获取、跳转小程序等能力。 **核心用途:** - **完成小程序对接**:填写 AppID、AppSecret,使系统与微信小程序建立通信,可获取接口调用凭证(access_token); - **唯一标识小程序**:填写小程序原始ID,用于系统内区分与识别该小程序主体; - **支撑授权登录**:配置完成后,小程序端可调用后端接口实现 openid 获取与免密登录; - **支撑跳转与分发**:配合「跳转小程序列表」模块,实现公众号、H5 页面跳转到指定小程序页面。 --- ## 1. 功能说明 「微信小程序配置」用于将 MuuCmf 系统与微信小程序对接。配置内容分为两部分: - **基本信息**:小程序名称、小程序简介,用于系统内标识与展示该小程序; - **接口配置**:原始ID、AppID、AppSecret,用于系统与微信小程序后台的接口通信与身份校验。 其中,AppID 与 AppSecret 是对接成功的关键:系统通过这对凭证向微信服务器换取 access_token,进而调用小程序接口(如获取用户 openid、生成小程序码、发送订阅消息等)。原始ID 用于在小程序后台之外的场景识别该小程序主体,属辅助标识。 配置完成后,需在小程序后台配置**服务器域名**(request 合法域名等),小程序端才能正常调用 MuuCmf 提供的接口。 ## 2. 功能入口 左侧导航:**渠道 → 微信小程序 → 微信小程序配置** 进入方式:点击顶部「渠道」菜单 → 左侧「微信小程序」展开 → 选择「微信小程序配置」子项,右侧主区域即显示小程序配置表单页面。  ## 3. 页面组成 微信小程序配置页面为表单式配置界面,自上而下分为三部分: | 区域 | 内容 | | --- | --- | | 基本信息 | 小程序名称、小程序简介 | | 接口配置 | 原始ID、AppID、AppSecret(密码形式输入,可点击图标显示) | | 操作区 | 页面底部「保存配置」「重置」按钮 | ## 4. 配置项说明 ### 4.1 基本信息 | 配置项 | 用途说明 | 填写说明 | | --- | --- | --- | | 小程序名称 | 小程序的显示名称(必填,带 * 标记) | 填写小程序名称,如「MuuCmf应用演示」,长度上限 100 字 | | 小程序简介 | 小程序的简要介绍 | 填写小程序简介,如「MuuCmf知识付费系统」,长度上限 200 字 | ### 4.2 接口配置 | 配置项 | 用途说明 | 填写说明 | | --- | --- | --- | | 原始ID | 小程序的原始标识(可不填) | 形如 `gh_xxxxxxxxxxxx`,可在小程序后台「设置 → 基本设置」中查看,长度上限 50 | | AppID | 小程序的唯一应用标识(必填,带 * 标记) | 填写小程序后台「开发 → 开发管理 → 开发设置」中的 AppID(wx 开头的一串字符),长度上限 50 | | AppSecret | 小程序的开发者密钥(必填,带 * 标记) | 填写同一位置的 AppSecret;密码形式输入,点击右侧眼睛图标可显示明文,请妥善保管 | --- ## 5. 微信小程序接入步骤 ### 5.1 前置准备 1. 准备一个**已注册并完成认证**的微信小程序账号; 2. 确认小程序已添加开发者/体验成员,且当前操作者拥有小程序后台管理权限; 3. 确认 MuuCmf 站点已部署在**已备案的 HTTPS 域名**下(小程序只允许请求 HTTPS 合法域名); 4. 登录微信公众平台(小程序)后台:`mp.weixin.qq.com`,选择对应小程序进入。 ### 5.2 开始配置 **根据小程序新政策要求,为小程序登录能够获取到用户头像和昵称,请先登录微信公众平台更新“用户隐私保护指引”**。具体操作参考以下方法: 登录微信小程序平台-左下方点你自己的小程序名称-账号设置  在打开的基本设置页面下拉  下拉到服务内容声明-用户隐私保护指引这里,点击右侧去完善(或生成)  在弹出的选择框里勾选第二项(红框部分)后确定。  在弹出的选择框里勾选【用户信息(微信昵称、头像)】【手机号】【相册(仅写入)权限三项,**有资料下载应用的还要勾选【剪切板】**后确认。  1、开发者处理的信息,可参考下方截图增加信息类型  注:内容根据您自身情况填写,下方提供内容仅供参考**(由于每个小程序审核员审核严格程度不同,如未通过审核,请咨询小程序官方在线客服)**: 为了【简化登录流程,通过手机号快速识别用户身份,提升体验】,开发者将在获取你的明示同意后,收集你的手机号。 为了【便于用户保存图片】,开发者将在获取你的明示同意后,使用你的相册(仅写入)权限。 为了【便于用户更快的登录信息和更好的交互体验】,开发者将在获取你的明示同意后,收集你的微信昵称、头像。 开发者收集你选中的照片或视频信息,用途是【用户更换用户头像和上传有必要的照片或视频内容】。 开发者读取你的剪切板,用途是【用户可复制本小程序提供的文本内容】 开发者收集你选中的文件,用途是【用户可分享和发布如音频、文档等类型的内容互动】 3.3、你的权益里要添加您的电话和邮箱;4.1、勾选"开发者承诺,除法律法规另有规定外.....”这条;5.2、填写内容可参考:本小程序首页显著位置显示和弹出公告  同时,在此页面有小程序订单中心path设置项,**特别注意:此项需待小程序发布后方可填写**,点击右侧设置按钮  将Muu云课堂小程序订单列表路径:/micro/pages/my/orders/list,填入小程序订单中心path设置框内,点击确定等待官方审核即可。  申请注册小程序,流程请点开此链接,按步骤操作: https://kf.qq.com/faq/170109iQBJ3Q170109JbQfiu.html 1、打开微信公众号平台,扫码登录小程序-【管理】-【开发设置】  在开发者ID里获取Appld,AppSecret  2、如需要通过官方后台在线发布小程序,需要在此页面-【小程序代码上传】,关闭IP白名单。**特别注意:需在管理后台-微应用DIY-资源包里上传小程序代码密钥后方可关闭白名单**  3、返回首页-左下方点你自己的小程序名称-账号设置  在打开的基本设置页面下拉  在账号信息里获取原始ID  4、登录MuuCmf T6管理后台-【渠道】-【微信小程序配置】,填写您的小程序名称,小程序简介,将上述获取的Appid,AppSecret,原始ID粘贴进去,确定保存即可。  5、返回小程序平台首页-【管理】-【开发设置】  下拉此页面-服务器域名,将您自己的授权域名分别填入五个合法域名里,域名格式按相应开头的要求填。  6、下拉此页面,设置小程序业务域名,下载校验文件,将此文件上传到您的宝塔-文件-www-wwwroot-您的授权域名-public根目录下。(如上传后填写域名时,仍提示图中报错,请返回上一级重新进入该页面填写域名即可)。   将您自己的授权域名填入业务域名里  注意:小程序只支持https,您需要给您的授权域名安装部署SSL证书,具体要求如下  小程序上传问题:我们为付费购买了微页DIY的用户提供了小程序上传功能,请到应用-微页DIY-资源包列表里直接上传小程序   具体操作方法参见手册应用-微页DIY-资源包列表 https://www.muucmf.cc/help/document/detail.html?id=165 **开通及绑定微信开放平台 ** 为实现公众号,小程序用户数据同步,需将公众号和小程序绑定到微信开放平台里,具体操如下: 微信开放平台开通认证方法请参见以下链接操作:https://jingyan.baidu.com/article/8275fc8670af2546a13cf65d.html 开通后,扫码登录微信开放平台,在【管理中心】-【公众账号】绑定对应公众号  在【管理中心】-【小程序】绑定对应小程序即可。  ### 5.3 验证接入 1. 在小程序开发者工具或真机中打开小程序,触发需要后端接口的功能(如登录、获取用户信息); 2. 确认接口请求成功、能正常返回数据,说明 AppID/AppSecret 配置正确、域名配置有效; 3. 若登录失败,重点排查:AppSecret 是否正确、是否被重置、request 域名是否已配置、服务器 IP 是否在白名单、后台是否已点击保存配置。 --- ## 6. 操作方法(通用) ### 6.1 保存配置 填写完成后点击页面底部「保存配置」按钮提交,配置即时生效。 ### 6.2 重置 点击「重置」按钮,可将表单内容恢复为默认/上次保存状态,用于重新填写。 ### 6.3 查看与修改 AppSecret AppSecret 默认以密文显示,点击输入框右侧的眼睛图标可切换为明文查看;修改时直接重新粘贴新的 AppSecret 并保存即可。 --- ## 7. 使用建议 1. AppID 与 AppSecret 是接口调用核心凭证,必须填写准确,否则无法获取 access_token,小程序登录等功能全部失效; 2. AppSecret 属高敏感凭证,请勿在文档、聊天或代码仓库中明文传播;一旦泄露应立即在小程序后台重置并同步更新后台配置; 3. 小程序后台重置 AppSecret 后,旧值立即失效,务必第一时间更新 MuuCmf 后台,避免线上登录、支付等能力中断; 4. request 合法域名必须为 HTTPS 且不带路径,域名需已备案;每月修改次数有限,请提前规划; 5. 原始ID 为选填项,主要用于辨识小程序主体,建议一并填写便于后续维护; 6. 小程序需内嵌 H5 页面时,必须额外配置业务域名并上传校验文件,否则 web-view 打开会失败; 7. 接入后务必在开发者工具与真机环境各验证一次,确认接口调用正常。 --- ## 附录:配置项与小程序后台对应表 | 后台配置项 | 小程序后台位置 | | --- | --- | | AppID | 开发 → 开发管理 → 开发设置 → 开发者ID → AppID | | AppSecret | 开发 → 开发管理 → 开发设置 → 开发者ID → AppSecret | | 原始ID | 设置 → 基本设置 → 账号信息 → 原始ID | | 接口请求域名 | 开发 → 开发管理 → 开发设置 → 服务器域名 → request 合法域名 | | 内嵌网页域名 | 开发 → 开发管理 → 开发设置 → 业务域名 | | 服务器 IP 白名单 | 开发 → 开发管理 → 开发设置 → IP白名单 | 按以上步骤操作,即可完成 MuuCmf T6 后台微信小程序配置的接入。