WordPress 自定义文章类型 Rest API 创建教程

WordPress 自定义文章类型的创建方法教程，估计不用怎么说，大多数喜欢 WordPress 的朋友都基本上会了，就算不会，也很容易在网上找到教程，可以说没有什么好说的了。如果网站增加自定义文章类型的方法教程都还没有搞定的朋友，那就真的要多看看 WordPress 官方开发文档，或者多动手尝试。然而，自从通过增强 WordPress Rest API 插件实现基于 WordPress 后台框架，创建微信小程序后，很多想通过自定义文章类型丰富小程序的朋友，总是想要获取 WordPress 自定义文章 API 而不得方法。其实，WordPress 官方 API 指南里有相关的教程，只不过是英文版，虽然我此前通过谷歌翻译把内容粗陋的翻译成了中文，但还是有人反馈说尝试失败，有报错。刚好，最近需要通过自定义文章类型，计划给小程序拓展话题类型栏目，类似于朋友圈，或者说是小论坛形式。所以，便重新整理了一下 WordPress 自定义文章类型的 API 教程及代码共享。

创建支持 WordPress REST API 的自定义文章类型

其实创建自定义文章类型时，如果想要让自定义文章类型支持 REST API 的方式获取数据，方法并不难，只需要增加几个参数类型。分别是：show_in_rest ，rest_base，rest_controller_class。第一个参数可以理解为是否在 REST API 中显示，所以参数值必须是 true；第二个参数可以理解为通过哪个 REST API 显示数据，所以参数值最好是自定义文章类型的别名，且必须是英文或是拼音，比如：bbs(表示论坛或是圈子)；第三个参数可以理解为采用哪个 REST API 的控制类，所以参数值必须是使用文章的控制类:WP_REST_Posts_Controller。加上这三个参数项，基本上自定义文章类型的 REST API 就创建成功了。获取数据的 API 即为：https://网址域名/wp-json/wp/v2/bbs (rest_base设置的值)。

演示代码如下：

API 数据结构：

创建支持 WordPress REST API 的自定义文章类型分类目录

创建了自定义文章类型难免有需要自定义文章类型的分类目录。如果想要自定义文章类型的分类目录支持 REST API ，也需要增加几个参数类型。同样是：show_in_rest，rest_base，rest_controller_class。第一二个参数这里就不再详述，第三个参数和自定义文章类型里的表述其实差不多一样，只是控制类需要换成 Terms，所以参数值应该是：WP_REST_Terms_Controller。获取数据的 API 即为：https://网址域名/wp-json/wp/v2/topic (rest_base设置的值)。

演示代码如下：

API 数据结构：

基本上到此为止，自定义文章类型的 WordPress REST API 相关项就已经完成了，其他的数据，则根据自己的需要进行拓展即可，比如自定义文章类型的 TAG 和自定义标签项等，这里就不一一详述了。近期将代码优化集成至 WordPress 连接微信小程序 API 增强插件里，此次就先放中教程简化版下载。

个人认为通过自定义文章类型可以为 WordPress 丰富很多可能性，比如产品，圈子，反馈，自定义表单。如果想要让 WordPress 站点变得更丰富，建议多点查看官方开发文档。下一步计划将通过自定义文章类型给小程序建立一个表单功能，可用于在线预约，预订，反馈等。

代码下载：点击这里。

官方教程：Adding REST API Support For Custom Content Types

Update 2018-09-28