WordPress 小程序开源免费版更新说明及安装指南

丸子小程序资讯版和社区版功能强大，UI 更优秀，一次付费，永久授权使用，免费更新，无年费，长期技术支持。点击这里了解

距离丸子小程序团队在今年(2019年)7月份发布了一款四端的开源小程序(查看详情:丸子小程序正式开源免费)已经过去了将近四个月了。由于当初发布的时间比较赶，有些细节上的东西没有完善的更好，导致在安装调试过程中总是会遇到问题。同时，部分功能其实已经开发出来，但是并没有增加到开源版中。于是，趁着微信小程序即将下线模板消息功能，需要更新消息功能为订阅消息之际，丸子小程序团队在更新了系列小程序(丸子小程序社区版和丸子小程序资讯版)的订阅消息功能之后，也为丸子小程序开源免费版更新订阅消息，并且更新完善开源免费版的部分功能。

此次，丸子小程序开源免费版的更新没有同步更新线上版本，其实 UI 设计并没有太大差别，主要是更新了一些功能和优化了一些细节。因此，可以通过以下二维码查看对应的小程序演示效果。

丸子小程序开源免费版更新说明

一、公共更新

1、更新个人中心授权登录样式

2、更新优化详情页的点赞和收藏功能

3、更新优化我的点赞、我的收藏、我的评论文章列表翻页功能

二、其他更新

1、微信小程序

(1).更新回复评论消息通知模板消息功能为订阅消息评论回复提醒通知

(2).更新评论发布提示信息及订阅消息评论审核通过通知

(3).个人中心增加资讯更新提醒通知订阅(即用户点击订阅更新后,插件设置启用更新提醒后，发布文章更新时，即时推送服务消息通知用户)

(4).更新增加微信小程序分享海报功能。

(5).更新增加微信小程序流量主功能，分别支持首页列表、分类列表和文章详情底部

2、QQ 小程序

(1).更新优化回复评论消息通知模板消息功能

(2).更新移除个人中心 QQ 小程序不支持的功能

(3).更新增加 QQ 小程序分享海报功能(需要下载自己的 QQ 小程序码替换掉 images 目录的 QQ 小程序码)。

(4).更新增加 QQ 小程序流量主功能，分别支持首页列表、分类列表和文章详情底部

3、百度智能小程序

(1).更新优化回复评论消息通知模板消息功能

(2).更新移除个人中心百度智能小程序不支持的功能

(3).更新增加百度智能小程序流量主功能，分别支持首页列表、分类列表和文章详情底部(需要更改这三个页面的 AppID 为自己的百度智能小程序 AppID )。

4、字节跳动小程序

(1).更新优化回复评论消息通知模板消息功能

(2).更新移除个人中心字节跳动小程序不支持的功能

丸子小程序开源免费版安装指南

一、网站要求

1、WordPress 网站版本必须是 Version 4.9.5 以上，插件经过测试，支持 WordPress Version 5.3.0 版本。

2、网站不能同时使用其他版本小程序插件，网站主题或者插件不能禁用 WordPress REST API 功能。(如何查看插件或主题是否禁用 REST API 功能，点击这里)

3、网站必须支持 SSL 证书加密，即要支持 HTTPS 访问。网站主域名必须有备案，否则，无法加入小程序后台的域名请求列表

4、网站必须安装 Mini Program API 插件

5、网站服务器必须支持伪静态链接，即设置固定链接为除了朴素以外的任意一种。需要注意，固定链接地址必须不包含 index.php

二、小程序开发配置

小程序开发需要提前配置相关信息，这里主要介绍小程序的开发配置，以微信小程序为例，其他小程序平台类似。

1、获取 AppSecret(小程序密钥)

点击 AppSecret(小程序密钥) 右边的重置，然后按要求进行获取，将获取到的 AppID(小程序ID) 和 AppSecret(小程序密钥) 填写至小程序 – 授权设置相关选项中。点击这里查看小程序 – 授权设置介绍

2、服务器域名

点击 服务器配置 里的修改，按要求扫码二维码修改相关域名配置

request 合法域名：小程序请求数据域名，一般情况下只需要填写网站域名即可，但是，涉及需要请求的数据都要加入此列表中。

socket 合法域名：需要根据个人情况而定，丸子小程序建议填写网站域名即可。

uploadFile 合法域名：上传文件服务器绑定的域名，需要根据个人情况而定，一般情况下填写网站域名。

downloadFile 合法域名：下载文件请求域名，需要根据个人情况而定，一般情况下填写网站域名以及 CDN 域名。

udp 合法域名：需要根据个人情况而定，一般情况下默认为空即可。

三、插件设置

1、小程序授权

获取对应的小程序 AppID 和 AppSecret 填写。注意，百度智能小程序填写的是 AppKey 和 AppSecret 。这一部分影响小程序用户授权登录，如果设置错误，则无法正常授权登录，也就不能评论，点赞和收藏等。

