一、网站要求

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

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 小程序和百度智能小程序。而且,仅支持流量主广告。

四、小程序代码配置

1、网站域名配置

修改基本配置文件 base.js 里的网站域名。base.js 文件在小程序源码包的 utils 目录里,把 const API_HOST = 'https://demo.imahui.com' 里面的域名改成自己的网站域名

2、订阅消息配置

微信小程序源码包需要修改 base.js 里的模板 ID 内容。即 const templates = {} 里面的模板 ID 要改成自己在微信小程序平台里开通的订阅消息选择的模板 ID

3、生成海报配置

需要修改 detail.js 里生成海报的部分文字,具体自己查看 detail.js 里的海报生成部分。主要修改小程序名称和小程序描述内容。

4、其他配置说明

小程序图片文件目录 images ,可以根据自己需要自行替换

五、定制数据

完成上面四个部分,基本上就已经配置安装完成。但是,还是有个别需要对数据输出进行过滤的,比较常见的是限制某一个或者多个分类文章显示,又或者是仅显示一个或者多个分类文章显示。

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

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

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

方法二:打开 api.js ,找到 getPostsList 函数,修改 return API.get('/wp-json/wp/v2/posts', data, { token:true });return API.get('/wp-json/wp/v2/posts?categories_exclude=1,2,3', data, { token:true });即可

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

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

方法二:打开 api.js ,找到 getPostsList 函数,修改 return API.get('/wp-json/wp/v2/posts', data, { token:true });return API.get('/wp-json/wp/v2/posts?categories=1,2,3', data, { token:true });即可

六、常见问题

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 合法域名。同时,插件设置里也不能缺少同样的配置。

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

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

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