Changeset 51962 for trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-post-types-controller.php

Timestamp:

10/31/2021 11:15:10 PM (3 years ago)

Author:

TimothyBlynJacobs

Message:

REST API: Support custom namespaces for custom post types.

While a custom post type can define a custom route by using the rest_base argument, a namespace of wp/v2 was assumed. This commit introduces support for a rest_namespace argument.

A new rest_get_route_for_post_type_items function has been introduced and the rest_get_route_for_post function updated to facilitate getting the correct route for custom post types.

While the WordPress Core Block Editor bootstrap code has been updated to use these API functions, for maximum compatibility sticking with the default wp/v2 namespace is recommended until the API functions see wider use.

Props spacedmonkey, swissspidy.
Fixes #53656.

File:

• trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-post-types-controller.php (modified) (15 diffs)

trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-post-types-controller.php

@@ -181 +181 @@
         $taxonomies = wp_list_pluck( $taxonomies, 'name' );
         $base       = ! empty( $post_type->rest_base ) ? $post_type->rest_base : $post_type->name;
+        $namespace  = ! empty( $post_type->rest_namespace ) ? $post_type->rest_namespace : 'wp/v2';
         $supports   = get_all_post_type_supports( $post_type->name );
 
@@ -233 +234 @@
         }
 
+        if ( in_array( 'rest_namespace', $fields, true ) ) {
+            $data['rest_namespace'] = $namespace;
+        }
+
         $context = ! empty( $request['context'] ) ? $request['context'] : 'view';
         $data    = $this->add_additional_fields_to_object( $data, $request );
@@ -246 +251 @@
                 ),
                 'https://api.w.org/items' => array(
-                    'href' => rest_url( sprintf( 'wp/v2/%s', $base ) ),
+                    'href' => rest_url( rest_get_route_for_post_type_items( $post_type->name ) ),
                 ),
             )
@@ -270 +275 @@
      * @since 4.7.0
      * @since 4.8.0 The `supports` property was added.
-     * @since 5.9.0 The `visibility` property was added.
+     * @since 5.9.0 The `visibility` and `rest_namespace` properties were added.
      *
      * @return array Item schema data.
@@ -284 +289 @@
             'type'       => 'object',
             'properties' => array(
-                'capabilities' => array(
+                'capabilities'   => array(
                     'description' => __( 'All capabilities used by the post type.' ),
                     'type'        => 'object',
@@ -290 +295 @@
                     'readonly'    => true,
                 ),
-                'description'  => array(
+                'description'    => array(
                     'description' => __( 'A human-readable description of the post type.' ),
                     'type'        => 'string',
@@ -296 +301 @@
                     'readonly'    => true,
                 ),
-                'hierarchical' => array(
+                'hierarchical'   => array(
                     'description' => __( 'Whether or not the post type should have children.' ),
                     'type'        => 'boolean',
@@ -302 +307 @@
                     'readonly'    => true,
                 ),
-                'viewable'     => array(
+                'viewable'       => array(
                     'description' => __( 'Whether or not the post type can be viewed.' ),
                     'type'        => 'boolean',
@@ -308 +313 @@
                     'readonly'    => true,
                 ),
-                'labels'       => array(
+                'labels'         => array(
                     'description' => __( 'Human-readable labels for the post type for various contexts.' ),
                     'type'        => 'object',
@@ -314 +319 @@
                     'readonly'    => true,
                 ),
-                'name'         => array(
+                'name'           => array(
                     'description' => __( 'The title for the post type.' ),
                     'type'        => 'string',
@@ -320 +325 @@
                     'readonly'    => true,
                 ),
-                'slug'         => array(
+                'slug'           => array(
                     'description' => __( 'An alphanumeric identifier for the post type.' ),
                     'type'        => 'string',
@@ -326 +331 @@
                     'readonly'    => true,
                 ),
-                'supports'     => array(
+                'supports'       => array(
                     'description' => __( 'All features, supported by the post type.' ),
                     'type'        => 'object',
@@ -332 +337 @@
                     'readonly'    => true,
                 ),
-                'taxonomies'   => array(
+                'taxonomies'     => array(
                     'description' => __( 'Taxonomies associated with post type.' ),
                     'type'        => 'array',
@@ -341 +346 @@
                     'readonly'    => true,
                 ),
-                'rest_base'    => array(
+                'rest_base'      => array(
                     'description' => __( 'REST base route for the post type.' ),
                     'type'        => 'string',
@@ -347 +352 @@
                     'readonly'    => true,
                 ),
-                'visibility'   => array(
+                'rest_namespace' => array(
+                    'description' => __( 'REST route\'s namespace for the post type.' ),
+                    'type'        => 'string',
+                    'context'     => array( 'view', 'edit', 'embed' ),
+                    'readonly'    => true,
+                ),
+                'visibility'     => array(
                     'description' => __( 'The visibility settings for the post type.' ),
                     'type'        => 'object',