register_core_block_style_handles()

Description

Hooks fired · 1

One hook fires while register_core_block_style_handles() runs, in this order:

1. 1
   apply_filters( block_type_metadata )filterline 122 (+93 into the body)

   Filters the metadata provided for registering a block type.

Uses · 11

• wp_get_wp_version()Returns the current WordPress version.
• wp_should_load_separate_core_block_assets()Checks whether separate styles should be loaded for core blocks.
• includes_url()Retrieves the URL to the includes directory.
• wp_scripts_get_suffix()Returns the suffix that can be used for the scripts.
• wp_styles()Initializes $wp_styles if it has not been set.
• wp_is_development_mode()Checks whether the site is in the given development mode.
• get_transient()Retrieves the value of a transient.
• wp_normalize_path()Normalizes a filesystem path.
• set_transient()Sets/updates the value of a transient.
• is_rtl()Determines whether the current locale is right-to-left (RTL).
• apply_filters()Calls the callback functions that have been added to a filter hook.

Source

View on Trac ↗View on GitHub ↗

29function register_core_block_style_handles() {30	$wp_version = wp_get_wp_version();31 32	if ( ! wp_should_load_separate_core_block_assets() ) {33		return;34	}35 36	$blocks_url   = includes_url( 'blocks/' );37	$suffix       = wp_scripts_get_suffix();38	$wp_styles    = wp_styles();39	$style_fields = array(40		'style'       => 'style',41		'editorStyle' => 'editor',42	);43 44	static $core_blocks_meta;45	if ( ! $core_blocks_meta ) {46		$core_blocks_meta = require BLOCKS_PATH . 'blocks-json.php';47	}48 49	$files          = false;50	$transient_name = 'wp_core_block_css_files';51 52	/*53	 * Ignore transient cache when the development mode is set to 'core'. Why? To avoid interfering with54	 * the core developer's workflow.55	 */56	$can_use_cached = ! wp_is_development_mode( 'core' );57 58	if ( $can_use_cached ) {59		$cached_files = get_transient( $transient_name );60 61		// Check the validity of cached values by checking against the current WordPress version.62		if (63			is_array( $cached_files )64			&& isset( $cached_files['version'] )65			&& $cached_files['version'] === $wp_version66			&& isset( $cached_files['files'] )67		) {68			$files = $cached_files['files'];69		}70	}71 72	if ( ! $files ) {73		$files = glob( wp_normalize_path( BLOCKS_PATH . '**/**.css' ) );74 75		// Normalize BLOCKS_PATH prior to substitution for Windows environments.76		$normalized_blocks_path = wp_normalize_path( BLOCKS_PATH );77 78		$files = array_map(79			static function ( $file ) use ( $normalized_blocks_path ) {80				return str_replace( $normalized_blocks_path, '', $file );81			},82			$files83		);84 85		// Save core block style paths in cache when not in development mode.86		if ( $can_use_cached ) {87			set_transient(88				$transient_name,89				array(90					'version' => $wp_version,91					'files'   => $files,92				)93			);94		}95	}96 97	$register_style = static function ( $name, $filename, $style_handle ) use ( $blocks_url, $suffix, $wp_styles, $files ) {98		$style_path = "{$name}/{$filename}{$suffix}.css";99		$path       = wp_normalize_path( BLOCKS_PATH . $style_path );100 101		if ( ! in_array( $style_path, $files, true ) ) {102			$wp_styles->add(103				$style_handle,104				false105			);106			return;107		}108

History

Introduced in 6.3.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/blocks/index.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.