Changeset 47573 for trunk/src/wp-includes/theme.php

Timestamp:

04/13/2020 03:26:37 PM (6 years ago)

Author:

SergeyBiryukov

Message:

Themes: Block theme activation if it requires a higher version of PHP or WordPress.

Introduce validate_theme_requirements() for validating a theme's WordPress and PHP version requirements.

Follow-up to [44978] and [45546] for plugins.

Props afragen, audrasjb, SergeyBiryukov.
See #43992.

File:

• trunk/src/wp-includes/theme.php (modified) (2 diffs)

trunk/src/wp-includes/theme.php

@@ -734 +734 @@
         global $wp_theme_directories, $wp_customize, $sidebars_widgets;
 
+        $requirements = validate_theme_requirements( $stylesheet );
+        if ( is_wp_error( $requirements ) ) {
+                wp_die( $requirements );
+        }
+
         $_sidebars_widgets = null;
         if ( 'wp_ajax_customize_save' === current_action() ) {
@@ -879 +884 @@
         switch_theme( $default->get_stylesheet() );
         return false;
+}
+
+/**
+ * Validates the theme requirements for WordPress version and PHP version.
+ *
+ * Uses the information from `Requires at least` and `Requires PHP` headers
+ * defined in the theme's `style.css` file.
+ *
+ * If the headers are not present in the theme's stylesheet file,
+ * `readme.txt` is also checked as a fallback.
+ *
+ * @since 5.5.0
+ *
+ * @param string $stylesheet Directory name for the theme.
+ * @return true|WP_Error True if requirements are met, WP_Error on failure.
+ */
+function validate_theme_requirements( $stylesheet ) {
+        $theme = wp_get_theme( $stylesheet );
+
+        $requirements = array(
+                'requires'     => ! empty( $theme->get( 'RequiresWP' ) ) ? $theme->get( 'RequiresWP' ) : '',
+                'requires_php' => ! empty( $theme->get( 'RequiresPHP' ) ) ? $theme->get( 'RequiresPHP' ) : '',
+        );
+
+        $readme_file = $theme->theme_root . '/' . $stylesheet . '/readme.txt';
+
+        if ( file_exists( $readme_file ) ) {
+                $readme_headers = get_file_data(
+                        $readme_file,
+                        array(
+                                'requires'     => 'Requires at least',
+                                'requires_php' => 'Requires PHP',
+                        ),
+                        'theme'
+                );
+
+                $requirements = array_merge( $readme_headers, $requirements );
+        }
+
+        $compatible_wp  = is_wp_version_compatible( $requirements['requires'] );
+        $compatible_php = is_php_version_compatible( $requirements['requires_php'] );
+
+        if ( ! $compatible_wp && ! $compatible_php ) {
+                return new WP_Error(
+                        'theme_wp_php_incompatible',
+                        sprintf(
+                                /* translators: %s: Theme name. */
+                                _x( '<strong>Error:</strong> Current WordPress and PHP versions do not meet minimum requirements for %s.', 'theme' ),
+                                $theme->display( 'Name' )
+                        )
+                );
+        } elseif ( ! $compatible_php ) {
+                return new WP_Error(
+                        'theme_php_incompatible',
+                        sprintf(
+                                /* translators: %s: Theme name. */
+                                _x( '<strong>Error:</strong> Current PHP version does not meet minimum requirements for %s.', 'theme' ),
+                                $theme->display( 'Name' )
+                        )
+                );
+        } elseif ( ! $compatible_wp ) {
+                return new WP_Error(
+                        'theme_wp_incompatible',
+                        sprintf(
+                                /* translators: %s: Theme name. */
+                                _x( '<strong>Error:</strong> Current WordPress version does not meet minimum requirements for %s.', 'theme' ),
+                                $theme->display( 'Name' )
+                        )
+                );
+        }
+
+        return true;
 }