×

主题开发

WordPress主题开发经验教程分享

WordPress Rest API 怎么支持自定义分类和自定义文章类型

王超 2020-03-09 主题开发 74 次

WordPress日记小程序已上线,扫码直达

WordPress REST API默认的是支持post和page文章类型的,支持category以及tag分类法,但是很多时候我们会通过创建自定义分类法和自定义文章类型来丰富和方便我们的内容管理,那么这种情况下我们如何能让WordPress REST API也可以支持自定义分类法和自定义文章类型呢?

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

其实创建自定义文章类型时,如果想要让自定义文章类型支持 REST API 的方式获取数据,方法并不难,只需要增加几个参数类型。分别是:show_in_rest ,rest_baserest_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设置的值)。

演示代码如下:

/*
 * WordPress REST API 支持自定义文章类型
 */
// 自定义文章类型
add_action('init', function ()   {   
    $labels = array(   
            'name' => '圈子',   
            'singular_name' => 'bbs',
            'menu_name' => '圈子',
            'name_admin_bar' => '圈子',
            'add_new' => '添加',   
            'add_new_item' => '新建',   
            'edit_item' => '编辑',   
            'new_item' => '新增'  
    );   
    $args = array(   
            'labels' => $labels,  
            'public' => true,
            'show_ui' => true,    
            'show_in_menu' => true,    
            'query_var' => true,   
            'rewrite'   => array( 'slug' => 'bbs' ),
            'capability_type' => 'post',   
            'has_archive' => false,    
            'exclude_from_search' => true,
            'menu_position' => 8,
            'supports' => array('title', 'editor','author','thumbnail','comments'),
            'menu_icon' => 'dashicons-googleplus',
            'show_in_rest'       => true,
            'rest_base'          => 'bbs',
            'rest_controller_class' => 'WP_REST_Posts_Controller',
    );    
    register_post_type('bbs',$args); 
});

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

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

演示代码如下:

/*
 * WordPress REST API 支持自定义分类法
 */
// 自定义文章类型分类
add_action( 'init',function () {
  $labels = array(
    'name'              => _x( '分类', '分类名称' ),
    'singular_name'     => _x( 'topic', '分类别名' ),
    'search_items'      => __( '搜索分类' ),
    'all_items'         => __( '所有分类' ),
    'parent_item'       => __( '上级分类' ),
    'parent_item_colon' => __( '父级分类:' ),
    'edit_item'         => __( '编辑' ),
    'update_item'       => __( '更新' ),
    'add_new_item'      => __( '新建' ),
    'new_item_name'     => __( '新增' ),
    'menu_name'         => __( '分类' ),
  );
  $args = array(
    'hierarchical'          => true,
    'labels'                => $labels,
    'show_ui'               => true,
    'show_admin_column'     => true,
    'query_var'             => true,
    'rewrite'               => array( 'slug' => 'topic' ),
    'show_in_rest'          => true,
    'rest_base'             => 'topic',
    'rest_controller_class' => 'WP_REST_Terms_Controller',
  );
  register_taxonomy( 'topic', array( 'bbs' ), $args );
}, 30 );

基本上到此为止,自定义文章类型的 WordPress REST API 相关项就已经完成了,其他的数据,则根据自己的需要进行拓展即可,比如自定义文章类型的 TAG 和自定义标签项等,这里就不一一详述了

WordPress日记主要承接WordPress主题定制开发PSD转WordPressWordPress仿站以及最近会推出的以WordPress为管理后端的小程序,我们一直秉持“做一个项目,交一个朋友”的理念,希望您是我们下一个朋友。如果您有WordPress主题开发需求,可随时联系QQ:919985494

联系我们

如果您有想过合作事宜,可以通过以下方式联系我们

邮箱:919985494@qq.com

QQ:919985494(牧野鸿鹄)

电话:0371-86166851 18539976310

微信:18539976310(lclz429)

关注&交流

QQ交流群

微信公众号

订阅本站

输入邮箱订阅本站,只要有新文章发布,就会发送邮件通知您哦!