Changeset 60916

Timestamp:

10/08/2025 10:49:22 PM (3 days ago)

Author:

andrewserong

Message:

REST API: Rename post link relation in media endpoint to wp:attached-to

By adding the ​https://api.w.org/ prefix and using a more descriptive name for the link relation, this change creates greater clarity for this part of the API. Note that the renaming of this property is safe, as the API change has not yet made it into a final release.

Follow-up to [60893].

Props andrewserong, mukesh27, ramonopoly, timothyblynjacobs.
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

@@ -1023 +1023 @@
 
             if ( ! empty( $post ) ) {
-                $links['post'] = array(
+                $links['https://api.w.org/attached-to'] = array(
                     'href'       => rest_url( rest_get_route_for_post( $post ) ),
                     'embeddable' => true,

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

@@ -1888 +1888 @@
         $this->assertArrayHasKey( 'self', $links );
         $this->assertArrayHasKey( 'author', $links );
-        $this->assertArrayHasKey( 'post', $links );
+        $this->assertArrayHasKey( 'https://api.w.org/attached-to', $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'] );
+        $this->assertSame( rest_url( '/wp/v2/posts/' . $post ), $links['https://api.w.org/attached-to'][0]['href'] );
+        $this->assertSame( 'post', $links['https://api.w.org/attached-to'][0]['attributes']['post_type'] );
+        $this->assertSame( $post, $links['https://api.w.org/attached-to'][0]['attributes']['id'] );
+        $this->assertTrue( $links['https://api.w.org/attached-to'][0]['attributes']['embeddable'] );
     }