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

Timestamp:

04/05/2022 09:50:13 AM (3 years ago)

Author:

youknowriad

Message:

Block Editor: Backport the Global Styles Variations endpoint.

This include the /global-styles/themes/{theme}/variations rest endpoint into core.
The endpoint will be used by the site editor to display alternative theme styles to the user.

Props gziolo, oandregal.
See #55505.

File:

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

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

@@ -39 +39 @@
      */
     public function register_routes() {
+        register_rest_route(
+            $this->namespace,
+            '/' . $this->rest_base . '/themes/(?P<stylesheet>[\/\s%\w\.\(\)\[\]\@_\-]+)/variations',
+            array(
+                array(
+                    'methods'             => WP_REST_Server::READABLE,
+                    'callback'            => array( $this, 'get_theme_items' ),
+                    'permission_callback' => array( $this, 'get_theme_items_permissions_check' ),
+                    'args'                => array(
+                        'stylesheet' => array(
+                            'description' => __( 'The theme identifier' ),
+                            'type'        => 'string',
+                        ),
+                    ),
+                ),
+            )
+        );
+
         // List themes global styles.
         register_rest_route(
@@ -586 +604 @@
         return $response;
     }
+
+    /**
+     * Checks if a given request has access to read a single theme global styles config.
+     *
+     * @since 6.0.0
+     *
+     * @param WP_REST_Request $request Full details about the request.
+     * @return true|WP_Error True if the request has read access for the item, WP_Error object otherwise.
+     */
+    public function get_theme_items_permissions_check( $request ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
+        // Verify if the current user has edit_theme_options capability.
+        // This capability is required to edit/view/delete templates.
+        if ( ! current_user_can( 'edit_theme_options' ) ) {
+            return new WP_Error(
+                'rest_cannot_manage_global_styles',
+                __( 'Sorry, you are not allowed to access the global styles on this site.' ),
+                array(
+                    'status' => rest_authorization_required_code(),
+                )
+            );
+        }
+
+        return true;
+    }
+
+    /**
+     * Returns the given theme global styles variations.
+     *
+     * @since 6.0.0
+     *
+     * @param WP_REST_Request $request The request instance.
+     *
+     * @return WP_REST_Response|WP_Error
+     */
+    public function get_theme_items( $request ) {
+        if ( wp_get_theme()->get_stylesheet() !== $request['stylesheet'] ) {
+            // This endpoint only supports the active theme for now.
+            return new WP_Error(
+                'rest_theme_not_found',
+                __( 'Theme not found.' ),
+                array( 'status' => 404 )
+            );
+        }
+
+        $variations = WP_Theme_JSON_Resolver::get_style_variations();
+        $response   = rest_ensure_response( $variations );
+
+        return $response;
+    }
 }