艾码汇 WordPress 小程序插件使用教程(二)

上一次抽时间写了艾码汇 WordPress 小程序插件使用教程(一),由于时间关系,一直拖到现在才开始写第二部分。不过,上一次的教程里说到的信任下载域名还是有不少人在这里迷糊了,还得要再讲一次。

微信公众平台的小程序后台有个开发选项,开发选项中有开发设置,开发设置里有服务器域名,需要进行域名配置,request合法域名 属于请求小程序数据域名,只要涉及到请求数据域名,比如 API 的数据域名,都是需要在这里添加的。uploadFile合法域名 属于上传文件域名,比如,图片直接上传到七牛,阿里云 OSS 等云存储的域名,都是需要配置到这里的,否则会造成上传失败。downloadFile合法域名 属于下载文件域名,比如生成分享海报图的 URL 域名,如果你用的是 CDN ,则需要把 CDN 域名加到这里,那么下载图片才会不报错。

除了微信公众平台的小程序后台需要配置这个信任域名之外,一般情况下,小程序开发其实是不需要再配置的,但是,考虑到有些时候,使用了外部资源,比如图片使用了外链形式,而这个外链又刚好不在 downloadFile合法域名 之列,出现了错误而不自知。所以,艾码汇的 WordPress 小程序 API 插件里也增加了一项下载信任域名设置,需要把微信公众平台的小程序后台设置的 downloadFile合法域名 加入设置选项里。需要注意的是,插件设置信任下载域名,必须是一个域名一行,而且不带 http 或 https 等协议格式的。

以上两个地方正确设置完成之后,基本上分享海报图生成不会出现错误。艾码汇 WordPress 小程序 API 的插件如果没有设置信任域名的话,默认情况下是直接调用默认缩略图作为生成分享海报图的封面头图。

优化选项

优化选项主要是 WordPress API 数据开关,即可以选择开启或是关闭某项 API 数据输出。

小程序 API 优化选项

1. 自定义滑动图文

最开始定制的插件为了节省时间,直接采用了置顶文章作为小程序的滑动图文,默认是 10 篇。但是,这样可能对一些不想要用置顶文章作为滑动图文的用户就不方便了。因为 WordPress 主题,大多数也有这个置顶功能,有些不想要开启文章置顶。所以,又增加了一项自定义的滑动图文功能,可以在编辑文章时自定义选择是否启用文章出现在滑动图文中,与置顶功能相似,但又不影响置顶文章。当然,同样也兼顾置顶文章,即默认不开启的情况下,采用的是文章置顶作为小程序的滑动图文。如果不想要用文章置顶作为小程序的滑动图文,则可以在这里勾选开启,并在文章处勾选 是否在小程序滑动图文显示 。

自定义滑动图文

2. 文章列表内容

针对默认的小程序文章列表 API 显示。默认情况下,WordPress rest api 的数据显示是输出文章内容的,但是,有时候并不需要显示文章内容,而继续输出文章内容的话,则不利于数据的加载,影响加载速度。如果首页或是分类列表页不需要显示文章内容的话,建议勾选禁止显示文章列表内容。不过,微语录小程序由于默认就是需要文章内容的,则不能勾选,否则首页不能显示语录内容。

3. 文章摘要标签

针对默认的小程序文章列表 API 显示。默认情况下,WordPress rest api 的数据显示是输出文章摘要的,但是,有时候并不需要显示文章摘要,而继续输出文章内容的话,则不利于数据的加载,影响加载速度。如果首页或是分类列表页不需要显示文章摘要的话,建议勾选禁止显示文章列表内容。

4. 文章格式标签

针对默认的小程序文章列表 API 显示。默认情况下,WordPress rest api 的数据显示是输出文章格式的,同样,如果不需要文章格式的话,建议勾选取消。之所以不在插件里直接屏蔽掉,主要是为了小程序 UI 考虑。比如,如果你想要针对文章格式为视频的文章显示大图,其他默认文章为小图的文章列表,就可以保留文章格式标签,通过判断文章格式标签使用不同的样式。

5. 文章类型标签

