Changeset 47037 for trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

Timestamp:

01/03/2020 07:22:32 PM (5 years ago)

Author:

kadamwhite

Message:

REST API: Issue doing_it_wrong if a taxonomy's specified rest_base is already in use by a different resource.

Props fgiannar, TimothyBlynJacobs, kingkool68, SergeyBiryukov.
Fixes #48401.

File:

• trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php (modified) (1 diff)

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

@@ -2243 +2243 @@
         $taxonomies = wp_list_filter( get_object_taxonomies( $this->post_type, 'objects' ), array( 'show_in_rest' => true ) );
         foreach ( $taxonomies as $taxonomy ) {
-            $base                          = ! empty( $taxonomy->rest_base ) ? $taxonomy->rest_base : $taxonomy->name;
+            $base = ! empty( $taxonomy->rest_base ) ? $taxonomy->rest_base : $taxonomy->name;
+
+            if ( array_key_exists( $base, $schema['properties'] ) ) {
+                $taxonomy_field_name_with_conflict = ! empty( $taxonomy->rest_base ) ? 'rest_base' : 'name';
+                _doing_it_wrong(
+                    'register_taxonomy',
+                    sprintf(
+                        /* translators: 1. The taxonomy name, 2. The property name, either rest_base or name. */
+                        __( 'The "%1$s" taxonomy "%2$s" conflicts with an existing property on the REST API Posts Controller. Specify a custom "rest_base" when registering the taxonomy to avoid this error.' ),
+                        $base,
+                        $taxonomy_field_name_with_conflict
+                    ),
+                    '5.4.0'
+                );
+            }
+
             $schema['properties'][ $base ] = array(
                 /* translators: %s: Taxonomy name. */