函数文档

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.