Changeset 57494 for trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-global-styles-revisions-controller.php

Timestamp:

01/31/2024 10:39:04 AM (8 months ago)

Author:

youknowriad

Message:

REST API: Add route for single styles revisions.

Adds a route for single global styles revisions: /wp/v2/global-styles/${ parentId }/revisions/${ revisionsId }
This fixes the getRevision actions in the core-data package.

Props ramonopoly, get_dave.
Fixes #59810.

File:

• trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-global-styles-revisions-controller.php (modified) (3 diffs)

trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-global-styles-revisions-controller.php

@@ -48 +48 @@
      *
      * @since 6.3.0
+     * @since 6.5.0 Added route to fetch individual global styles revisions.
      */
     public function register_routes() {
@@ -65 +66 @@
                     'permission_callback' => array( $this, 'get_item_permissions_check' ),
                     'args'                => $this->get_collection_params(),
+                ),
+                'schema' => array( $this, 'get_public_item_schema' ),
+            )
+        );
+
+        register_rest_route(
+            $this->namespace,
+            '/' . $this->parent_base . '/(?P<parent>[\d]+)/' . $this->rest_base . '/(?P<id>[\d]+)',
+            array(
+                'args'   => array(
+                    'parent' => array(
+                        'description' => __( 'The ID for the parent of the global styles revision.' ),
+                        'type'        => 'integer',
+                    ),
+                    'id'     => array(
+                        'description' => __( 'Unique identifier for the global styles revision.' ),
+                        'type'        => 'integer',
+                    ),
+                ),
+                array(
+                    'methods'             => WP_REST_Server::READABLE,
+                    'callback'            => array( $this, 'get_item' ),
+                    'permission_callback' => array( $this, 'get_item_permissions_check' ),
+                    'args'                => array(
+                        'context' => $this->get_context_param( array( 'default' => 'view' ) ),
+                    ),
                 ),
                 'schema' => array( $this, 'get_public_item_schema' ),
@@ -243 +270 @@
 
     /**
+     * Retrieves one global styles revision from the collection.
+     *
+     * @since 6.5.0
+     *
+     * @param WP_REST_Request $request Full details about the request.
+     * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
+     */
+    public function get_item( $request ) {
+        $parent = $this->get_parent( $request['parent'] );
+        if ( is_wp_error( $parent ) ) {
+            return $parent;
+        }
+
+        $revision = $this->get_revision( $request['id'] );
+        if ( is_wp_error( $revision ) ) {
+            return $revision;
+        }
+
+        $response = $this->prepare_item_for_response( $revision, $request );
+        return rest_ensure_response( $response );
+    }
+
+    /**
+     * Gets the global styles revision, if the ID is valid.
+     *
+     * @since 6.5.0
+     *
+     * @param int $id Supplied ID.
+     * @return WP_Post|WP_Error Revision post object if ID is valid, WP_Error otherwise.
+     */
+    protected function get_revision( $id ) {
+        $error = new WP_Error(
+            'rest_post_invalid_id',
+            __( 'Invalid global styles revision ID.' ),
+            array( 'status' => 404 )
+        );
+
+        if ( (int) $id <= 0 ) {
+            return $error;
+        }
+
+        $revision = get_post( (int) $id );
+        if ( empty( $revision ) || empty( $revision->ID ) || 'revision' !== $revision->post_type ) {
+            return $error;
+        }
+
+        return $revision;
+    }
+
+    /**
      * Checks the post_date_gmt or modified_gmt and prepare any post or
      * modified date for single post output.