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

Gets a WP_Theme object for a theme.

Description
- Parameters
- Return
- Source
- Changelog
Related
- Uses
- Used By
User Contributed Notes

Description Description

Parameters Parameters

$stylesheet

(string) (Optional) Directory name for the theme. Optional. Defaults to current theme.

Default value: ''

$theme_root

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

Default value: ''

Top ↑

Return Return

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

Top ↑

Source Source

File: wp-includes/theme.php

function wp_get_theme( $stylesheet = '', $theme_root = '' ) {
	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 full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version	Description
3.4.0	Introduced.

Top ↑

Uses Uses

Uses
Uses	Description
wp-includes/theme.php: get_raw_theme_root()	Get the raw theme root relative to the content directory with no filters applied.
wp-includes/theme.php: get_stylesheet()	Retrieve name of the current stylesheet.
wp-includes/class-wp-theme.php: WP_Theme::__construct()	Constructor for WP_Theme.

Top ↑

Used By Used By

Used By
Used By	Description
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/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-admin/includes/class-wp-debug-data.php: WP_Debug_Data::debug_data()	Static function for generating site debug data when required.
wp-admin/includes/class-wp-site-health.php: WP_Site_Health::get_test_theme_version()	Test if themes are outdated, or unnecessary.
wp-admin/includes/schema.php: populate_network_meta()	Creates WordPress network meta and sets the default values.
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-posts-controller.php: WP_REST_Posts_Controller::check_template()	Check whether the template is valid for the given post.
wp-admin/includes/file.php: wp_edit_theme_plugin_file()	Attempt to edit a file for a theme or plugin.
wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php: WP_REST_Posts_Controller::handle_template()	Sets the template for a post.
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-includes/class-wp-theme.php: WP_Theme::get_core_default_theme()	Determines the latest WordPress default theme that is installed.
wp-admin/includes/class-wp-automatic-updater.php: WP_Automatic_Updater::update()	Update an item, if appropriate.
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/class-theme-upgrader.php: Theme_Upgrader::theme_info()	Get the WP_Theme object for a theme.
wp-admin/includes/theme.php: wp_prepare_themes_for_js()	Prepare themes for JavaScript.
wp-admin/includes/theme.php: get_page_templates()	Get the Page Templates available in this theme
wp-admin/includes/deprecated.php: current_theme_info()	Retrieves information on the current active theme.
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/schema.php: populate_options()	Create WordPress options and set the default values.
wp-admin/includes/update.php: update_right_now_message()
wp-admin/includes/update.php: get_theme_updates()
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::theme()	Get the theme being customized.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::__construct()	Constructor.
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: remove_theme_mods()	Remove theme modifications option for current theme.
wp-includes/theme.php: switch_theme()	Switches the theme.
wp-includes/theme.php: validate_current_theme()	Checks that current theme files ‘index.php’ and ‘style.css’ exists.
wp-includes/theme.php: get_theme_mods()	Retrieve all theme modifications.
wp-includes/deprecated.php: get_current_theme()	Retrieve current theme name.
wp-includes/post.php: wp_insert_post()	Insert or update a post.

Show 27 more used by Hide more used by

Top ↑

User Contributed Notes User Contributed Notes

Skip to note 1 content
You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note

Contributed by Codex — 4 years ago
Echo the name of an installed theme
```
<?php
$my_theme = wp_get_theme( 'twentytwelve' );
if ( $my_theme->exists() )
	echo esc_html( $my_theme );
?>
```
Log in to add feedback

Contributed by tazotodua — 2 years ago

Result:

object(WP_Theme)[916]
  public 'update' => boolean false
  private 'theme_root' => string 'home/path/wp-content/themes' (length=77)
  private 'headers' => 
    array (size=11)
      'Name' => string 'mytheme' (length=7)
      'ThemeURI' => string 'http://example.com/' (length=22)
      'Description' => string 'Description' (length=11)
      'Author' => string 'Something Here' (length=14)
      'AuthorURI' => string 'http://example.com/' (length=22)
      'Version' => string '1.0.0' (length=5)
      'Template' => string '' (length=0)
      'Status' => string '' (length=0)
      'Tags' => string 'custom-background, custom-logo, custom-menu, featured-images, threaded-comments, translation-ready' (length=98)
      'TextDomain' => string 'mytheme' (length=7)
      'DomainPath' => string '' (length=0)
  private 'headers_sanitized' => null
  private 'name_translated' => null
  private 'errors' => null
  private 'stylesheet' => string 'mytheme' (length=7)
  private 'template' => string 'mytheme' (length=7)
  private 'parent' => null
  private 'theme_root_uri' => null
  private 'textdomain_loaded' => null
  private 'cache_hash' => string 'ca9dd01f01f2a5cb4616a776eff52690' (length=32)

Expand full source code Collapse full source code

Skip to note 3 content
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

Contributed by Codex — 4 years ago
Get other data: Text domain & theme URI
```
<?php
$my_theme = wp_get_theme();
echo esc_html( $my_theme->get( 'TextDomain' ) );
echo esc_html( $my_theme->get( 'ThemeURI' ) );
?>
```
Log in to add feedback
Skip to note 4 content
You must log in to vote on the helpfulness of this noteVote results for this note: -3You must log in to vote on the helpfulness of this note

Contributed by Codex — 4 years ago
Display the current theme author URI
```
$my_theme = wp_get_theme();
echo esc_html( $my_theme->get( 'AuthorURI' ) );
```
Log in to add feedback
Skip to note 5 content
You must log in to vote on the helpfulness of this noteVote results for this note: -5You must log in to vote on the helpfulness of this note

Contributed by Codex — 4 years ago
Echo the name of the current active theme
```
<?php
echo wp_get_theme();
?>
```
Log in to add feedback
Skip to note 6 content
You must log in to vote on the helpfulness of this noteVote results for this note: -5You must log in to vote on the helpfulness of this note

Contributed by Codex — 4 years ago
Display the current theme’s version
```
$my_theme = wp_get_theme();
printf( "%1$s is version %2$s",
	$my_theme->get( 'Name' ),
	$my_theme->get( 'Version' )
);
```
Log in to add feedback

You must log in before being able to contribute a note or feedback.

wp_get_theme

WordPress Web Application Development

WordPress Themes

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

Contents

Description Description

Parameters Parameters

Return Return

Source Source

Changelog Changelog

User Contributed Notes User Contributed Notes

Keep Leading Your Followers!
Share it for them.

wp_get_theme

WordPress Web Application Development

WordPress Themes

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

Contents

Description #Description

Parameters #Parameters

Return #Return

Source #Source

Changelog #Changelog

Related #Related

Uses #Uses

Used By #Used By

User Contributed Notes #User Contributed Notes

Keep Leading Your Followers!Share it for them.

Description Description

Parameters Parameters

Return Return

Source Source

Changelog Changelog

Related Related

Uses Uses

Used By Used By

User Contributed Notes User Contributed Notes

Keep Leading Your Followers!
Share it for them.