Changeset 60893

Timestamp:

10/03/2025 01:37:52 AM (11 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'] );
         }