Changeset 53370

Timestamp:

05/09/2022 01:49:29 PM (3 years ago)

Author:

SergeyBiryukov

Message:

Query: Restore late compact() call for the posts_clauses_request filter.

This addresses a backward compatibility break where posts_join_request and other filters were applied, but their results were subsequently discarded and earlier values were used instead.

Follow-up to [52974], [53175].

Props 5um17, johnbillion, SergeyBiryukov.
Fixes #55699.

Location:

trunk

Files:

• src/wp-includes/class-wp-query.php (modified) (4 diffs)
• tests/phpunit/tests/query.php (modified) (1 diff)

trunk/src/wp-includes/class-wp-query.php

@@ -2755 +2755 @@
         }
 
-        $clauses = array( 'where', 'groupby', 'join', 'orderby', 'distinct', 'fields', 'limits' );
-
         /*
          * Apply post-paging filters on where and join. Only plugins that
@@ -2835 +2833 @@
              */
             $fields = apply_filters_ref_array( 'posts_fields', array( $fields, &$this ) );
+
+            $clauses = array( 'where', 'groupby', 'join', 'orderby', 'distinct', 'fields', 'limits' );
 
             /**
@@ -2968 +2968 @@
             $limits = apply_filters_ref_array( 'post_limits_request', array( $limits, &$this ) );
 
+            $clauses = array( 'where', 'groupby', 'join', 'orderby', 'distinct', 'fields', 'limits' );
+
             /**
              * Filters all query clauses at once, for convenience.
@@ -2991 +2993 @@
              * @param WP_Query $query  The WP_Query instance (passed by reference).
              */
-            $clauses = (array) apply_filters_ref_array( 'posts_clauses_request', array( $clauses, &$this ) );
+            $clauses = (array) apply_filters_ref_array( 'posts_clauses_request', array( compact( $clauses ), &$this ) );
 
             $where    = isset( $clauses['where'] ) ? $clauses['where'] : '';

trunk/tests/phpunit/tests/query.php

@@ -720 +720 @@
         $this->assertSame( get_queried_object_id(), $user_id );
     }
+
+    /**
+     * Tests that the `posts_clauses` filter receives an array of clauses
+     * with the other `posts_*` filters applied, e.g. `posts_join_paged`.
+     *
+     * @ticket 55699
+     * @covers WP_Query::get_posts
+     */
+    public function test_posts_clauses_filter_should_receive_filtered_clauses() {
+        add_filter(
+            'posts_join_paged',
+            static function() {
+                return '/* posts_join_paged */';
+            }
+        );
+
+        $filter = new MockAction();
+        add_filter( 'posts_clauses', array( $filter, 'filter' ), 10, 2 );
+        $this->go_to( '/' );
+        $filter_args   = $filter->get_args();
+        $posts_clauses = $filter_args[0][0];
+
+        $this->assertArrayHasKey( 'join', $posts_clauses );
+        $this->assertSame( '/* posts_join_paged */', $posts_clauses['join'] );
+    }
+
+    /**
+     * Tests that the `posts_clauses_request` filter receives an array of clauses
+     * with the other `posts_*_request` filters applied, e.g. `posts_join_request`.
+     *
+     * @ticket 55699
+     * @covers WP_Query::get_posts
+     */
+    public function test_posts_clauses_request_filter_should_receive_filtered_clauses() {
+        add_filter(
+            'posts_join_request',
+            static function() {
+                return '/* posts_join_request */';
+            }
+        );
+
+        $filter = new MockAction();
+        add_filter( 'posts_clauses_request', array( $filter, 'filter' ), 10, 2 );
+        $this->go_to( '/' );
+        $filter_args           = $filter->get_args();
+        $posts_clauses_request = $filter_args[0][0];
+
+        $this->assertArrayHasKey( 'join', $posts_clauses_request );
+        $this->assertSame( '/* posts_join_request */', $posts_clauses_request['join'] );
+    }
 }