Changeset 14523 for sites/trunk/wordpress.org/public_html/wp-content/plugins/theme-directory/rest-api/class-theme-preview.php

Timestamp:

09/04/2025 04:46:46 AM (3 months ago)

Author:

dd32

Message:

Theme Directory: Upgrade the blueprint used for Theme Review live previews.

This removes the blueprint from being static in the trac ticket, allowing for future maintenance not to break older links.

Fixes #8077.
Merges ​https://github.com/WordPress/wordpress.org/pull/506.
See ​https://github.com/WordPress/wordpress-playground/issues/2548.

File:

• sites/trunk/wordpress.org/public_html/wp-content/plugins/theme-directory/rest-api/class-theme-preview.php (modified) (12 diffs)

sites/trunk/wordpress.org/public_html/wp-content/plugins/theme-directory/rest-api/class-theme-preview.php

@@ -12 +12 @@
             'callback'            => array( $this, 'preview' ),
             'permission_callback' => '__return_true',
+            'args'                => array(
+                'slug' => array(
+                    'type'              => 'string',
+                    'required'          => 'true',
+                    'sanitize_callback' => 'sanitize_key',
+                ),
+            ),
+        ) );
+
+        register_rest_route( 'themes/v1', 'review-blueprint/((?<post_id>[\d]+)-)?(?<slug>[^/]+)/(?<version>[0-9a-z.-_]+)?', array(
+            'methods'             => WP_REST_Server::READABLE,
+            'callback'            => array( $this, 'review' ),
+            'permission_callback' => '__return_true',
+            'args'                => array(
+                // If the theme isn't (yet) published, this can be set to force loading the post.
+                'post_id' => array(
+                    'type'              => 'integer',
+                    'required'          => false,
+                    'sanitize_callback' => 'absint',
+                ),
+                'slug' => array(
+                    'type'              => 'string',
+                    'required'          => true,
+                    'sanitize_callback' => 'sanitize_key',
+                ),
+                'version' => array(
+                    'type'     => 'string',
+                    'required' => false,
+                ),
+            ),
         ) );
 
@@ -17 +47 @@
             'methods'             => WP_REST_Server::CREATABLE,
             'callback'            => array( $this, 'set_blueprint' ),
+            'args'                => array(
+                'slug' => array(
+                    'type'              => 'string',
+                    'required'          => 'true',
+                    'sanitize_callback' => 'sanitize_key',
+                ),
+            ),
             'permission_callback' => function( $request ) {
                 $theme_data    = wporg_themes_theme_information( $request['slug'] );
@@ -44 +81 @@
 
         return $this->build_blueprint( $theme_data );
+    }
+
+    /**
+     * Generate a Blueprint for a theme review.
+     */
+    function review( $request ) {
+        // If the theme isn't (yet) published, use the post_id hint.
+        $preview_post = get_post( (int) $request->get_param( 'post_id' ) );
+        if (
+            $preview_post &&
+            'repopackage' === $preview_post->post_type &&
+            'publish' !== $preview_post->post_status &&
+            $preview_post->post_name === $request->get_param( 'slug' )
+        ) {
+            $GLOBALS['post'] = $preview_post;
+        }
+
+        $theme_data = wporg_themes_theme_information( $request->get_param( 'slug' ) );
+
+        return $this->build_blueprint(
+            $theme_data,
+            [
+                'version' => $request->get_param( 'version' ),
+                'review'  => true,
+            ]
+        );
     }
 
@@ -75 +138 @@
     /**
      * Generate a blueprint for previewing a theme.
+     *
+     * @param object $theme_data Theme data as returned by wporg_themes_theme_information
+     * @param array $params {
+     *      Optional parameters.
+     *      @type bool $review If true, generate a blueprint for theme review.
+     *      @type string $version Optional. The version string, empty for latest version.
+     * }
+     * @return array The blueprint.
      */
