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

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: null

$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: null

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 = 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 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_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 26 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.

WordPress.org

Code Reference

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

Contents

Description Description

Parameters Parameters

Return Return

Source Source

Changelog Changelog

User Contributed Notes User Contributed Notes

WordPress.org

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

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

Description Description

Parameters Parameters

Return Return

Source Source

Changelog Changelog

Related Related

Uses Uses

Used By Used By

User Contributed Notes User Contributed Notes