get_block_asset_url( string $path ): string|false

Parameters

$pathstring

A normalized path to a block asset.

Return

string|false

The URL to the block asset or false on failure.

Uses · 11

• wp_normalize_path()Normalizes a filesystem path.
• str_starts_with()Polyfill for `str_starts_with()` function added in PHP 8.0.
• includes_url()Retrieves the URL to the includes directory.
• get_template()Retrieves name of the active theme.
• get_template_directory()Retrieves template directory path for the active theme.
• trailingslashit()Appends a trailing slash.
• get_theme_file_uri()Retrieves the URL of a file in the theme.
• is_child_theme()Whether a child theme is in use.
• get_stylesheet()Retrieves name of the current stylesheet.
• get_stylesheet_directory()Retrieves stylesheet directory path for the active theme.
• plugins_url()Retrieves a URL within the plugins or mu-plugins directory.

Used by · 3

• register_block_script_handle()Finds a script handle for the selected block metadata field. It detects when a path to file was provided and optionally finds a corresponding asset file with details necessary to register the script under automatically generated handle name. It returns unprocessed script handle otherwise.
• register_block_script_module_id()Finds a script module ID for the selected block metadata field. It detects when a path to file was provided and optionally finds a corresponding asset file with details necessary to register the script module under with an automatically generated module ID. It returns unprocessed script module ID otherwise.
• register_block_style_handle()Finds a style handle for the block metadata field. It detects when a path to file was provided and registers the style under automatically generated handle name. It returns unprocessed style handle otherwise.

Source

View on Trac ↗View on GitHub ↗

90function get_block_asset_url( $path ) {91	if ( empty( $path ) ) {92		return false;93	}94 95	// Path needs to be normalized to work in Windows env.96	static $wpinc_path_norm = '';97	if ( ! $wpinc_path_norm ) {98		$wpinc_path_norm = wp_normalize_path( realpath( ABSPATH . WPINC ) );99	}100 101	if ( str_starts_with( $path, $wpinc_path_norm ) ) {102		return includes_url( str_replace( $wpinc_path_norm, '', $path ) );103	}104 105	static $template_paths_norm = array();106 107	$template = get_template();108	if ( ! isset( $template_paths_norm[ $template ] ) ) {109		$template_paths_norm[ $template ] = wp_normalize_path( realpath( get_template_directory() ) );110	}111 112	if ( str_starts_with( $path, trailingslashit( $template_paths_norm[ $template ] ) ) ) {113		return get_theme_file_uri( str_replace( $template_paths_norm[ $template ], '', $path ) );114	}115 116	if ( is_child_theme() ) {117		$stylesheet = get_stylesheet();118		if ( ! isset( $template_paths_norm[ $stylesheet ] ) ) {119			$template_paths_norm[ $stylesheet ] = wp_normalize_path( realpath( get_stylesheet_directory() ) );120		}121 122		if ( str_starts_with( $path, trailingslashit( $template_paths_norm[ $stylesheet ] ) ) ) {123			return get_theme_file_uri( str_replace( $template_paths_norm[ $stylesheet ], '', $path ) );124		}125	}126 127	return plugins_url( basename( $path ), $path );128}

History

Introduced in 6.4.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.0.4 tag, from src/wp-includes/blocks.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.