针对默认的小程序文章列表 API 显示。默认情况下,WordPress rest api 的数据显示是输出文章类型的,同样,如果不需要文章类型的话,建议勾选取消。小程序的页面跳转可以采用的就是文章类型判断的,比如文章类型为 Post 时,跳转页面地址为 /pages/detail/detail?id=文章ID ,而文章类型为 Page 时,跳转页面地址为 /pages/page/page?id=页面ID 。

6. 文章作者标签

屏蔽显示作者的,可以根据个人小程序需要选择是否保留。

7. 文章自定义标签

针对自定义字段标签的输出方式,是否是集中在 meta 标签下,还是独立标签。主要作用是方便他人制作小程序的时候采用哪种方式显示。艾码汇微信小程序无论是否开启,都会正常显示数据。

8. 屏蔽 REST API

艾码汇 WordPress 小程序 API 插件其他使用的 API 很多都是自定义的,而 WordPress REST API 原生 API 其实用不到。比如评论列表 API ,由于 WordPress REST API 的评论 API 其实并不好用,所以另行自定义了评论列表 API ,一次请求即可获取评论及回复。所以,把一些不需要用的 WordPress REST API 集中在一起,可以选择屏蔽。另外,如果需要用古腾堡编辑器的话,那么不要开启这一项。

9. 列表内容选项

这一项其实是和第二项对应的,因为有的小程序需要在列表里调用文章内容,所以必须在自定义 API 里增加内容显示。但如果强行加在插件里的话,又不适合所有的小程序需要,所以提供如此选项,方便针对不同的小程序需求。比如微语录小程序需要列表内容显示,必须开启。

10. 文章图像列表

把文章所有图片加入一个输出列表项。主要目的是在文章列表中的某篇文章可以显示多张图片。

功能扩展

功能扩展主要是 WordPress API 功能扩展设置,比如广告功能,推送服务等。

小程序 API 功能扩展

1. 小程序投稿功能

开启话题发表显示,目前插件只是增加了选项,还没有真正应用到小程序开发。因此,不要问为什么开启了没有看到哪里投稿的问题。

2. 小程序评论审核

如果需要审核小程序发表的评论,那么就要开启这项。

3. 文章上下篇

提供文章页是否显示上一篇和下一篇的 API 。如果小程序前端文章没有开发上一篇和下一篇的显示,那么就不需要开启。

4. 小程序视频/音频

针对文章自定义字段功能。

5. Audio 音频组件

针对文章自定义字段功能。

6. 解析腾讯视频

解析腾讯视频 URL

自定义字段

7. 清理HTML标签

清理分类描述 HTML 标签

8. 图片重命名

上传图片时重命名,减少图片 SQL 查询。如果安装了 WPJAM BASIC 插件,就不必开启,可以根据需要选择 WPJAM BASIC 插件对应的优化功能。

9. 清理后台菜单

后台菜单及仪表盘屏蔽清理选项

10. 广告功能设置

小程序广告设置选项。此功能在使用开源版时就开始进行定制扩展,印象中是属于第一个这样定制广告功能扩展,在 WordPress 小程序微信交流群中有分享过思路。目前似乎除了自己开发的小程序扩展了这个广告功能外,其他的小程序并没有增加。这个插件的广告功能也与开源版插件广告功能有区别,具体的教程留到后面。

11. 消息推送功能

消息推送功能是基于古人云小程序 vPush 推送 API 扩展的。具体的使用教程,可以点击这里

- 未完待续 -

艾码汇 WordPress 小程序 API 插件目前没有提交到 WordPress 官方应用中心的插件市场。目前插件的升级已经可以在后台选择升级,不需要手动下载插件包重新删除上传,后台检测有更新将会有提示。

小程序 API 插件升级

下次的教程主要分享广告功能设置,自定义导航菜单等。

1 条评论

  1. Propitiatorคิดถึง

    厉害

发表评论

电子邮件地址不会被公开。 必填项已用*标注

微信扫一扫

微信扫一扫

微信扫一扫,分享到朋友圈

艾码汇 WordPress 小程序插件使用教程(二)
返回顶部

显示

忘记密码?

显示

显示

获取验证码

Close