функция
since 5.8.0
_load_remote_block_patterns()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
_load_remote_block_patterns( WP_Screen $deprecated = null )
Описание
Регистрирует официальные паттерны ядра с wordpress.org/patterns.
Параметры
$deprecated
WP_Screen
необязательный
= null
Не используется. Ранее — экран, с которого был инициирован текущий запрос.
Исходный код
wp-includes/block-patterns.php:281
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 );
}
}
}
История изменений
| Версия | Описание |
|---|---|
| 6.3.0 | Add 'pattern-directory/core' to the pattern’s 'source'. |
| 6.2.0 | Normalize the pattern from the API (snake_case) to the format expected by register_block_pattern (camelCase). |
| 5.9.0 | The $current_screen argument was removed. |
| 5.8.0 | Introduced. |

