wp_get_theme( string $stylesheet = '', string $theme_root = '' ): WP_Theme

Parameters

$stylesheetstringoptional

Directory name for the theme. Defaults to active theme.Default: ''

$theme_rootstringoptional

Absolute path of the theme root to look in. If not specified, get_raw_theme_root() is used to calculate the theme root for the $stylesheet provided (or active theme).Default: ''

Return

WP_Theme

Theme object. Be sure to check the object's exists() method if you need to confirm the theme's existence.

Uses · 3

• get_stylesheet()Retrieves name of the current stylesheet.
• get_raw_theme_root()Gets the raw theme root relative to the content directory with no filters applied.
• WP_Theme::__construct()Constructor for WP_Theme.

Used by · 50

• Language_Pack_Upgrader::get_name_for_update()Gets the name of an item being updated.
• Theme_Upgrader::theme_info()Gets the WP_Theme object for a theme.
• Twenty_Twenty_One_Custom_Colors::editor_custom_color_variables()Editor custom color variables.
• Twenty_Twenty_One_Customize_Color_Control::enqueue()Enqueues control related scripts/styles.
• Twenty_Twenty_One_Dark_Mode::customize_controls_enqueue_scripts()Enqueues scripts for the customizer.
• Twenty_Twenty_One_Dark_Mode::editor_custom_color_variables()Enqueues editor custom color variables & scripts.
• Twenty_Twenty_One_Dark_Mode::enqueue_scripts()Enqueues scripts and styles.
• WP_Automatic_Updater::update()Updates an item, if appropriate.
• WP_Customize_Manager::__construct()Constructor.
• WP_Customize_Manager::theme()Gets the theme being customized.
• WP_Debug_Data::get_wp_active_theme()Gets the WordPress active theme section of the debug data.
• WP_Debug_Data::get_wp_parent_theme()Gets the WordPress parent theme section of the debug data.

Source

View on Trac ↗View on GitHub ↗

117function wp_get_theme( $stylesheet = '', $theme_root = '' ) {118	global $wp_theme_directories;119 120	if ( empty( $stylesheet ) ) {121		$stylesheet = get_stylesheet();122	}123 124	if ( empty( $theme_root ) ) {125		$theme_root = get_raw_theme_root( $stylesheet );126		if ( false === $theme_root ) {127			$theme_root = WP_CONTENT_DIR . '/themes';128		} elseif ( ! in_array( $theme_root, (array) $wp_theme_directories, true ) ) {129			$theme_root = WP_CONTENT_DIR . $theme_root;130		}131	}132 133	return new WP_Theme( $stylesheet, $theme_root );134}

History

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