丸子小程序开源免费版安装指南
一、网站要求
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'
六、其他说明
丸子小程序开源免费版已经可以满足大部分需求,如果想要更好或者更优秀的功能,建议联系我们购买专业版,使用高级专业插件。目前
丸子小程序专业版分别有丸子社区和丸子资讯(即艾码汇版本)。购买咨询,搜索客服微信号:hackdxd ,或者搜索我的个人微信号:e80111947 添加微信好友。