Changeset 59801 for trunk/tests/phpunit/tests/rest-api/rest-posts-controller.php

Timestamp:

02/10/2025 10:21:51 PM (3 months ago)

Author:

peterwilsoncc

Message:

REST API: Add support for the ignore_sticky_posts argument.

Introduce ignore_sticky as a boolean argument for the posts endpoint for requests without the sticky posts being stuck. The new argument defaults to false with the value of the argument passed to WP_Query's ignore_sticky_posts parameter.

Props audrasjb, danielbachhuber, joemcgill, johnbillion, jorbin, mamaduka, rmccue.
Fixes #35907.

File:

• trunk/tests/phpunit/tests/rest-api/rest-posts-controller.php (modified) (2 diffs)

trunk/tests/phpunit/tests/rest-api/rest-posts-controller.php

@@ -198 +198 @@
                 'exclude',
                 'format',
+                'ignore_sticky',
                 'include',
                 'modified_after',
@@ -5717 +5718 @@
 
     /**
+     * Test the REST API support for `ignore_sticky_posts`.
+     *
+     * @ticket 35907
+     *
+     * @covers WP_REST_Posts_Controller::get_items
+     */
+    public function test_get_posts_ignore_sticky_default_prepends_sticky_posts() {
+        $id1 = self::$post_id;
+        // Create more recent post to avoid automatically placing other at the top.
+        $id2 = self::factory()->post->create( array( 'post_status' => 'publish' ) );
+
+        update_option( 'sticky_posts', array( $id1 ) );
+
+        $request  = new WP_REST_Request( 'GET', '/wp/v2/posts' );
+        $response = rest_get_server()->dispatch( $request );
+        $data     = $response->get_data();
+
+        $this->assertSame( $data[0]['id'], $id1, 'Response has sticky post at the top.' );
+        $this->assertSame( $data[1]['id'], $id2, 'It is followed by most recent post.' );
+    }
+
+    /**
+     * Test the REST API support for `ignore_sticky_posts`.
+     *
+     * @ticket 35907
+     *
+     * @covers WP_REST_Posts_Controller::get_items
+     */
+    public function test_get_posts_ignore_sticky_ignores_post_stickiness() {
+        $id1 = self::$post_id;
+        $id2 = self::factory()->post->create( array( 'post_status' => 'publish' ) );
+
+        update_option( 'sticky_posts', array( $id1 ) );
+
+        $request = new WP_REST_Request( 'GET', '/wp/v2/posts' );
+        $request->set_param( 'ignore_sticky', true );
+        $response = rest_get_server()->dispatch( $request );
+        $data     = $response->get_data();
+
+        $this->assertSame( $data[0]['id'], $id2, 'Response has no sticky post at the top.' );
+    }
+
+    /**
+     * Test the REST API support for `ignore_sticky_posts`.
+     *
+     * @ticket 35907
+     *
+     * @covers WP_REST_Posts_Controller::get_items
+     */
+    public function test_get_posts_ignore_sticky_honors_include() {
+        $id1 = self::$post_id;
+        $id2 = self::factory()->post->create( array( 'post_status' => 'publish' ) );
+
+        update_option( 'sticky_posts', array( $id1 ) );
+
+        $request = new WP_REST_Request( 'GET', '/wp/v2/posts' );
+        $request->set_param( 'include', array( $id2 ) );
+        $response = rest_get_server()->dispatch( $request );
+        $data     = $response->get_data();
+
+        $this->assertCount( 1, $data, 'Only one post is expected to be returned.' );
+        $this->assertSame( $data[0]['id'], $id2, 'Returns the included post.' );
+    }
+
+    /**
      * Internal function used to disable an insert query which
      * will trigger a wpdb error for testing purposes.