Changeset 60893

Timestamp:

10/03/2025 01:37:52 AM (3 months ago)

Author:

andrewserong

Message:

REST API: Add an embeddable post to the media endpoint within links

Allows consumers to more easily fetch details of the post a media item is linked to, i.e. to more easily display the uploaded to / attached to status of media items.

Props andrewserong, ramonopoly, mukesh27, adamsilverstein.
Fixes #64034.

Location:

trunk

Files:

• src/wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php (modified) (1 diff)
• tests/phpunit/tests/rest-api/rest-attachments-controller.php (modified) (1 diff)

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

@@ -969 +969 @@
          */
         return apply_filters( 'rest_prepare_attachment', $response, $post, $request );
+    }
+
+    /**
+     * Prepares attachment links for the request.
+     *
+     * @since 6.9.0
+     *
+     * @param WP_Post $post Post object.
+     * @return array Links for the given attachment.
+     */
+    protected function prepare_links( $post ) {
+        $links = parent::prepare_links( $post );
+
+        if ( ! empty( $post->post_parent ) ) {
+            $post = get_post( $post->post_parent );
+
+            if ( ! empty( $post ) ) {
+                $links['post'] = array(
+                    'href'       => rest_url( rest_get_route_for_post( $post ) ),
+                    'embeddable' => true,
+                    'post_type'  => $post->post_type,
+                    'id'         => $post->ID,
+                );
+            }
+        }
+
+        return $links;
     }
 

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

@@ -1849 +1849 @@
         $this->assertArrayHasKey( 'self', $links );
         $this->assertArrayHasKey( 'author', $links );
+        $this->assertArrayNotHasKey( 'post', $links );
 
         $this->assertCount( 1, $links['author'] );
         $this->assertArrayHasKey( 'embeddable', $links['author'][0]['attributes'] );
         $this->assertTrue( $links['author'][0]['attributes']['embeddable'] );
+    }
+
+    /**
+     * @ticket 64034
+     */
+    public function test_links_contain_parent() {
+        wp_set_current_user( self::$editor_id );
+
+        $post       = self::factory()->post->create(
+            array(
+                'post_type'   => 'post',
+                'post_status' => 'publish',
+                'post_title'  => 'Test Post',
+            )
+        );
+        $attachment = self::factory()->attachment->create_object(
+            array(
+                'file'           => self::$test_file,
+                'post_author'    => self::$editor_id,
+                'post_parent'    => $post,
+                'post_mime_type' => 'image/jpeg',
+            )
+        );
+
+        $this->assertGreaterThan( 0, $attachment );
+
+        $request = new WP_REST_Request( 'GET', "/wp/v2/media/{$attachment}" );
+        $request->set_query_params( array( 'context' => 'edit' ) );
+
+        $response = rest_get_server()->dispatch( $request );
+        $links    = $response->get_links();
+
+        $this->assertArrayHasKey( 'self', $links );
+        $this->assertArrayHasKey( 'author', $links );
+        $this->assertArrayHasKey( 'post', $links );
+
+        $this->assertCount( 1, $links['author'] );
+        $this->assertSame( rest_url( '/wp/v2/posts/' . $post ), $links['post'][0]['href'] );
+        $this->assertSame( 'post', $links['post'][0]['attributes']['post_type'] );
+        $this->assertSame( $post, $links['post'][0]['attributes']['id'] );
+        $this->assertTrue( $links['post'][0]['attributes']['embeddable'] );
     }