函数文档

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.

Return

array|null Null, if theme name does not exist. Theme data, if exists.

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.