get_theme()
云策文档标注
概述
get_theme() 函数用于检索指定主题的数据,但自 WordPress 3.4.0 起已被弃用,建议使用 wp_get_theme() 替代。
关键要点
- 函数已弃用:自 WordPress 3.4.0 版本起,get_theme() 被标记为弃用,推荐使用 wp_get_theme( $stylesheet ) 作为替代。
- 参数要求:接受一个必需参数 $theme,表示主题名称。
- 返回值:如果主题存在,返回主题数据数组;如果主题不存在,返回 null。
- 内部实现:通过调用 get_themes() 获取主题列表,并检查指定主题是否存在。
- 相关函数:涉及 get_themes() 和 _deprecated_function(),用于主题数据检索和弃用标记。
代码示例
function get_theme( $theme ) {
_deprecated_function( __FUNCTION__, '3.4.0', 'wp_get_theme( $stylesheet )' );
$themes = get_themes();
if ( is_array( $themes ) && array_key_exists( $theme, $themes ) )
return $themes[ $theme ];
return null;
}注意事项
- 弃用警告:使用此函数会触发 _deprecated_function() 警告,建议在开发中避免使用,以保持代码兼容性和最佳实践。
- 版本历史:函数在 WordPress 1.5.0 中引入,3.4.0 中弃用,开发者应更新代码以使用 wp_get_theme()。
原文内容
Retrieve theme data.
Description
See also
Parameters
$themestringrequired-
Theme name.
Source
function get_theme( $theme ) {
_deprecated_function( __FUNCTION__, '3.4.0', 'wp_get_theme( $stylesheet )' );
$themes = get_themes();
if ( is_array( $themes ) && array_key_exists( $theme, $themes ) )
return $themes[ $theme ];
return null;
}
Changelog
| Version | Description |
|---|---|
| 3.4.0 | Deprecated. Use wp_get_theme() |
| 1.5.0 | Introduced. |