get_theme_root_uri() │ WP 1.5.0

Retrieve URI for themes directory.

Does not have trailing slash.

Uses: content_url()
Used By: get_stylesheet_directory_uri(), get_template_directory_uri()
1 time — 0.00004 sec (very fast) | 50000 times — 2.11 sec (fast)
Hooks from the function

Return

String. Themes directory URI.

Usage

get_theme_root_uri( $stylesheet_or_template, $theme_root );
$stylesheet_or_template(string)
The stylesheet or template name of the theme.
Default: to leverage the main theme root
$theme_root(string)
The theme root for which calculations will be based, preventing the need for a get_raw_theme_root() call.
Default: ''

Examples

0

#1 An example of how the function works 

$themes_directory = get_theme_root_uri();
echo $themes_directory;

// display:
// https://wp-kama.com/wp-content/themes

Notes

  • Global. Array. $wp_theme_directories

Changelog

Since 1.5.0 Introduced.

get_theme_root_uri() code WP 6.7.1

wp-includes/theme.php 
function get_theme_root_uri( $stylesheet_or_template = '', $theme_root = '' ) {
	global $wp_theme_directories;

	if ( $stylesheet_or_template && ! $theme_root ) {
		$theme_root = get_raw_theme_root( $stylesheet_or_template );
	}

	if ( $stylesheet_or_template && $theme_root ) {
		if ( in_array( $theme_root, (array) $wp_theme_directories, true ) ) {
			// Absolute path. Make an educated guess. YMMV -- but note the filter below.
			if ( str_starts_with( $theme_root, WP_CONTENT_DIR ) ) {
				$theme_root_uri = content_url( str_replace( WP_CONTENT_DIR, '', $theme_root ) );
			} elseif ( str_starts_with( $theme_root, ABSPATH ) ) {
				$theme_root_uri = site_url( str_replace( ABSPATH, '', $theme_root ) );
			} elseif ( str_starts_with( $theme_root, WP_PLUGIN_DIR ) || str_starts_with( $theme_root, WPMU_PLUGIN_DIR ) ) {
				$theme_root_uri = plugins_url( basename( $theme_root ), $theme_root );
			} else {
				$theme_root_uri = $theme_root;
			}
		} else {
			$theme_root_uri = content_url( $theme_root );
		}
	} else {
		$theme_root_uri = content_url( 'themes' );
	}

	/**
	 * Filters the URI for themes directory.
	 *
	 * @since 1.5.0
	 *
	 * @param string $theme_root_uri         The URI for themes directory.
	 * @param string $siteurl                WordPress web address which is set in General Options.
	 * @param string $stylesheet_or_template The stylesheet or template name of the theme.
	 */
	return apply_filters( 'theme_root_uri', $theme_root_uri, get_option( 'siteurl' ), $stylesheet_or_template );
}

theme path (theme folder url)

Link (URL)

Theme files connection