Changeset 59458 for trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php

Timestamp:

11/25/2024 11:14:37 AM (5 months ago)

Author:

Bernhard Reiter

Message:

REST API: Terms: Respect taxonomy's default query args.

It is possible to supply a set of default query args to register_taxonomy() which will be used when querying a list of terms -- for example, orderby in order to specify how the resulting list of terms should be sorted.

The Terms REST API controller previously respected these default query args only if the request included a post ID. This changeset makes it so that the default args will also be respected if no post ID is provided.

Props bernhard-reiter, jsnajdr.
Fixes #62500.

File:

• trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php (modified) (2 diffs)

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

@@ -228 +228 @@
      *
      * @since 4.7.0
+     * @since 6.8.0 Respect default query arguments set for the taxonomy upon registration.
      *
      * @param WP_REST_Request $request Full details about the request.
@@ -294 +295 @@
                 }
             }
+        }
+
+        /*
+         * When a taxonomy is registered with an 'args' array,
+         * those params override the `$args` passed to this function.
+         *
+         * We only need to do this if no `post` argument is provided.
+         * Otherwise, terms will be fetched using `wp_get_object_terms()`,
+         * which respects the default query arguments set for the taxonomy.
+         */
+        if (
+            empty( $prepared_args['post'] ) &&
+            isset( $taxonomy_obj->args ) &&
+            is_array( $taxonomy_obj->args )
+        ) {
+            $prepared_args = array_merge( $prepared_args, $taxonomy_obj->args );
         }