WordPress 小程序插件使用教程（一）

WordPress 小程序插件设计完成后，一直忙于更新旧版插件的小程序，比如艾码汇和微语录小程序与新版插件的数据连接，在这过程中，也一边修复完善插件的 Bug ，到现在为止，基本上已经是没有大问题了，那就抽个时间写一下使用教程吧。[教程插件：WordPress 小程序 API 插件，连接微信、QQ、百度、头条小程序]

把压缩包下载之后，在网站后台插件 - 安装插件 - 上传插件 ，等待安装完成之后，则可以启用插件。

启用插件后的界面如下图：

填写插件授权激活码点击立即验证即可验证激活小程序 API 插件。

如果服务器支持 Opcache 内存管理扩展和 Memcached 缓存扩展，则在使用指南页面可以看到清理缓存功能。

一、小程序授权

此项设置非常简单，填写小程序的 AppId 和 AppSecret 。插件支持微信小程序、QQ 小程序、百度智能小程序、字节跳动(今日头条)小程序，如图所示：

除了不同的小程序平台需要填写对应的 AppId 和 AppSecret 之外，还提供了一个用户选项。默认用户组为订阅组，提供了一个小程序组选项，方便把小程序授序登录的用户都归类于小程序组，小程序组的用户权限与订阅组的用户权限是一致的。

另外，启用插件时，默认为创建三个用户组，分别是小程序组，黑名单组，白名单组。新创建的三个用户组权限是一样的，不同之处在于，发表话题或者评论时，黑名单组用户是禁止发布的，白名单组用户则发表话题或者评论时，默认是通过审核。注意：如果插件没有开启发表话题或者评论需要审核时，则除了黑名单被禁止发表外，其他用户组都是不需要审核即时发布内容。

另外，如果在新建用户的时候，没有小程序组选项的时候，则需要自己手动创建小程序组，创建方法如下：

add_role( 'wechat', '微信组', array( 'read' => true, 'level_0' => true ) );
add_role( 'black', '黑名单', array( 'read' => true, 'level_0' => true ) );
add_role( 'white', '白名单', array( 'read' => true, 'level_0' => true ) );

把上面的代码加入到主题 functions.php 里，然后，清除一下缓存，再刷新页面。

完成之后，尝试到用户中心处新建用户，查看角色分组是否有小程序组，如果有小程序组，则已经创建成功了。

创建角色成功之后，可以删除上面那段代码。不删除有没有影响？影响不大，但是终究不太好，所以建议还是完成之后删除对应的代码。

此外，插件提供了小程序扫码登录网站后台功能，开启小程序扫码登录后，可以设置扫码登录的页面。扫码登录的页面指的是通过小程序扫码确认登录后，自动跳动的页面。如果网站的主题支持用户中心，可以设置为用户的个人中心。比如：https://www.imahui.com/user 。默认是跳转到用户首页，但是千万要注意的是，不要设置跳转到登录页，免得扫码登录确认后，依然停留在当前扫码页。

二、常规设置

1.小程序名称

此处填写小程序的名称，在微信小程序源码里使用对应的 API 可以获取对应的小程序名称展示在 title 上。

2.小程序描述

此处填写小程序的描述，在微信小程序源码里使用对应的 API 可以获取对应的小程序名称展示在 description 上。

3.小程序版本

此处填写小程序的版本，在微信小程序源码里使用对应的 API 可以获取对应的小程序名称展示在 version 上，默认留空时，则使用 WordPress 版本号。

注意：小程序名称、小程序描述，小程序版本都是同一个 API 获取的数据。

4.文章格式类型

文章格式类型，主要是为了给文章设置不同形式的格式，比如视频格式，音频格式。如果需要添加视频形式和音频形式，则填写 video,audio 即可。

文章格式包括：日志(aside), 相册(gallery), 链接(link), 图像(image), 引用(quote), 状态(status), 视频(video), 音频(audio), 聊天(chat)

注意：单词之间一定要用英文逗号“,” ，而且不要存在空格。

5.海报封面宽高

由于海报设计部分小程序开发者喜欢个性化海报，如果插件里提供的是完整全图，或者设定某一个宽高，很容易在合成海报时变形。因此，提供了一个组件功能，可以设置海报封面图的宽高，可以根据个性小程序海报设置不同的封面宽高缩略图。

注意：数字之间一定要用英文逗号“,” ，而且不要存在空格。把 static.weitimes.com 加入微信公众平台小程序后台的服务器配置里的 downloadFile 合法域名内容。

还需要说明一点，这些的海报封面宽高，不是指整个海报的宽高，而是合成海报时的缩略图宽高。

6.默认缩略图

默认缩略图需要设置，这是在文章没有特色图像或文章内不包含图像的情况下，则小程序端会调用默认缩略图。另一个方面是提供给海报生成，即朋友圈分享生成时的头图，如果不是信任域名内图像链接，则会采用默认缩略图。

7.回复评论模板 ID

这一项是用于评论的消息回复通知使用的。需要在微信公众平台的小程序后台的消息模板处选定消息模板，选择之后，插件填写了 AppId 和 AppSecret 则可以通过插件菜单处的消息模板查看到对应的消息模板 ID。

回复评论消息通知的关键词选择及排序，依次为：回复者，回复内容，回复时间

注意一定不要弄错了关键词和排序，不然推送的消息字段就不能一一对应。

8.审核通知模板 ID

这一项是用于发表话题时通过审核发布话题内容时推送服务消息通知给创建话题的用户。同样是需要在微信公众平台的小程序后台的消息模板处选定消息模板，选择的模板是 审核通知 。选择的关键词及排序，依次为：主题，信息概要，发布时间，审核说明

PS: 微信小程序消息模板将于 2020 年 1 月 10 日下线，到时候将采用订阅消息方式进行，则需要填写订阅消息的模板 ID

--未完待续--

update by 2019.10.20

第二节：艾码汇 WordPress 小程序插件使用教程（二）