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

Timestamp:

11/03/2019 11:12:44 PM (5 years ago)

Author:

TimothyBlynJacobs

Message:

REST API: Add tax relation parameter to posts collection.

The REST API supports filtering by terms across multiple taxonomies using an AND relation. This adds support for an OR relation by adding "tax_relation=OR" as a query parameter.

Props earnjam.
Fixes #44326.

File:

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

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

@@ -270 +270 @@
 
         $taxonomies = wp_list_filter( get_object_taxonomies( $this->post_type, 'objects' ), array( 'show_in_rest' => true ) );
+
+        if ( ! empty( $request['tax_relation'] ) ) {
+            $query_args['tax_query'] = array( 'relation' => $request['tax_relation'] );
+        }
 
         foreach ( $taxonomies as $taxonomy ) {
@@ -2532 +2536 @@
         $taxonomies = wp_list_filter( get_object_taxonomies( $this->post_type, 'objects' ), array( 'show_in_rest' => true ) );
 
+        if ( ! empty( $taxonomies ) ) {
+            $query_params['tax_relation'] = array(
+                'description' => __( 'Limit result set based on relationship between multiple taxonomies.' ),
+                'type'        => 'string',
+                'enum'        => array( 'AND', 'OR' ),
+            );
+        }
+
         foreach ( $taxonomies as $taxonomy ) {
             $base = ! empty( $taxonomy->rest_base ) ? $taxonomy->rest_base : $taxonomy->name;