使用WordPress小程序之前首先你得有一个可以访问的由WordPress搭建的网站,并且已经开启网站的SSL(HTTPS)。
以下是WordPress版微信小程序安装使用说明:
1.安装WordPress
1、首先保证你的WordPress版本在4.7以上,因为这个版本开始才有reset api,小程序才能从你的站点获取数据。
2、保证你使用的主题没有禁用rest api,或者没有插件禁用rest api(建议在默认主题下关闭所有插件调试)
2.配置微信小程序的服务器域名和业务域名
在微信小程序公众平台的后台里,选择“开发”=>“开发设置”,对“服务器域名”和“业务域名”进行配置,如下图:
其中request合法域名
必须配置,这个参数保证了小程序可以正常发送request
请求,程序才能运行起来。同时,这个域名必须备案。
“业务域名”主要用于web-view内嵌网页时,用作域名白名单,如果不是业务域名里的域名,在web-view内嵌里访问网页时,就会报无法访问的错误。
注意:个人小程序是没有“业务域名”这个配置的。
3.配置HTTPS
如果你的网站支持HTTS就可以忽略这步,由于小程序的request等请求是需要HTTPS的,因此需要网站支持HTTPS,关于WordPress网站开启请参考您自己域名及主机服务商的介绍,可以在服务商里提交“WordPress 整站开启 HTTPS 协议,SSL证书”关键字搜索
注意:一定要保证https和http两种方式都能正常访问网站,才能改这个配置,否则可能导致网站无法访问。
4.安装WordPress插件: REST API TO MiniProgram
之所以安装这个插件,是因为WordPress 官方的rest json api 不能满足小程序定制化的需求,需要安装插件作为官方api的补充,这个插件基本是按官方api二次开发的规范定制的。
也可以利用插件的下载地址:REST API TO MiniProgram :https://wordpress.org/plugins/rest-api-to-miniprogram/
此插件已经在wordpress官方插件库上架(REST API TO MiniProgram ),安装后,后续的更新都可以在线完成。
插件安装启用后,需要在后台配置一些参数:
1)wordpress后台 => 设置 =>微信小程序设置
在这个配置界面配置AppID
,AppSecret
,小程序首页滑动文章ID,
前面两个参数在微信小程序的后台可以查到,这里就不赘述。“小程序首页滑动文章ID
”这个参数是为了显示首页滑动轮播的文章。这里的设计我偷了懒,良好的设计应该弹出一个选择框,让用户来选择文章,而不是给个输入框输入id。
文章id如何在wordpress后台找到呢?其实很简单,看下图你就明白了:
2)wordpress后台 => 分类目录 =>选择一个分类进行编辑
这里设置后,在小程序里“专题”页就会看到封面图片了。
5.安装Wordpress版微信小程序:winxin-app-watch-life.net
下载的地址:https://github.com/iamxjb/winxin-app-watch-life.net
有关在微信小程序的开发工具新建项目,导入程序,我就不赘述了,可以去搜索微信小程序的官方文档,有详细的介绍。
微信小程序项目创建好了后,打开config.js文件,config.js文件的路径如下图:
var DOMAIN = "www.qyblog.cn";
//配置域名,域名只修改此处var WEBSITENAME = "轻语博客";
//网站名称var PAGECOUNT= 1136;
//每页文章数目var ZANIMAGEURL = 'https://www.qyblog.cn/images/zs.jpg';
//微信鼓励图片链接,个人小程序赞赏var LOGO = '../../images/logo.png';
//网站的LOGO图片配置好以上参数,可以让小程序正常运行。其中:DOMAIN
就是wordpress所在服务器的域名;ABOUTID
是wordpress的“页面”的id,这个页面id的获取和上面说的文章id类似。ZANIMAGEURL
是微信鼓励图片链接,个人小程序赞赏。LOGO
是网站的LOGO图片。配置到这里就已经可以让小程序正常使用了,下面的配置根据注释可以配置到即可。