wx-app：微慕 WordPress 资讯微信小程序部署与接入指南

wx-app（微慕 WordPress 小程序开源版）是一套以 WordPress 为后台的资讯/博客微信小程序前端。它把 WordPress 站点的文章、分类、评论、页面等内容通过 REST API 同步到小程序端，支持一键同步到微信小程序，让你用熟悉的 WordPress 建站就能快速拥有一个内容资讯小程序。

说明：该项目前端仓库实际路径为 iamxjb/winxin-app-watch-life.net（「微慕」开源版），配套后端插件为 rest-api-to-miniprogram；本文按发布约定使用 slug wx-app。

一、项目官方信息

二、官方图片

微慕小程序开源版案例展示图：

三、环境要求

• 一个可正常访问的 WordPress 站点（作为内容后台）；
• 微信开发者工具 + 已注册的小程序 AppID；
• 在 WordPress 后台安装配套插件 rest-api-to-miniprogram，并启用 REST API；
• 服务器需支持 HTTPS（小程序网络要求），并把小程序后台的 request 合法域名配置为你的 WordPress 域名。

四、部署/接入步骤

1. 安装后端插件

在 WordPress 后台安装并启用配套插件 rest-api-to-miniprogram（开源版插件仓库：https://gitee.com/iamxjb/rest-api-to-miniprogram ）。插件负责把 WordPress 的文章、分类、评论等数据通过 REST API 暴露给小程序前端，并提供评论、点赞、赞赏、订阅等配套接口。

2. 下载小程序前端源码

从 Releases 下载最新稳定版源码（推荐）：

• Gitee Releases：https://gitee.com/iamxjb/winxin-app-watch-life.net/releases
• 镜像：https://github.com/iamxjb/winxin-app-watch-life.net

3. 导入微信开发者工具

打开微信开发者工具，选择「导入项目」，把下载解压后的前端源码目录导入，填入你自己的小程序 AppID。

4. 配置后端 API 地址

在小程序源码的配置文件中，把 WordPress 站点地址（即后端 API 根地址）改成你自己的 HTTPS 域名。这一步是资讯类小程序接入的关键：前端所有文章列表、详情、评论请求都基于这个地址。

同时到微信公众平台「开发 → 开发设置 → 服务器域名」里，把该 WordPress 域名加入 request 合法域名，否则真机无法请求。

5. 编译预览与提审

在开发者工具中编译预览，确认文章列表、详情、评论能正常拉取；确认无误后上传代码，在微信公众平台提交审核，审核通过后发布。

更细的字段、评论开关、支付/赞赏配置等，以官方安装文档为准：https://docs.minapper.com/minfree

五、使用方法

微慕开源版内置了面向资讯博客的完整能力（README 功能清单）：

• 文章列表以缩略图展示，含分类、发布时间，支持分页加载；首页轮播指定文章；
• 文章详情页支持站内链接跳转、站外链接复制、「猜你喜欢」相关文章；
• 评论：查看、发表、回复、分页，显示微信用户头像（可在设置里开关）；
• 文章排行（浏览数、评论数、点赞数、赞赏数）、全文搜索；
• 支持分享/转发、朋友圈、文章海报卡片、web-view 内嵌网页跳转；
• 微信用户授权登录、点赞头像、微信支付赞赏、订阅专题；
• 图片懒加载与二维码识别、小程序直播、视频号、微信搜一搜接入；
• 文章列表样式可自定义（左图/右图/多图/大图/无图/瀑布流），并带「发现」「那年今日」等列表。

六、常见问题 FAQ

Q1：导入后真机请求不到文章？ 检查两点：①小程序源码里的后端 API 地址是否改成了你的 HTTPS 域名；②微信公众平台「服务器域名」是否把该域名加进了 request 合法域名。

Q2：WordPress 后台要装什么？ 需要安装配套插件 rest-api-to-miniprogram，由它提供小程序所需的 REST API 与评论/点赞/赞赏等接口。

Q3：评论功能不显示？ 评论可在插件/小程序设置中开关；确认 WordPress 文章本身开放了评论，并已配置好微信用户授权登录。

Q4：最新版本是多少？哪里下载？ 开源版当前为 v5.1.0，稳定版在 Gitee Releases（https://gitee.com/iamxjb/winxin-app-watch-life.net/releases）下载，GitHub 为镜像仓库。

Q5：遇到问题先看哪里？ 官方建议先查阅安装文档 https://docs.minapper.com/minfree ，大部分问题（域名、评论开关、支付配置）都在文档里；仍有问题可到官方论坛发帖并附上报错截图。

Q6：开源版和商业版什么区别？ 开源版基于 Apache-2.0 可自由使用；官方在其基础上提供更多功能的商业版（专业版/增强版）及 API 缓存、视频号主页、扫码登录、微信小店等付费扩展，详情见官网 https://www.minapper.com 。

七、跳转链接

• GitHub 仓库：https://github.com/iamxjb/winxin-app-watch-life.net
• 官方网站：https://www.minapper.com
• 安装文档：https://docs.minapper.com/minfree
• 后端插件：https://gitee.com/iamxjb/rest-api-to-miniprogram
• 源码下载（Gitee Releases）：https://gitee.com/iamxjb/winxin-app-watch-life.net/releases