wp_get_theme() – Function | Developer.WordPress.org

Gets a WP_Theme object for a 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.

Source

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, true ) ) {
			$theme_root = WP_CONTENT_DIR . $theme_root;
		}
	}

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

View all references View on Trac View on GitHub

Uses	Description
get_raw_theme_root()`wp-includes/theme.php`	Gets the raw theme root relative to the content directory with no filters applied.
get_stylesheet()`wp-includes/theme.php`	Retrieves name of the current stylesheet.

Used by	Description
WP_REST_Templates_Controller::get_wp_templates_author_text_field()`wp-includes/rest-api/endpoints/class-wp-rest-templates-controller.php`	Returns a human readable text for the author of the template.
wp_get_theme_preview_path()`wp-includes/theme-previews.php`	Filters the blog option to return the path for the previewed theme.
_register_theme_block_patterns()`wp-includes/block-patterns.php`	Register any patterns that the active theme may provide under its `./patterns/` directory.
wp_is_block_theme()`wp-includes/theme.php`	Returns whether the active theme is a block-based theme or not.
WP_REST_Themes_Controller::get_item_permissions_check()`wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php`	Checks if a given request has access to read the theme.
WP_REST_Themes_Controller::get_item()`wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php`	Retrieves a single theme.
WP_REST_Themes_Controller::prepare_links()`wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php`	Prepares links for the request.
validate_theme_requirements()`wp-includes/theme.php`	Validates the theme requirements for WordPress version and PHP version.
populate_network_meta()`wp-admin/includes/schema.php`	Creates WordPress network meta and sets the default values.
WP_REST_Themes_Controller::get_items()`wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php`	Retrieves a collection of themes.
WP_REST_Themes_Controller::prepare_item_for_response()`wp-includes/rest-api/endpoints/class-wp-rest-themes-controller.php`	Prepares a single theme output for response.
WP_REST_Posts_Controller::check_template()`wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php`	Checks whether the template is valid for the given post.
WP_REST_Posts_Controller::handle_template()`wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php`	Sets the template for a post.
Theme_Upgrader::theme_info()`wp-admin/includes/class-theme-upgrader.php`	Gets the WP_Theme object for a theme.
Language_Pack_Upgrader::get_name_for_update()`wp-admin/includes/class-language-pack-upgrader.php`	Gets the name of an item being updated.
wp_prepare_themes_for_js()`wp-admin/includes/theme.php`	Prepares themes for JavaScript.
delete_theme()`wp-admin/includes/theme.php`	Removes a theme.
get_page_templates()`wp-admin/includes/theme.php`	Gets the page templates available in this theme.
WP_Theme_Install_List_Table::_get_theme_status()`wp-admin/includes/class-wp-theme-install-list-table.php`	Checks to see if the theme is already installed.
populate_options()`wp-admin/includes/schema.php`	Create WordPress options and set the default values.
update_right_now_message()`wp-admin/includes/update.php`	Displays WordPress version and active theme in the ‘At a Glance’ dashboard widget.
get_theme_updates()`wp-admin/includes/update.php`	Retrieves themes with updates available.
check_theme_switched()`wp-includes/theme.php`	Checks if a theme has been changed and runs ‘after_switch_theme’ hook on the next WP load.
remove_theme_mods()`wp-includes/theme.php`	Removes theme modifications option for the active theme.
switch_theme()`wp-includes/theme.php`	Switches the theme.
validate_current_theme()`wp-includes/theme.php`	Checks that the active theme has the required files.
get_theme_mods()`wp-includes/theme.php`	Retrieves all theme modifications.

Show 22 more Show less

Changelog

Version	Description
3.4.0	Introduced.

User Contributed Notes

Skip to note 11 content

Codex 10 years ago

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

tazotodua 7 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)

Skip to note 13 content

Codex 10 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note
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

vebbmaster 4 years ago

Switch a specific theme on all sites in a multisite installation

<?php
function wpdocs_switch_all_multisite_themes() {
    foreach ( get_sites() as $site ) {
        switch_to_blog( $site->blog_id );
	$blog_theme = wp_get_theme();
	if ( 'twentyeleven' === $blog_theme ) {
            switch_theme( 'twentytwenty' );
            restore_current_blog();
	}
    }
}

wpdocs_switch_all_multisite_themes();
?>

Alberuni Azad. 3 years ago

Get the directory name of the current theme regardless of the child theme.

function wpdocs_get_current_theme_directory(){
    $current_theme_dir  = '';
    $current_theme      = wp_get_theme();
    if( $current_theme->exists() && $current_theme->parent() ){
        $parent_theme = $current_theme->parent();

        if( $parent_theme->exists() ){
            $current_theme_dir = $parent_theme->get_stylesheet();
        }
    } elseif( $current_theme->exists() ) {
        $current_theme_dir = $current_theme->get_stylesheet();
    }

    return $current_theme_dir;
}

echo wpdocs_get_current_theme_directory();

Skip to note 16 content

Deepak Rajpal 1 year ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Code to Display current or any installed theme version:

Display current theme version:
```
$theme_info = wp_get_theme();
echo $theme_info->get( 'Version' );
```
Display any of installed theme version using directory name:
```
$theme_info = wp_get_theme( 'twentytwentyfour' );
echo $theme_info->get( 'Version' );
```
Log in to add feedback
Skip to note 17 content

Ben Sibley 4 months ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

As of WP 6.7, make sure not to call this function any earlier than the “init” hook, or it will trigger the following error:

PHP Notice: Function _load_textdomain_just_in_time was called incorrectly

Log in to add feedback
Skip to note 18 content

Codex 10 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: -2You must log in to vote on the helpfulness of this note
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 19 content

Codex 10 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: -4You must log in to vote on the helpfulness of this note
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' )
);
```
- This doesn’t work. You need to $my_theme = wp_get_theme() ; echo “; print_r($my_theme); echo “; To output the name and version, you need to do: echo $my_theme[‘Name’]; echo $my_theme[‘Version’];
  
  ashkanahmadi 5 years ago
Log in to add feedback
Skip to note 20 content

Codex 10 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: -8You must log in to vote on the helpfulness of this note
Echo the name of the current active theme
```
<?php
echo wp_get_theme();
?>
```
Log in to add feedback

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

In this article

Parameters

Return

Source

Changelog

User Contributed Notes

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

In this article

Parameters

Return

Source

Related

Changelog

User Contributed Notes