get_theme_root_uri( string $stylesheet_or_template = '', string $theme_root = '' ): string

Description

Parameters

$stylesheet_or_templatestringoptional

The stylesheet or template name of the theme. Default is to leverage the main theme root.Default: ''

$theme_rootstringoptional

The theme root for which calculations will be based, preventing the need for a get_raw_theme_root() call. Default empty.Default: ''

Return

string

Themes directory URI.

Hooks fired · 1

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

1. 1
   apply_filters( theme_root_uri )filterline 682 (+35 into the body)

   Filters the URI for themes directory.

Uses · 7

• get_raw_theme_root()Gets the raw theme root relative to the content directory with no filters applied.
• str_starts_with()Polyfill for `str_starts_with()` function added in PHP 8.0.
• content_url()Retrieves the URL to the content directory.
• site_url()Retrieves the URL for the current site where WordPress application files (e.g. wp-blog-header.php or the wp-admin/ folder) are accessible.
• plugins_url()Retrieves a URL within the plugins or mu-plugins directory.
• apply_filters()Calls the callback functions that have been added to a filter hook.
• get_option()Retrieves an option value based on an option name.

Used by · 3

• WP_Theme::get_theme_root_uri()Returns the URL to the directory of the theme root.
• get_stylesheet_directory_uri()Retrieves stylesheet directory URI for the active theme.
• get_template_directory_uri()Retrieves template directory URI for the active theme.

Source

View on Trac ↗View on GitHub ↗

647function get_theme_root_uri( $stylesheet_or_template = '', $theme_root = '' ) {648	global $wp_theme_directories;649 650	if ( $stylesheet_or_template && ! $theme_root ) {651		$theme_root = get_raw_theme_root( $stylesheet_or_template );652	}653 654	if ( $stylesheet_or_template && $theme_root ) {655		if ( in_array( $theme_root, (array) $wp_theme_directories, true ) ) {656			// Absolute path. Make an educated guess. YMMV -- but note the filter below.657			if ( str_starts_with( $theme_root, WP_CONTENT_DIR ) ) {658				$theme_root_uri = content_url( str_replace( WP_CONTENT_DIR, '', $theme_root ) );659			} elseif ( str_starts_with( $theme_root, ABSPATH ) ) {660				$theme_root_uri = site_url( str_replace( ABSPATH, '', $theme_root ) );661			} elseif ( str_starts_with( $theme_root, WP_PLUGIN_DIR ) || str_starts_with( $theme_root, WPMU_PLUGIN_DIR ) ) {662				$theme_root_uri = plugins_url( basename( $theme_root ), $theme_root );663			} else {664				$theme_root_uri = $theme_root;665			}666		} else {667			$theme_root_uri = content_url( $theme_root );668		}669	} else {670		$theme_root_uri = content_url( 'themes' );671	}672 673	/**674	 * Filters the URI for themes directory.675	 *676	 * @since 1.5.0677	 *678	 * @param string $theme_root_uri         The URI for themes directory.679	 * @param string $siteurl                WordPress web address which is set in General Options.680	 * @param string $stylesheet_or_template The stylesheet or template name of the theme.681	 */682	return apply_filters( 'theme_root_uri', $theme_root_uri, get_option( 'siteurl' ), $stylesheet_or_template );683}

History

Introduced in 1.5.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/theme.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.