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

Gets a WP_Theme object for a theme.

Parameters

$stylesheet

(Optional) Directory name for the theme. Defaults to active theme.

Default value: ''

$theme_root

(Optional) Absolute path of the theme root to look in.<br> If not specified, get_raw_theme_root() is used to calculate the theme root for the $stylesheet provided (or active theme).

Default value: ''

Return

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

Source

File: wp-includes/theme.php 

function wp_get_theme( $stylesheet = null, $theme_root = null ) {
	global $wp_theme_directories;

	if ( empty( $stylesheet ) )
		$stylesheet = get_stylesheet();

	if ( empty( $theme_root ) ) {
		$theme_root = get_raw_theme_root( $stylesheet );
		if ( false === $theme_root )
			$theme_root = WP_CONTENT_DIR . '/themes';
		elseif ( ! in_array( $theme_root, (array) $wp_theme_directories ) )
			$theme_root = WP_CONTENT_DIR . $theme_root;
	}

	return new WP_Theme( $stylesheet, $theme_root );
}

Expand Source Code View on GitHub

Related

Used By

Used By
Used By Description
wp-admin/includes/class-wp-site-health.php: WP_Site_Health::get_test_theme_version()

Tests if themes are outdated, or unnecessary.
wp-admin/includes/class-wp-debug-data.php: WP_Debug_Data::debug_data()

Static function for generating site debug data when required.
wp-admin/includes/schema.php: populate_network_meta()

Creates WordPress network meta and sets the default values.
wp-includes/class-wp-recovery-mode-email-service.php: WP_Recovery_Mode_Email_Service::get_cause()

Gets the description indicating the possible cause for the error.
wp-includes/class-wp-recovery-mode-email-service.php: WP_Recovery_Mode_Email_Service::get_debug()

Return debug information in an easy to manipulate format.
wp-includes/classicpress/class-wp-compat.php: WP_Compat::using_block_function_theme()

Action hooked to admin_notices to display an admin notice on themes page.
wp-includes/rest-api/class-wp-rest-server.php: WP_REST_Server::add_active_theme_link_to_index()

Adds a link to the active theme for users who have proper permissions.
wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php: WP_REST_Themes_Controller::get_item_permissions_check()

Checks if a given request has access to read the theme.
wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php: WP_REST_Themes_Controller::get_item()

Retrieves a single theme.
wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php: WP_REST_Themes_Controller::get_items()

Retrieves a collection of themes.
wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php: WP_REST_Themes_Controller::prepare_item_for_response()

Prepares a single theme output for response.
wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php: WP_REST_Themes_Controller::prepare_links()

Prepares links for the request.
wp-includes/theme.php: validate_theme_requirements()

Validates the theme requirements for WordPress version and PHP version.
wp-includes/deprecated.php: get_current_theme()

Retrieve current theme name.
wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php: WP_REST_Posts_Controller::check_template()

Checks whether the template is valid for the given post.
wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php: WP_REST_Posts_Controller::handle_template()

Sets the template for a post.
wp-includes/class-wp-theme.php: WP_Theme::get_core_default_theme()

Determines the latest WordPress default theme that is installed.
wp-includes/theme.php: check_theme_switched()

Checks if a theme has been changed and runs ‘after_switch_theme’ hook on the next WP load.
wp-includes/theme.php: validate_current_theme()

Checks that the active theme has the required files.
wp-includes/theme.php: get_theme_mods()

Retrieves all theme modifications.
wp-includes/theme.php: remove_theme_mods()

Removes theme modifications option for the active theme.
wp-includes/theme.php: switch_theme()

Switches the theme.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::__construct()

Constructor.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::theme()

Gets the theme being customized.
wp-includes/post.php: wp_insert_post()

Inserts or update a post.
wp-admin/includes/deprecated.php: current_theme_info()

Retrieves information on the current active theme.
wp-admin/includes/schema.php: populate_options()

Create WordPress options and set the default values.
wp-admin/includes/class-theme-upgrader.php: Theme_Upgrader::theme_info()

Get the WP_Theme object for a theme.
wp-admin/includes/ajax-actions.php: wp_ajax_install_theme()

Ajax handler for installing a theme.
wp-admin/includes/ajax-actions.php: wp_ajax_update_theme()

Ajax handler for updating a theme.
wp-admin/includes/ajax-actions.php: wp_ajax_delete_theme()

Ajax handler for deleting a theme.
wp-admin/includes/class-wp-automatic-updater.php: WP_Automatic_Updater::update()

Updates an item, if appropriate.
wp-admin/includes/theme.php: get_page_templates()

Gets the page templates available in this theme.
wp-admin/includes/theme.php: wp_prepare_themes_for_js()

Prepares themes for JavaScript.
wp-admin/includes/class-language-pack-upgrader.php: Language_Pack_Upgrader::get_name_for_update()

Get the name of an item being updated.
wp-admin/includes/file.php: wp_edit_theme_plugin_file()

Attempts to edit a file for a theme or plugin.
wp-admin/includes/class-wp-theme-install-list-table.php: WP_Theme_Install_List_Table::_get_theme_status()

Check to see if the theme is already installed.
wp-admin/includes/update.php: get_theme_updates()

Retrieves themes with updates available.
wp-admin/includes/update.php: update_right_now_message()

Displays WordPress version and active theme in the ‘At a Glance’ dashboard widget.
Show 34 more used by Hide more used by

Changelog

Changelog
Version Description
3.4.0 Introduced.