get_theme_root() – Function | Developer.WordPress.org

Retrieves path to themes directory.

Description

Does not have trailing slash.

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.

Source

function get_theme_root( $stylesheet_or_template = '' ) {
	global $wp_theme_directories;

	$theme_root = '';

	if ( $stylesheet_or_template ) {
		$theme_root = get_raw_theme_root( $stylesheet_or_template );
		if ( $theme_root ) {
			/*
			 * Always prepend WP_CONTENT_DIR unless the root currently registered as a theme directory.
			 * This gives relative theme roots the benefit of the doubt when things go haywire.
			 */
			if ( ! in_array( $theme_root, (array) $wp_theme_directories, true ) ) {
				$theme_root = WP_CONTENT_DIR . $theme_root;
			}
		}
	}

	if ( ! $theme_root ) {
		$theme_root = WP_CONTENT_DIR . '/themes';
	}

	/**
	 * Filters the absolute path to the themes directory.
	 *
	 * @since 1.5.0
	 *
	 * @param string $theme_root Absolute path to themes directory.
	 */
	return apply_filters( 'theme_root', $theme_root );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘theme_root’, string $theme_root ): Filters the absolute path to the themes directory.

Uses	Description
get_raw_theme_root()`wp-includes/theme.php`	Gets the raw theme root relative to the content directory with no filters applied.
apply_filters()`wp-includes/plugin.php`	Calls the callback functions that have been added to a filter hook.

Used by	Description
WP_Automatic_Updater::update()`wp-admin/includes/class-wp-automatic-updater.php`	Updates an item, if appropriate.
Theme_Upgrader::check_parent_theme_filter()`wp-admin/includes/class-theme-upgrader.php`	Checks if a child theme is being installed and its parent also needs to be installed.
Theme_Upgrader::install()`wp-admin/includes/class-theme-upgrader.php`	Install a theme package.
Theme_Upgrader::upgrade()`wp-admin/includes/class-theme-upgrader.php`	Upgrades a theme.
Theme_Upgrader::bulk_upgrade()`wp-admin/includes/class-theme-upgrader.php`	Upgrades several themes at once.
WP_Upgrader::fs_connect()`wp-admin/includes/class-wp-upgrader.php`	Connects to the filesystem.
WP_Filesystem_Base::wp_themes_dir()`wp-admin/includes/class-wp-filesystem-base.php`	Returns the path on the remote filesystem of the Themes Directory.
get_stylesheet_directory()`wp-includes/theme.php`	Retrieves stylesheet directory path for the active theme.
get_template_directory()`wp-includes/theme.php`	Retrieves template directory path for the active theme.

Show 4 more Show less

Changelog

Version	Description
1.5.0	Introduced.

User Contributed Notes

Skip to note 2 content

Codex 10 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: -1You must log in to vote on the helpfulness of this note
Number of Subdirectories in Themes Directory
The function below informs about the number of subdirectories in the themes directory. Note that this doesn’t necessarily match the number of themes recognized by WordPress.
```
<?php
function display_themes_subdirs_count_info()
  $theme_root = get_theme_root();
  $files_array = glob("$theme_root/*", GLOB_ONLYDIR);
  echo "There are " . count($files_array) . " subdirectories in the " . $theme_root . " directory"; 
}
?>
```
Example output:

There are 5 subdirectories in the /home/user/public_html/wp-content/themes directory.
Log in to add feedback

get_theme_root( string $stylesheet_or_template = '' ): string

In this article

Description

Parameters

Return

Source

Hooks

Changelog

User Contributed Notes