WordPress获取主题信息函数wp_get_theme详解

创客云

WordPress主题信息在开发主题时可能会用到,一般是在主题的更新功能时使用。wp_get_theme函数可以直接得到当前启用的主题或者指定的主题信息,包括版本作者路径等。就主题更新功能而言,开发者只需要判断返回的主题对象中版本号是否小于最新版本号即可确定是否更新。比如国内著名主题DUX就使用了这个方法来实现主题的更新功能,下面看看官方对这个函数的介绍及使用。

函数构造

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

函数原型:

  1. function wp_get_theme( $stylesheet = null, $theme_root = null ) {
  2.     global $wp_theme_directories;
  3.  
  4.     if ( empty( $stylesheet ) ) {
  5.         $stylesheet = get_stylesheet();
  6.     }
  7.  
  8.     if ( empty( $theme_root ) ) {
  9.         $theme_root = get_raw_theme_root( $stylesheet );
  10.         if ( false === $theme_root ) {
  11.             $theme_root = WP_CONTENT_DIR . '/themes';
  12.         } elseif ( ! in_array( $theme_root, (array) $wp_theme_directories ) ) {
  13.             $theme_root = WP_CONTENT_DIR . $theme_root;
  14.         }
  15.     }
  16.  
  17.     return new WP_Theme( $stylesheet, $theme_root );
  18. }

描述:获得当前主题或指定主题的信息。

参数:

$stylesheet

(string) (可选) 指定的主题名,默认当前主题。

默认值: 空

$theme_root

(string) (可选) 主题的绝对路径,如果为空, 则使用get_raw_theme_root()函数得到的路径 (默认当前主题).

默认值: 空

返回值

(WP_Theme) 主题对象。 如果不知道主题是否存在,请使用主题对象的exists()方法判断。

简单使用

  1. <?php 
  2. $my_theme = wp_get_theme( 'twentytwelve' );
  3. if ( $my_theme->exists() )
  4.     echo esc_html( $my_theme );
  5. ?>

结果:

  1. object(WP_Theme)[916]
  2.   public 'update' => boolean false
  3.   private 'theme_root' => string 'home/path/wp-content/themes' (length=77)
  4.   private 'headers' => 
  5.     array (size=11)
  6.       'Name' => string 'mytheme' (length=7)
  7.       'ThemeURI' => string 'http://example.com/' (length=22)
  8.       'Description' => string 'Description' (length=11)
  9.       'Author' => string 'Something Here' (length=14)
  10.       'AuthorURI' => string 'http://example.com/' (length=22)
  11.       'Version' => string '1.0.0' (length=5)
  12.       'Template' => string '' (length=0)
  13.       'Status' => string '' (length=0)
  14.       'Tags' => string 'custom-background, custom-logo, custom-menu, featured-images, threaded-comments, translation-ready' (length=98)
  15.       'TextDomain' => string 'mytheme' (length=7)
  16.       'DomainPath' => string '' (length=0)
  17.   private 'headers_sanitized' => null
  18.   private 'name_translated' => null
  19.   private 'errors' => null
  20.   private 'stylesheet' => string 'mytheme' (length=7)
  21.   private 'template' => string 'mytheme' (length=7)
  22.   private 'parent' => null
  23.   private 'theme_root_uri' => null
  24.   private 'textdomain_loaded' => null
  25.   private 'cache_hash' => string 'ca9dd01f01f2a5cb4616a776eff52690' (length=32)
本文来源代码狗,经授权后由CityMall发布,观点不代表创客云的立场,转载请联系原作者。
云模板

发表评论