2、常规设置

(1).小程序信息填写。这部分没有特别要求，默认情况下为网站信息内容。

(2).文章格式类型可选。这部分目前对于小程序没有特别影响，可选可不选。

(3).默认缩略图必须填写。这部分主要针对文章无图的情况下采用默认图片。

(4).downloadFile合法域名根据小程序开发配置里的服务器域名中 downloadFile 合法域名填写，有多少个 downloadFile 合法域名就填多少个。注意，只需要填写域名，不需要带 https

(5).消息通知模板 ID 。根据插件设置提示里的内容选择合适的消息模板 ID 填写即可。注意：需要根据提示里的说明选择关键词，并且根据提示的说明对关键词排序，一定不能缺少或者排序错误。

3、功能扩展

这部分可以根据自己的情况而定，需要注意的是 启用更新提醒 这一项。启用更新提醒主要是针对微信小程序的内容更新提醒通知，启用后，发布文章或者定时发布文章时，都会自动推送订阅消息给已经有订阅更新的用户。如果发表的文章不需要推送消息通知，则建议一定要取消启用。

4、广告功能

目前丸子小程序开源免费版支持广告功能的分别有：微信小程序、QQ 小程序和百度智能小程序。而且，仅支持流量主广告。另外，虽然有三个小程序选项，但是，不能同时设置流量，即首页如果使用了微信小程序流量主，则不能使用 QQ 小程序或者百度智能小程序流量主。如果想要对应的页面显示流量主，则需要自己参考代码进行二开修改。

四、小程序代码配置

1、公共部分

微信小程序、QQ 小程序、百度智能小程序和字节跳动小程序都需要修改基本配置文件 base.js 里的网站域名。base.js 文件在小程序源码包的 utils 目录里，把 const API_HOST = 'https://demo.imahui.com' 里面的域名改成自己的网站域名

2、其他配置

(1).微信小程序源码包还需要修改 base.js 里的模板 ID 内容。即 const templates = {} 里面的模板 ID 要改成自己在微信小程序平台里开通的订阅消息选择的模板 ID 。其他无特别更换说明，图标都放在 images 目录里，可以根据自己情况进行替换。同时，需要修改 detail.js 里生成海报的部分文字，具体自己查看 detail.js 里的海报生成部分。

(2).QQ 小程序需要更新源码包里的 images 的小程序码。即替换 images 里的 qrcode.png 为自己的 QQ 小程序码。由于 QQ 小程序目前不支持生成指定路径的小程序码文件，QQ 小程序的海报小程序码只能使用 QQ 小程序默认小程序码。同时，需要修改 detail.js 里生成海报的部分文字，具体自己查看 detail.js 里的海报生成部分。

(3).百度智能小程序需要更改每个页面里的 swan.setPageInfo 相关信息，这是百度智能小程序 Web 化信息功能。另外，需要把 index.swan、detail.swan 和 list.swan 里的广告部分的 appid 更换为自己的小程序 appid 。

五、定制数据

完成上面四个部分，基本上就已经配置安装完成。但是，还是有个别需要对数据输出进行过滤的，比较常见的是限制某一个或者多个分类文章显示，又或者是仅显示一个或者多个分类文章显示。高级专业版插件是支持屏蔽某一个或者多个分类文章数据调用设置，而不需要修改小程序源码的。开源免费版则需要修改小程序源码才能实现。

以下仅用首页数据调用为示例说明：

1、限制某一个或者多个分类数据输出

修改与 this.getPostList(); 相关的数据获取功能，即增加参数过滤。比如 onLoad 部分改为 this.getPostList({categories_exclude:'1,2,3'}); 即过滤分类目录 ID 为 1,2,3 的文章调用。下面每个 this.getPostList 都需要加上 categories_exclude:'1,2,3'

2、仅调用某一个或者多个分类数据输出

修改与 this.getPostList(); 相关的数据获取功能，即增加参数过滤。比如 onLoad 部分改为 this.getPostList({categories:'1,2,3'}); 即过滤分类目录 ID 为 1,2,3 的文章调用。下面每个 this.getPostList 都需要加上 categories:'1,2,3'

3、显示某一个或者多个分类列表

修改与 this.getCategories(); 相关的数据获取功能，即增加参数过滤。比如this.getCategories({include:'1,2,3'}); 即过滤排除分类目录 ID 为 1,2,3 的分类调用。下面每个 this.getCategories 都需要加上 include:'1,2,3'

4、排除某一个或者多个分类列表

修改与 this.getCategories(); 相关的数据获取功能，即增加参数过滤。比如this.getCategories({exclude:'1,2,3'}); 即过滤排除分类目录 ID 为 1,2,3 的分类调用。下面每个 this.getCategories 都需要加上 exclude:'1,2,3'

六、其他说明

