REST API: Extend orderby parameter to support mime_type for attachments.

This update allows the `orderby` request argument in the attachments controller to include `mime_type`, enhancing the sorting capabilities of media items. Additionally, a new test has been added to verify the correct functionality of this feature.

Fixes trac 64073.

Author: ramonjd

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

@@ -1342,6 +1342,7 @@ public static function get_filename_from_disposition( $disposition_header ) {
 	 * Retrieves the query params for collections of attachments.
 	 *
 	 * @since 4.7.0
+	 * @since 6.9.0 Extends the `orderby` request argument to support `mime_type`.
 	 *
 	 * @return array Query parameters for the attachment collection as an array.
 	 */
@@ -1364,6 +1365,8 @@ public function get_collection_params() {
 			'type'        => 'string',
 		);
 
+		$params['orderby']['enum'][] = 'mime_type';
+
 		return $params;
 	}
 

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

@@ -2827,4 +2827,47 @@ public function test_edit_image_vertical_flip_only() {
 		// The controller converts the integer values to booleans: 0 !== (int) 1 = true.
 		$this->assertSame( array( true, false ), WP_Image_Editor_Mock::$spy['flip'][0], 'Vertical flip of the image is not identical.' );
 	}
+
+	/**
+	 * Test that the `orderby` parameter works with the `mime_type` parameter.
+	 *
+	 * @ticket 64073
+	 */
+	public function test_get_items_orderby_mime_type() {
+		$jpeg_id = self::factory()->attachment->create_object(
+			self::$test_file,
+			0,
+			array(
+				'post_mime_type' => 'image/jpeg',
+				'post_excerpt'   => 'A sample caption',
+			)
+		);
+
+		$png_id = self::factory()->attachment->create_object(
+			self::$test_file2,
+			0,
+			array(
+				'post_mime_type' => 'image/png',
+				'post_excerpt'   => 'A sample caption',
+			)
+		);
+
+		$request = new WP_REST_Request( 'GET', '/wp/v2/media' );
+
+		// Check ordering. Default ORDER is DESC.
+		$request->set_param( 'orderby', 'mime_type' );
+		$response = rest_get_server()->dispatch( $request );
+		$data     = $response->get_data();
+		$this->assertCount( 2, $data, 'Response count for orderby DESC mime_type is not 2' );
+		$this->assertSame( $png_id, $data[0]['id'], 'PNG ID not found in response for orderby DESC mime_type' );
+		$this->assertSame( $jpeg_id, $data[1]['id'], 'JPEG ID not found in response for orderby DESC mime_type' );
+
+		// ASC order.
+		$request->set_param( 'order', 'asc' );
+		$response = rest_get_server()->dispatch( $request );
+		$data     = $response->get_data();
+		$this->assertCount( 2, $data, 'Response count for orderby ASC mime_type is not 2' );
+		$this->assertSame( $jpeg_id, $data[0]['id'], 'JPEG ID not found in response for orderby ASC mime_type' );
+		$this->assertSame( $png_id, $data[1]['id'], 'PNG ID not found in response for orderby ASC mime_type' );
+	}
 }

tests/qunit/fixtures/wp-api-generated.js

@@ -2903,7 +2903,8 @@ mockedApiResponse.Schema = {
                                 "relevance",
                                 "slug",
                                 "include_slugs",
-                                "title"
+                                "title",
+                                "mime_type"
                             ],
                             "required": false
                         },