-    function build_blueprint( $theme_data ) {
-        $theme_package   = new WPORG_Themes_Repo_Package( $theme_data->slug );
+    function build_blueprint( $theme_data, $params = array() ) {
+        $is_theme_review = $params['review'] ?? false;
+        $version         = $params['version'] ?? false;
+        $theme_package   = new WPORG_Themes_Repo_Package( $theme_data->slug, $version );
         $parent_package  = $theme_data->template ? new WPORG_Themes_Repo_Package( $theme_data->template ) : false;
         $theme_blueprint = $theme_package->preview_blueprint;
@@ -84 +157 @@
         $blueprint = [
             'preferredVersions' => [
-                'php' => '8.0',
+                'php' => defined( 'RECOMMENDED_PHP' ) ? RECOMMENDED_PHP : substr( phpversion(), 0, 3 ),
                 'wp'  => 'latest'
             ],
@@ -140 +213 @@
                 'step'    => 'setSiteOptions',
                 'options' => [
-                    'blogname'        => $theme_data->name,
+                    'blogname'        => $theme_data->name . ( $version ? " $version" : '' ),
                     'blogdescription' => preg_replace( '![.].+$!',  '.', $theme_data->sections['description'] ), // First sentence only.
+                ]
+            ],
+            // Special case: BuddyPress.
+            ! ( $theme_data->tags && in_array( 'buddypress', $theme_data->tags, true ) ) ? false : [
+                'step' => 'installPlugin',
+                'pluginData' => [
+                    'resource' => 'wordpress.org/plugins',
+                    'slug'     => 'buddypress',
+                ],
+                'options' => [
+                    'activate' => true
                 ]
             ],
@@ -148 +232 @@
             empty( $theme_data->template ) ? false : [
                 'step'         => 'installTheme',
-                'themeZipFile' => [
+                'themeData' => [
                     'resource' => 'url',
                     'url'      => $parent_package->download_url(),
@@ -160 +244 @@
             [
                 'step'         => 'installTheme',
-                'themeZipFile' => [
+                'themeData' => [
                     'resource' => 'url',
                     'url'      => $theme_package->download_url(),
-                    'caption'  => "Downloading {$theme_package->post_title}",
+                    'caption'  => "Downloading {$theme_package->post_title}" . ( $version ? " $version" : '' ),
+                ],
+                'options' => [
+                    // Import the Starter Content if the theme didn't provide a blueprint.
+                    'importStarterContent' => ( ! $theme_blueprint ),
                 ]
             ]
@@ -175 +263 @@
                 if (
                     ! empty( $step['themeZipFile']['url'] ) ||
-                    ! empty( $step['pluginZipFile']['url'] )
+                    ! empty( $step['themeData']['url'] ) ||
+                    ! empty( $step['pluginZipFile']['url'] ) ||
+                    ! empty( $step['pluginData']['url'] )
                 ) {
                     return false;
@@ -182 +272 @@
                 // Don't need to install the theme again.
                 if ( 'installTheme' === $step['step'] ) {
-                    if ( $theme_data->slug === ( $step['themeZipFile']['slug'] ?? '' ) ) {
+                    if (
+                        $theme_data->slug === ( $step['themeZipFile']['slug'] ?? '' ) ||
+                        $theme_data->slug === ( $step['themeData']['slug'] ?? '' )
+                    ) {
                         return false;
                     }
-                    if ( ! empty( $theme_data->template ) && $theme_data->template === ( $step['themeZipFile']['slug'] ?? '' ) ) {
+                    if (
+                        ! empty( $theme_data->template ) &&
+                        (
+                            $theme_data->template === ( $step['themeZipFile']['slug'] ?? '' ) ||
+                            $theme_data->template === ( $step['themeData']['slug'] ?? '' )
+                        )
+                    ) {
                         return false;
                     }
@@ -194 +293 @@
         );
 
-        // Fill in a theme starter content step if specified.
-        // See: `installThemeStarterContent`. https://github.com/WordPress/wordpress-playground/pull/1521
-        foreach ( $theme_steps as $i => $step ) {
-            if ( 'installThemeStarterContent' === $step['step'] ) {
-                $theme_steps[ $i ] = $this->get_install_starter_content_step();
-            }
-        }
-
-        // If the theme didn't provide a blueprint, we'll also install the Starter Content. This must be done last.
-        // See also: `installThemeStarterContent`. https://github.com/WordPress/wordpress-playground/pull/1521
-        if ( ! $theme_blueprint ) {
-            $final_steps[] = $this->get_install_starter_content_step();
-        }
-
-        /*
-         * TODO: These artifacts need to be hosted somewhere better. 
-         */
-        $final_steps[] = [
-            'step' => 'installPlugin',
-            'pluginZipFile' => [
-                'resource' => 'url',
-                'url'      => 'https://raw.githubusercontent.com/WordPress/wordpress.org/trunk/wp-themes.com/public_html/wp-content/plugins/pattern-page.zip',
-            ],
-        ];
-        $final_steps[] = [
-            'step' => 'installPlugin',
-            'pluginZipFile' => [
-                'resource' => 'url',
-                'url'      => 'https://raw.githubusercontent.com/WordPress/wordpress.org/trunk/wp-themes.com/public_html/wp-content/plugins/style-variations.zip',
-            ],
-        ];
+        // Install the Theme Previewer plugins.
+        if ( ! $is_theme_review ) {
+            /*
+             * TODO: These artifacts need to be hosted somewhere better.
+             */
+
+            $final_steps[] = [
+                'step' => 'installPlugin',
+                'pluginData' => [
+                    'resource' => 'url',
+                    'url'      => 'https://raw.githubusercontent.com/WordPress/wordpress.org/trunk/wp-themes.com/public_html/wp-content/plugins/pattern-page.zip',
+                ],
+            ];
+            $final_steps[] = [
+                'step' => 'installPlugin',
+                'pluginData' => [
+                    'resource' => 'url',
+                    'url'      => 'https://raw.githubusercontent.com/WordPress/wordpress.org/trunk/wp-themes.com/public_html/wp-content/plugins/style-variations.zip',
+                ],
+            ];
+        }
+
+        // Theme Review specifics.
+        if ( $is_theme_review ) {
+            // Enable Debug mode.
+            $final_steps[] = [
+                'step' => 'defineWpConfigConsts',
+                'consts' => [
+                    'WP_DEBUG' => true
+                ]
+            ];
+
+            // Install Theme Check.
+            $final_steps[] = [
+                'step' => 'installPlugin',
+                'pluginData' => [
+                    'resource' => 'wordpress.org/plugins',
+                    'slug'     => 'theme-check',
+                ],
+                'options' => [
+                    'activate' => true
+                ]
+            ];
+
+            // Install the test content.
+            $final_steps[] = [
+                'step' => 'importWxr',
+                'file' => [
+                    'resource' => 'url',
+                    'url'      => 'https://raw.githubusercontent.com/WordPress/theme-test-data/master/themeunittestdata.wordpress.xml',
+                    'caption'  => 'Downloading theme testing content'
+                ]
+            ];
+        }
 
         // Set the steps.
@@ -235 +357 @@
         return $blueprint;
     }
-
-    /**
-     * Returns a formed step to install the starter content.
-     */
-    function get_install_starter_content_step() {
-        return [
-            'step' => 'runPHP',
-            'code' => '<?php
-                playground_add_filter( "plugins_loaded", "importThemeStarterContent_plugins_loaded", 0 );
-                function importThemeStarterContent_plugins_loaded() {
-                    /* Set as the admin user, this ensures we can customize the site. */
-                    wp_set_current_user(
-                        get_users( [ "role" => "Administrator" ] )[0]
-                    );
-
-                    /*
-                     * Simulate this request as a ajax customizer save, with the current theme in preview mode.
-                     *
-                     * See _wp_customize_include()
-                     */
-                    add_filter( "wp_doing_ajax", "__return_true" );
-                    $_REQUEST["action"]          = "customize_save";
-                    $_REQUEST["wp_customize"]    = "on";
-                    $_REQUEST["customize_theme"] = get_stylesheet();
-                    $_GET                        = $_REQUEST;
-
-                    /* Force the site to be fresh, although it should already be, some themes require this. */
-                    add_filter( "pre_option_fresh_site", "__return_true" );
-                }
-
-                require "/wordpress/wp-load.php";
-
-                if ( ! get_theme_starter_content() ) {
-                    return;
-                }
-
-                /* Import the Starter Content. */
-                $wp_customize->import_theme_starter_content();
-
-                /* Publish the changeset, which publishes the starter content. */
-                wp_publish_post( $wp_customize->changeset_post_id() );
-            '
-        ];
-    }
 }
 new Theme_Preview();