丸子小程序开源免费版已经可以满足大部分需求，如果想要更好或者更优秀的功能，建议联系我们购买专业版，使用高级专业插件。目前丸子小程序专业版分别有丸子社区和丸子资讯(即艾码汇版本)。购买咨询，搜索客服微信号：hackdxd ，或者搜索我的个人微信号：e80111947 添加微信好友。

丸子小程序开源免费版常见问题

1. 订阅时提示“未找到匹配 URL 和请求方式的路由”

需要更新插件至 1.2.2 以上版本，建议更新至最新版本。

2. 订阅时提示“订阅消息失败”

先停用插件再重新启用，再测试订阅。如果测试仍然失败，访问数据库管理查看是否创建了 applets_subscribe_user 和 applets_subscribe_message 相关的数据表。如果没有创建，需要自己手动创建。

3. 开发版是否支持订阅推送

开发工具有可能不支持订阅 API ，升级最新版开发工具测试。建议通过预览开发版，体验版或者线上版测试订阅是否成功。订阅成功后，无论是开发版还是体验版或者线上版，都可以通过后台发文章测试订阅推送。

4. 更新文章时，未接收到文章更新提醒

需要先查看推送任务中是否有触发推送任务，一般情况下，触发了推送任务，不论成功或者失败，都会在推送任务列表中。如果出现在任务列表中，则看任务列表是什么错误提示。如果无法得知具体的错误，可以访问数据库查看数据表信息。

5. 订阅推送消息通知常见错误

（1）Openid 错误：一般情况下都是 OpenID 为空造成的，检查用户信息是否有 openid 信息。

（2）消息模板错误：订阅消息模板选用错误，或者消息模板关键词选用错误，又或者消息模板关键词排序错误，也可能推送的内容某个关键词内容为空

6. 分享海报生成时，二维码不存在或者生成失败

（1）如果部分二维码失败，有可能初始生成二维码时失败，导致了后面怎么生成都不成功，需要手动删除上传目录下的 qrcode 目录里的二维码文件再重新尝试生成。

（2）如果生成海报失败，检查服务器目录权限，查看上传目录下是否有 qrcode 目录，并且该目录下是否有二维码文件。如果没有的话，先手动创建 qrcode 目录，并且设置权限组为 www 权限为 755 。

（3）如果生成海报下载时提示失败，需要把分享海报的封面缩略图地址和网站域名，以及 CDN 域名添加到小程序后台的服务器配置里的 DownloadFile 合法域名。同时，插件设置里也不能缺少同样的配置。

7.导入的首页为什么显示不出文章列表

目前，除了微信小程序开发工具导入项目时，文件不会被替换，其他小程序开发工具导入或者打开项目目录时都有可能会被开发工具生成的首页替换。

因此，建议以下步骤安装调试：

新建一个项目，填写相关的 AppId ，然后设置一个空目录。

然后，关闭开发工具，按下面的说明进行

（1）微信小程序保留 project.config.json 文件，其他都删除，然后，把微信小程序源码放入目录中。

（2）QQ 小程序保留 project.config.json 文件，其他都删除，然后，把 QQ 小程序源码放入目录中。

（3）百度智能小程序保留 pkginfo.json 和 project.swan.json 文件，其他都删除，然后，把百度智能小程序源码放入目录中。

（4）字节跳动小程序保留 project.config.json 文件，其他都删除，然后，把字节跳动小程序源码放入目录中。

最后，重新打开开发工具进行调试上传。

8. 提交审核拒审，要求完善内容审核机制

Mini Program API 插件已经接入了微信内容安全文本检测功能。但是，并不是所有评论内容都会被文本检测过滤，特别是审核人员为了测试内容安全问题，故意发布的内容不一定会被屏蔽。因此，建议开启评论审核。

方法：进入后台，点击 设置 - 讨论 ，找到 在评论显示之前 ，勾选 评论必须经人工批准。

9. QQ 小程序不允许有评论功能怎么办

个人主体的 QQ 小程序不允许有评论功能，那么就把评论功能给删除就行。

打开 detail.qml 把 <view class="bottom"> 到 <view bindtap="closeCommentary" class="pagemake" qq:if="{{showTextarea}}"></view> 这部分内容删除，再重新上传提交审核。

丸子小程序开源免费版下载地址

一、免费版插件

1、访问 WordPress 插件中心下载：点击这里

2、关注 WordPressTalk 公众号(或者 艾码汇 公众号)，回复：9527 直接获取插件安装包下载地址

3、访问 GitHub 开源社区下载插件源码：点击这里

二、小程序下载

1、访问 WordPress 小程序资源下载站 获取小程序

2、访问 GitHub 开源社区下载小程序源码：点击这里

3、访问 GiTee 开源社区下载小程序源码：点击这里

4、关注 WordPressTalk 公众号，回复：0722 直接获取小程序源码包下载地址

注意：丸子小程序开源免费版更新请关注 艾码汇 博客, WPSTORM 或者 WordPressTalk 公众号