wp_update_theme()
云策文档标注
概述
wp_update_theme() 是一个已弃用的 WordPress 函数,用于启动主题更新。自 3.7.0 版本起,建议直接实例化 Theme_Upgrader 类并调用其 'upgrade' 方法。
关键要点
- wp_update_theme() 函数已弃用,自 3.7.0 版本起不再推荐使用。
- 替代方案是直接创建 Theme_Upgrader 实例并调用其 upgrade 方法。
- 该函数自 2.8.0 版本起已不再使用,相关功能已迁移到 Theme_Upgrader 类。
代码示例
function wp_update_theme($theme, $feedback = '') {
_deprecated_function( __FUNCTION__, '3.7.0', 'new Theme_Upgrader();' );
if ( !empty($feedback) )
add_filter('update_feedback', $feedback);
require ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';
$upgrader = new Theme_Upgrader();
return $upgrader->upgrade($theme);
}注意事项
- 使用 wp_update_theme() 会触发 _deprecated_function() 警告,提示开发者改用 Theme_Upgrader。
- 函数参数包括 $theme(主题标识)和可选的 $feedback(回调函数),后者可通过 add_filter 添加到 'update_feedback' 钩子。
- 相关函数包括 _deprecated_function() 和 add_filter(),用于处理弃用通知和过滤器添加。
原文内容
This was once used to kick-off the Theme Updater.
Description
Deprecated in favor of instantiating a Theme_Upgrader instance directly, and calling the ‘upgrade’ method.
Unused since 2.8.0.
See also
Source
function wp_update_theme($theme, $feedback = '') {
_deprecated_function( __FUNCTION__, '3.7.0', 'new Theme_Upgrader();' );
if ( !empty($feedback) )
add_filter('update_feedback', $feedback);
require ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';
$upgrader = new Theme_Upgrader();
return $upgrader->upgrade($theme);
}
Changelog
| Version | Description |
|---|---|
| 3.7.0 | Deprecated. Use Theme_Upgrader |
| 2.7.0 | Introduced. |