WordPress 微信小程序开源免费版 Travel Mini Program 安装指南教程

一、网站要求

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 });即可

3、限制某一个或者多个分类在分类页面显示

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

方法二:打开 api.js ,找到 getCategories 函数,修改 return API.get('/wp-json/wp/v2/categories?orderby=id&order=asc', data);  return API.get('/wp-json/wp/v2/categories?orderby=id&order=asc&exclude=1,2,3', data);即可

4、仅显示某一个或者多个分类在分类页面

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

方法二:打开 api.js ,找到 getCategories 函数,修改 return API.get('/wp-json/wp/v2/categories?orderby=id&order=asc', data);  return API.get('/wp-json/wp/v2/categories?orderby=id&order=asc&include=1,2,3', data);即可

六、常见问题

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

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

版权声明:
作者:路小白
链接:https://www.yxey.cn/xcx/411541.html
来源:营销二院路小白个人品牌自媒体平台博客
文章版权归作者所有,未经允许请勿转载。

THE END
分享
二维码
< <上一篇
下一篇>>