REST API可以使用与默认帖子类型或分类术语控制器相同的控制器为wp / v2命名空间中的自定义帖子类型和自定义分类法创建路线。 或者,您可以使用自己的控制器和命名空间。 本文将介绍如何使用自定义内容类型的API路由的默认控制器。 这是最简单的方法,并确保与第三方兼容的最高机会。 ##使用REST API支持注册自定义帖子类型 注册自定义帖子类型时,如果希望通过REST API可用,您应该在传递给register_post_type的参数中设置'show_in_rest'=> true。 将此参数设置为true将在wp / v2命名空间中添加路由。 ``` /** * Register a book post type, with REST API support * * Based on example at: https://codex.wordpress.org/Function_Reference/register_post_type */ add_action( 'init', 'my_book_cpt' ); function my_book_cpt() { $args = array( 'public' => true, 'show_in_rest' => true, 'label' => 'Books' ); register_post_type( 'book', $args ); } ``` 您可以选择设置rest_base参数来更改基本URL,否则默认为该类型的名称。 在下面的示例中,“books”用作rest_base的值。 这将使路由的URL为wp-json / v2 / books,而不是wp-json / v2 / book /,这将是默认的。 另外,您可以传递rest_controller_class的参数。 这个类必须是WP_REST_Controller的子类。 默认情况下,WP_REST_Posts_Controller用作控制器。 如果您使用的是自定义控制器,则可能不在wp / v2命名空间内。 下面是一个注册一个post类型,一个完整的标签,对REST API的支持,一个定制的rest_base以及默认控制器的显式注册表的例子: ``` /** * Register a book post type, with REST API support * * Based on example at: https://codex.wordpress.org/Function_Reference/register_post_type */ add_action( 'init', 'my_book_cpt' ); function my_book_cpt() { $labels = array( 'name' => _x( 'Books', 'post type general name', 'your-plugin-textdomain' ), 'singular_name' => _x( 'Book', 'post type singular name', 'your-plugin-textdomain' ), 'menu_name' => _x( 'Books', 'admin menu', 'your-plugin-textdomain' ), 'name_admin_bar' => _x( 'Book', 'add new on admin bar', 'your-plugin-textdomain' ), 'add_new' => _x( 'Add New', 'book', 'your-plugin-textdomain' ), 'add_new_item' => __( 'Add New Book', 'your-plugin-textdomain' ), 'new_item' => __( 'New Book', 'your-plugin-textdomain' ), 'edit_item' => __( 'Edit Book', 'your-plugin-textdomain' ), 'view_item' => __( 'View Book', 'your-plugin-textdomain' ), 'all_items' => __( 'All Books', 'your-plugin-textdomain' ), 'search_items' => __( 'Search Books', 'your-plugin-textdomain' ), 'parent_item_colon' => __( 'Parent Books:', 'your-plugin-textdomain' ), 'not_found' => __( 'No books found.', 'your-plugin-textdomain' ), 'not_found_in_trash' => __( 'No books found in Trash.', 'your-plugin-textdomain' ) ); $args = array( 'labels' => $labels, 'description' => __( 'Description.', 'your-plugin-textdomain' ), 'public' => true, 'publicly_queryable' => true, 'show_ui' => true, 'show_in_menu' => true, 'query_var' => true, 'rewrite' => array( 'slug' => 'book' ), 'capability_type' => 'post', 'has_archive' => true, 'hierarchical' => false, 'menu_position' => null, 'show_in_rest' => true, 'rest_base' => 'books', 'rest_controller_class' => 'WP_REST_Posts_Controller', 'supports' => array( 'title', 'editor', 'author', 'thumbnail', 'excerpt', 'comments' ) ); register_post_type( 'book', $args ); } ``` ## 使用REST API支持注册自定义分类法 使用REST API支持注册自定义分类法与注册自定义帖子类型非常相似:在传递给register_taxonomy的参数中传递'show_in_rest'=> true。 您可以选择通过rest_base更改分类法路由的基本URL。 分类法的默认控制器是WP_REST_Terms_Controller。 如果您选择使用自定义控制器,则可以使用rest_controller_class进行修改。 以下是使用REST API支持注册自定义分类法的示例: ``` /** * Register a genre post type, with REST API support * * Based on example at: https://codex.wordpress.org/Function_Reference/register_taxonomy */ add_action( 'init', 'my_book_taxonomy', 30 ); function my_book_taxonomy() { $labels = array( 'name' => _x( 'Genres', 'taxonomy general name' ), 'singular_name' => _x( 'Genre', 'taxonomy singular name' ), 'search_items' => __( 'Search Genres' ), 'all_items' => __( 'All Genres' ), 'parent_item' => __( 'Parent Genre' ), 'parent_item_colon' => __( 'Parent Genre:' ), 'edit_item' => __( 'Edit Genre' ), 'update_item' => __( 'Update Genre' ), 'add_new_item' => __( 'Add New Genre' ), 'new_item_name' => __( 'New Genre Name' ), 'menu_name' => __( 'Genre' ), ); $args = array( 'hierarchical' => true, 'labels' => $labels, 'show_ui' => true, 'show_admin_column' => true, 'query_var' => true, 'rewrite' => array( 'slug' => 'genre' ), 'show_in_rest' => true, 'rest_base' => 'genre', 'rest_controller_class' => 'WP_REST_Terms_Controller', ); register_taxonomy( 'genre', array( 'book' ), $args ); } ``` ## 向现有内容类型添加REST API支持 当您不能控制的代码(例如您正在使用的主题或插件)添加了自定义帖子类型或自定义分类法时,可能需要在已注册alredy之后添加REST API支持。 参数与前面的例子相同,但需要添加到全局$ wp_post_types和$ wp_taxonomies数组中。 以下是向现有自定义帖子类型添加REST API支持的示例: ``` /** * Add REST API support to an already registered post type. */ add_action( 'init', 'my_custom_post_type_rest_support', 25 ); function my_custom_post_type_rest_support() { global $wp_post_types; //be sure to set this to the name of your post type! $post_type_name = 'planet'; if( isset( $wp_post_types[ $post_type_name ] ) ) { $wp_post_types[$post_type_name]->show_in_rest = true; // Optionally customize the rest_base or controller class $wp_post_types[$post_type_name]->rest_base = $post_type_name; $wp_post_types[$post_type_name]->rest_controller_class = 'WP_REST_Posts_Controller'; } } ``` 以下是如何向已注册的自定义分类法添加REST API支持的示例。 ``` /** * Add REST API support to an already registered taxonomy. */ add_action( 'init', 'my_custom_taxonomy_rest_support', 25 ); function my_custom_taxonomy_rest_support() { global $wp_taxonomies; //be sure to set this to the name of your taxonomy! $taxonomy_name = 'planet_class'; if ( isset( $wp_taxonomies[ $taxonomy_name ] ) ) { $wp_taxonomies[ $taxonomy_name ]->show_in_rest = true; // Optionally customize the rest_base or controller class $wp_taxonomies[ $taxonomy_name ]->rest_base = $taxonomy_name; $wp_taxonomies[ $taxonomy_name ]->rest_controller_class = 'WP_REST_Terms_Controller'; } } ``` 如果您在执行这些示例中遇到问题,请确保您正在添加具有足够高优先级的这些钩子。 如果回调函数在发布类型或分类法被注册之前运行,则isset检查将阻止错误,但不会添加支持。 ##自定义链接关系 分类和自定义帖子类型在WordPress内部有一个内置关联,但是如果要在两个自定义帖子类型之间建立链接呢? 这在WordPress本身不正式支持,但是我们可以使用_link关系在任意内容类型之间创建我们自己的连接