get_theme_root( string $stylesheet_or_template = '' ): string

Description

Parameters

$stylesheet_or_templatestringoptional

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

Return

string

Themes directory path.

Hooks fired · 1

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

1. 1
   apply_filters( theme_root )filterline 629 (+29 into the body)

   Filters the absolute path to the themes directory.

Uses · 2

• get_raw_theme_root()Gets the raw theme root relative to the content directory with no filters applied.
• apply_filters()Calls the callback functions that have been added to a filter hook.

Used by · 13

• Theme_Upgrader::bulk_upgrade()Upgrades several themes at once.
• Theme_Upgrader::check_parent_theme_filter()Checks if a child theme is being installed and its parent also needs to be installed.
• Theme_Upgrader::install()Install a theme package.
• Theme_Upgrader::upgrade()Upgrades a theme.
• WP_Automatic_Updater::update()Updates an item, if appropriate.
• WP_Debug_Data::get_sizes()Fetches the sizes of the WordPress directories: `wordpress` (ABSPATH), `plugins`, `themes`, and `uploads`.
• WP_Debug_Data::get_wp_filesystem()Gets the file system section of the debug data.
• WP_Debug_Data::get_wp_paths_sizes()Gets the WordPress paths and sizes section of the debug data.
• WP_Filesystem_Base::wp_themes_dir()Returns the path on the remote filesystem of the Themes Directory.
• WP_Upgrader::fs_connect()Connects to the filesystem.
• _load_script_textdomain_from_src()Resolves and loads the translation JSON file for a given script or script module source URL.
• get_stylesheet_directory()Retrieves stylesheet directory path for the active theme.

Source

View on Trac ↗View on GitHub ↗

600function get_theme_root( $stylesheet_or_template = '' ) {601	global $wp_theme_directories;602 603	$theme_root = '';604 605	if ( $stylesheet_or_template ) {606		$theme_root = get_raw_theme_root( $stylesheet_or_template );607		if ( $theme_root ) {608			/*609			 * Always prepend WP_CONTENT_DIR unless the root currently registered as a theme directory.610			 * This gives relative theme roots the benefit of the doubt when things go haywire.611			 */612			if ( ! in_array( $theme_root, (array) $wp_theme_directories, true ) ) {613				$theme_root = WP_CONTENT_DIR . $theme_root;614			}615		}616	}617 618	if ( ! $theme_root ) {619		$theme_root = WP_CONTENT_DIR . '/themes';620	}621 622	/**623	 * Filters the absolute path to the themes directory.624	 *625	 * @since 1.5.0626	 *627	 * @param string $theme_root Absolute path to themes directory.628	 */629	return apply_filters( 'theme_root', $theme_root );630}

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.