mirror of
https://github.com/WordPress/WordPress.git
synced 2024-09-27 06:42:56 +02:00
b0872b005d
The `_register_theme_block_patterns` function imposed a significant resource overhead. This issue primarily stems from themes, such as TT4, that register a substantial number of block patterns. These patterns necessitate numerous file operations, including file lookups, file reading into memory, and related processes. To provide an overview, the _register_theme_block_patterns function performed the following file operations: - is_dir - is_readable - file_exists - glob - file_get_contents (utilized via get_file_data) To address these issues, caching using a transient has been added to a new function call `_wp_get_block_patterns`. If theme development mode is disabled and theme exists, the block patterns are saved in a transient cache. This cache is used all requests after that, saving file lookups and reading files into memory. Cache invalidation is done, when themes are switched, deleted or updated. Meaning that block patterns are not stored in the cache incorrectly. Props flixos90, joemcgill, peterwilsoncc, costdev, swissspidy, aristath, westonruter, spacedmonkey. Fixes #59490 Built from https://develop.svn.wordpress.org/trunk@56765 git-svn-id: http://core.svn.wordpress.org/trunk@56277 1a063a9b-81f0-0310-95a4-ce76da25c4cd
552 lines
16 KiB
PHP
552 lines
16 KiB
PHP
<?php
|
|
/**
|
|
* Register the block patterns and block patterns categories
|
|
*
|
|
* @package WordPress
|
|
* @since 5.5.0
|
|
*/
|
|
|
|
add_theme_support( 'core-block-patterns' );
|
|
|
|
/**
|
|
* Registers the core block patterns and categories.
|
|
*
|
|
* @since 5.5.0
|
|
* @since 6.3.0 Added source to core block patterns.
|
|
* @access private
|
|
*/
|
|
function _register_core_block_patterns_and_categories() {
|
|
$should_register_core_patterns = get_theme_support( 'core-block-patterns' );
|
|
|
|
if ( $should_register_core_patterns ) {
|
|
$core_block_patterns = array(
|
|
'query-standard-posts',
|
|
'query-medium-posts',
|
|
'query-small-posts',
|
|
'query-grid-posts',
|
|
'query-large-title-posts',
|
|
'query-offset-posts',
|
|
'social-links-shared-background-color',
|
|
);
|
|
|
|
foreach ( $core_block_patterns as $core_block_pattern ) {
|
|
$pattern = require __DIR__ . '/block-patterns/' . $core_block_pattern . '.php';
|
|
$pattern['source'] = 'core';
|
|
register_block_pattern( 'core/' . $core_block_pattern, $pattern );
|
|
}
|
|
}
|
|
|
|
register_block_pattern_category( 'banner', array( 'label' => _x( 'Banners', 'Block pattern category' ) ) );
|
|
register_block_pattern_category(
|
|
'buttons',
|
|
array(
|
|
'label' => _x( 'Buttons', 'Block pattern category' ),
|
|
'description' => __( 'Patterns that contain buttons and call to actions.' ),
|
|
)
|
|
);
|
|
register_block_pattern_category(
|
|
'columns',
|
|
array(
|
|
'label' => _x( 'Columns', 'Block pattern category' ),
|
|
'description' => __( 'Multi-column patterns with more complex layouts.' ),
|
|
)
|
|
);
|
|
register_block_pattern_category(
|
|
'text',
|
|
array(
|
|
'label' => _x( 'Text', 'Block pattern category' ),
|
|
'description' => __( 'Patterns containing mostly text.' ),
|
|
)
|
|
);
|
|
register_block_pattern_category(
|
|
'query',
|
|
array(
|
|
'label' => _x( 'Posts', 'Block pattern category' ),
|
|
'description' => __( 'Display your latest posts in lists, grids or other layouts.' ),
|
|
)
|
|
);
|
|
register_block_pattern_category(
|
|
'featured',
|
|
array(
|
|
'label' => _x( 'Featured', 'Block pattern category' ),
|
|
'description' => __( 'A set of high quality curated patterns.' ),
|
|
)
|
|
);
|
|
register_block_pattern_category(
|
|
'call-to-action',
|
|
array(
|
|
'label' => _x( 'Call to Action', 'Block pattern category' ),
|
|
'description' => __( 'Sections whose purpose is to trigger a specific action.' ),
|
|
)
|
|
);
|
|
register_block_pattern_category(
|
|
'team',
|
|
array(
|
|
'label' => _x( 'Team', 'Block pattern category' ),
|
|
'description' => __( 'A variety of designs to display your team members.' ),
|
|
)
|
|
);
|
|
register_block_pattern_category(
|
|
'testimonials',
|
|
array(
|
|
'label' => _x( 'Testimonials', 'Block pattern category' ),
|
|
'description' => __( 'Share reviews and feedback about your brand/business.' ),
|
|
)
|
|
);
|
|
register_block_pattern_category(
|
|
'services',
|
|
array(
|
|
'label' => _x( 'Services', 'Block pattern category' ),
|
|
'description' => __( 'Briefly describe what your business does and how you can help.' ),
|
|
)
|
|
);
|
|
register_block_pattern_category(
|
|
'contact',
|
|
array(
|
|
'label' => _x( 'Contact', 'Block pattern category' ),
|
|
'description' => __( 'Display your contact information.' ),
|
|
)
|
|
);
|
|
register_block_pattern_category(
|
|
'about',
|
|
array(
|
|
'label' => _x( 'About', 'Block pattern category' ),
|
|
'description' => __( 'Introduce yourself.' ),
|
|
)
|
|
);
|
|
register_block_pattern_category(
|
|
'portfolio',
|
|
array(
|
|
'label' => _x( 'Portfolio', 'Block pattern category' ),
|
|
'description' => __( 'Showcase your latest work.' ),
|
|
)
|
|
);
|
|
register_block_pattern_category(
|
|
'gallery',
|
|
array(
|
|
'label' => _x( 'Gallery', 'Block pattern category' ),
|
|
'description' => __( 'Different layouts for displaying images.' ),
|
|
)
|
|
);
|
|
register_block_pattern_category(
|
|
'media',
|
|
array(
|
|
'label' => _x( 'Media', 'Block pattern category' ),
|
|
'description' => __( 'Different layouts containing video or audio.' ),
|
|
)
|
|
);
|
|
register_block_pattern_category(
|
|
'posts',
|
|
array(
|
|
'label' => _x( 'Posts', 'Block pattern category' ),
|
|
'description' => __( 'Display your latest posts in lists, grids or other layouts.' ),
|
|
)
|
|
);
|
|
register_block_pattern_category(
|
|
'footer',
|
|
array(
|
|
'label' => _x( 'Footers', 'Block pattern category' ),
|
|
'description' => __( 'A variety of footer designs displaying information and site navigation.' ),
|
|
)
|
|
);
|
|
register_block_pattern_category(
|
|
'header',
|
|
array(
|
|
'label' => _x( 'Headers', 'Block pattern category' ),
|
|
'description' => __( 'A variety of header designs displaying your site title and navigation.' ),
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Normalize the pattern properties to camelCase.
|
|
*
|
|
* The API's format is snake_case, `register_block_pattern()` expects camelCase.
|
|
*
|
|
* @since 6.2.0
|
|
* @access private
|
|
*
|
|
* @param array $pattern Pattern as returned from the Pattern Directory API.
|
|
* @return array Normalized pattern.
|
|
*/
|
|
function wp_normalize_remote_block_pattern( $pattern ) {
|
|
if ( isset( $pattern['block_types'] ) ) {
|
|
$pattern['blockTypes'] = $pattern['block_types'];
|
|
unset( $pattern['block_types'] );
|
|
}
|
|
|
|
if ( isset( $pattern['viewport_width'] ) ) {
|
|
$pattern['viewportWidth'] = $pattern['viewport_width'];
|
|
unset( $pattern['viewport_width'] );
|
|
}
|
|
|
|
return (array) $pattern;
|
|
}
|
|
|
|
/**
|
|
* Register Core's official patterns from wordpress.org/patterns.
|
|
*
|
|
* @since 5.8.0
|
|
* @since 5.9.0 The $current_screen argument was removed.
|
|
* @since 6.2.0 Normalize the pattern from the API (snake_case) to the
|
|
* format expected by `register_block_pattern` (camelCase).
|
|
* @since 6.3.0 Add 'pattern-directory/core' to the pattern's 'source'.
|
|
*
|
|
* @param WP_Screen $deprecated Unused. Formerly the screen that the current request was triggered from.
|
|
*/
|
|
function _load_remote_block_patterns( $deprecated = null ) {
|
|
if ( ! empty( $deprecated ) ) {
|
|
_deprecated_argument( __FUNCTION__, '5.9.0' );
|
|
$current_screen = $deprecated;
|
|
if ( ! $current_screen->is_block_editor ) {
|
|
return;
|
|
}
|
|
}
|
|
|
|
$supports_core_patterns = get_theme_support( 'core-block-patterns' );
|
|
|
|
/**
|
|
* Filter to disable remote block patterns.
|
|
*
|
|
* @since 5.8.0
|
|
*
|
|
* @param bool $should_load_remote
|
|
*/
|
|
$should_load_remote = apply_filters( 'should_load_remote_block_patterns', true );
|
|
|
|
if ( $supports_core_patterns && $should_load_remote ) {
|
|
$request = new WP_REST_Request( 'GET', '/wp/v2/pattern-directory/patterns' );
|
|
$core_keyword_id = 11; // 11 is the ID for "core".
|
|
$request->set_param( 'keyword', $core_keyword_id );
|
|
$response = rest_do_request( $request );
|
|
if ( $response->is_error() ) {
|
|
return;
|
|
}
|
|
$patterns = $response->get_data();
|
|
|
|
foreach ( $patterns as $pattern ) {
|
|
$pattern['source'] = 'pattern-directory/core';
|
|
$normalized_pattern = wp_normalize_remote_block_pattern( $pattern );
|
|
$pattern_name = 'core/' . sanitize_title( $normalized_pattern['title'] );
|
|
register_block_pattern( $pattern_name, $normalized_pattern );
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Register `Featured` (category) patterns from wordpress.org/patterns.
|
|
*
|
|
* @since 5.9.0
|
|
* @since 6.2.0 Normalized the pattern from the API (snake_case) to the
|
|
* format expected by `register_block_pattern()` (camelCase).
|
|
* @since 6.3.0 Add 'pattern-directory/featured' to the pattern's 'source'.
|
|
*/
|
|
function _load_remote_featured_patterns() {
|
|
$supports_core_patterns = get_theme_support( 'core-block-patterns' );
|
|
|
|
/** This filter is documented in wp-includes/block-patterns.php */
|
|
$should_load_remote = apply_filters( 'should_load_remote_block_patterns', true );
|
|
|
|
if ( ! $should_load_remote || ! $supports_core_patterns ) {
|
|
return;
|
|
}
|
|
|
|
$request = new WP_REST_Request( 'GET', '/wp/v2/pattern-directory/patterns' );
|
|
$featured_cat_id = 26; // This is the `Featured` category id from pattern directory.
|
|
$request->set_param( 'category', $featured_cat_id );
|
|
$response = rest_do_request( $request );
|
|
if ( $response->is_error() ) {
|
|
return;
|
|
}
|
|
$patterns = $response->get_data();
|
|
$registry = WP_Block_Patterns_Registry::get_instance();
|
|
foreach ( $patterns as $pattern ) {
|
|
$pattern['source'] = 'pattern-directory/featured';
|
|
$normalized_pattern = wp_normalize_remote_block_pattern( $pattern );
|
|
$pattern_name = sanitize_title( $normalized_pattern['title'] );
|
|
// Some patterns might be already registered as core patterns with the `core` prefix.
|
|
$is_registered = $registry->is_registered( $pattern_name ) || $registry->is_registered( "core/$pattern_name" );
|
|
if ( ! $is_registered ) {
|
|
register_block_pattern( $pattern_name, $normalized_pattern );
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Registers patterns from Pattern Directory provided by a theme's
|
|
* `theme.json` file.
|
|
*
|
|
* @since 6.0.0
|
|
* @since 6.2.0 Normalized the pattern from the API (snake_case) to the
|
|
* format expected by `register_block_pattern()` (camelCase).
|
|
* @since 6.3.0 Add 'pattern-directory/theme' to the pattern's 'source'.
|
|
* @access private
|
|
*/
|
|
function _register_remote_theme_patterns() {
|
|
/** This filter is documented in wp-includes/block-patterns.php */
|
|
if ( ! apply_filters( 'should_load_remote_block_patterns', true ) ) {
|
|
return;
|
|
}
|
|
|
|
if ( ! wp_theme_has_theme_json() ) {
|
|
return;
|
|
}
|
|
|
|
$pattern_settings = wp_get_theme_directory_pattern_slugs();
|
|
if ( empty( $pattern_settings ) ) {
|
|
return;
|
|
}
|
|
|
|
$request = new WP_REST_Request( 'GET', '/wp/v2/pattern-directory/patterns' );
|
|
$request['slug'] = $pattern_settings;
|
|
$response = rest_do_request( $request );
|
|
if ( $response->is_error() ) {
|
|
return;
|
|
}
|
|
$patterns = $response->get_data();
|
|
$patterns_registry = WP_Block_Patterns_Registry::get_instance();
|
|
foreach ( $patterns as $pattern ) {
|
|
$pattern['source'] = 'pattern-directory/theme';
|
|
$normalized_pattern = wp_normalize_remote_block_pattern( $pattern );
|
|
$pattern_name = sanitize_title( $normalized_pattern['title'] );
|
|
// Some patterns might be already registered as core patterns with the `core` prefix.
|
|
$is_registered = $patterns_registry->is_registered( $pattern_name ) || $patterns_registry->is_registered( "core/$pattern_name" );
|
|
if ( ! $is_registered ) {
|
|
register_block_pattern( $pattern_name, $normalized_pattern );
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Register any patterns that the active theme may provide under its
|
|
* `./patterns/` directory.
|
|
*
|
|
* @since 6.0.0
|
|
* @since 6.1.0 The `postTypes` property was added.
|
|
* @since 6.2.0 The `templateTypes` property was added.
|
|
* @since 6.4.0 Uses the `_wp_get_block_patterns` function.
|
|
* @access private
|
|
*/
|
|
function _register_theme_block_patterns() {
|
|
/*
|
|
* Register patterns for the active theme. If the theme is a child theme,
|
|
* let it override any patterns from the parent theme that shares the same slug.
|
|
*/
|
|
$themes = array();
|
|
$theme = wp_get_theme();
|
|
$themes[] = $theme;
|
|
if ( $theme->parent() ) {
|
|
$themes[] = $theme->parent();
|
|
}
|
|
$registry = WP_Block_Patterns_Registry::get_instance();
|
|
|
|
foreach ( $themes as $theme ) {
|
|
$pattern_data = _wp_get_block_patterns( $theme );
|
|
$dirpath = $theme->get_stylesheet_directory() . '/patterns/';
|
|
$text_domain = $theme->get( 'TextDomain' );
|
|
|
|
foreach ( $pattern_data['patterns'] as $file => $pattern_data ) {
|
|
if ( $registry->is_registered( $pattern_data['slug'] ) ) {
|
|
continue;
|
|
}
|
|
|
|
// The actual pattern content is the output of the file.
|
|
ob_start();
|
|
include $dirpath . $file;
|
|
$pattern_data['content'] = ob_get_clean();
|
|
if ( ! $pattern_data['content'] ) {
|
|
continue;
|
|
}
|
|
|
|
// Translate the pattern metadata.
|
|
// phpcs:ignore WordPress.WP.I18n.NonSingularStringLiteralText,WordPress.WP.I18n.NonSingularStringLiteralDomain,WordPress.WP.I18n.LowLevelTranslationFunction
|
|
$pattern_data['title'] = translate_with_gettext_context( $pattern_data['title'], 'Pattern title', $text_domain );
|
|
if ( ! empty( $pattern_data['description'] ) ) {
|
|
// phpcs:ignore WordPress.WP.I18n.NonSingularStringLiteralText,WordPress.WP.I18n.NonSingularStringLiteralDomain,WordPress.WP.I18n.LowLevelTranslationFunction
|
|
$pattern_data['description'] = translate_with_gettext_context( $pattern_data['description'], 'Pattern description', $text_domain );
|
|
}
|
|
|
|
register_block_pattern( $pattern_data['slug'], $pattern_data );
|
|
}
|
|
}
|
|
}
|
|
add_action( 'init', '_register_theme_block_patterns' );
|
|
|
|
/**
|
|
* Gets block pattern data for a specified theme.
|
|
* Each pattern is defined as a PHP file and defines
|
|
* its metadata using plugin-style headers. The minimum required definition is:
|
|
*
|
|
* /**
|
|
* * Title: My Pattern
|
|
* * Slug: my-theme/my-pattern
|
|
* *
|
|
*
|
|
* The output of the PHP source corresponds to the content of the pattern, e.g.:
|
|
*
|
|
* <main><p><?php echo "Hello"; ?></p></main>
|
|
*
|
|
* If applicable, this will collect from both parent and child theme.
|
|
*
|
|
* Other settable fields include:
|
|
*
|
|
* - Description
|
|
* - Viewport Width
|
|
* - Inserter (yes/no)
|
|
* - Categories (comma-separated values)
|
|
* - Keywords (comma-separated values)
|
|
* - Block Types (comma-separated values)
|
|
* - Post Types (comma-separated values)
|
|
* - Template Types (comma-separated values)
|
|
*
|
|
* @since 6.4.0
|
|
* @access private
|
|
*
|
|
* @param WP_Theme $theme Theme object.
|
|
* @return array Block pattern data.
|
|
*/
|
|
|
|
function _wp_get_block_patterns( WP_Theme $theme ) {
|
|
if ( ! $theme->exists() ) {
|
|
return array(
|
|
'version' => false,
|
|
'patterns' => array(),
|
|
);
|
|
}
|
|
|
|
$transient_name = 'wp_theme_patterns_' . $theme->get_stylesheet();
|
|
$version = $theme->get( 'Version' );
|
|
$can_use_cached = ! wp_is_development_mode( 'theme' );
|
|
|
|
if ( $can_use_cached ) {
|
|
$pattern_data = get_transient( $transient_name );
|
|
if ( is_array( $pattern_data ) && $pattern_data['version'] === $version ) {
|
|
return $pattern_data;
|
|
}
|
|
}
|
|
|
|
$pattern_data = array(
|
|
'version' => $version,
|
|
'patterns' => array(),
|
|
);
|
|
$dirpath = $theme->get_stylesheet_directory() . '/patterns/';
|
|
|
|
if ( ! file_exists( $dirpath ) ) {
|
|
if ( $can_use_cached ) {
|
|
set_transient( $transient_name, $pattern_data );
|
|
}
|
|
return $pattern_data;
|
|
}
|
|
$files = glob( $dirpath . '*.php' );
|
|
if ( ! $files ) {
|
|
if ( $can_use_cached ) {
|
|
set_transient( $transient_name, $pattern_data );
|
|
}
|
|
return $pattern_data;
|
|
}
|
|
|
|
$default_headers = array(
|
|
'title' => 'Title',
|
|
'slug' => 'Slug',
|
|
'description' => 'Description',
|
|
'viewportWidth' => 'Viewport Width',
|
|
'inserter' => 'Inserter',
|
|
'categories' => 'Categories',
|
|
'keywords' => 'Keywords',
|
|
'blockTypes' => 'Block Types',
|
|
'postTypes' => 'Post Types',
|
|
'templateTypes' => 'Template Types',
|
|
);
|
|
|
|
$properties_to_parse = array(
|
|
'categories',
|
|
'keywords',
|
|
'blockTypes',
|
|
'postTypes',
|
|
'templateTypes',
|
|
);
|
|
|
|
foreach ( $files as $file ) {
|
|
$pattern = get_file_data( $file, $default_headers );
|
|
|
|
if ( empty( $pattern['slug'] ) ) {
|
|
_doing_it_wrong(
|
|
__FUNCTION__,
|
|
sprintf(
|
|
/* translators: %s: file name. */
|
|
__( 'Could not register file "%s" as a block pattern ("Slug" field missing)' ),
|
|
$file
|
|
),
|
|
'6.0.0'
|
|
);
|
|
continue;
|
|
}
|
|
|
|
if ( ! preg_match( '/^[A-z0-9\/_-]+$/', $pattern['slug'] ) ) {
|
|
_doing_it_wrong(
|
|
__FUNCTION__,
|
|
sprintf(
|
|
/* translators: %1s: file name; %2s: slug value found. */
|
|
__( 'Could not register file "%1$s" as a block pattern (invalid slug "%2$s")' ),
|
|
$file,
|
|
$pattern['slug']
|
|
),
|
|
'6.0.0'
|
|
);
|
|
}
|
|
|
|
// Title is a required property.
|
|
if ( ! $pattern['title'] ) {
|
|
_doing_it_wrong(
|
|
__FUNCTION__,
|
|
sprintf(
|
|
/* translators: %1s: file name. */
|
|
__( 'Could not register file "%s" as a block pattern ("Title" field missing)' ),
|
|
$file
|
|
),
|
|
'6.0.0'
|
|
);
|
|
continue;
|
|
}
|
|
|
|
// For properties of type array, parse data as comma-separated.
|
|
foreach ( $properties_to_parse as $property ) {
|
|
if ( ! empty( $pattern[ $property ] ) ) {
|
|
$pattern[ $property ] = array_filter( wp_parse_list( (string) $pattern[ $property ] ) );
|
|
} else {
|
|
unset( $pattern[ $property ] );
|
|
}
|
|
}
|
|
|
|
// Parse properties of type int.
|
|
$property = 'viewportWidth';
|
|
if ( ! empty( $pattern[ $property ] ) ) {
|
|
$pattern[ $property ] = (int) $pattern[ $property ];
|
|
} else {
|
|
unset( $pattern[ $property ] );
|
|
}
|
|
|
|
// Parse properties of type bool.
|
|
$property = 'inserter';
|
|
if ( ! empty( $pattern[ $property ] ) ) {
|
|
$pattern[ $property ] = in_array(
|
|
strtolower( $pattern[ $property ] ),
|
|
array( 'yes', 'true' ),
|
|
true
|
|
);
|
|
} else {
|
|
unset( $pattern[ $property ] );
|
|
}
|
|
|
|
$key = str_replace( $dirpath, '', $file );
|
|
|
|
$pattern_data['patterns'][ $key ] = $pattern;
|
|
}
|
|
|
|
if ( $can_use_cached ) {
|
|
set_transient( $transient_name, $pattern_data );
|
|
}
|
|
|
|
return $pattern_data;
|
|
}
|