钩子文档

upgrader_overwrote_package

💡 云策文档标注

概述

upgrader_overwrote_package 是一个 WordPress 动作钩子,在升级器成功用上传的 ZIP 包覆盖已安装的插件或主题时触发。它主要用于开发者监听插件或主题的覆盖安装事件。

关键要点

  • 触发时机:当 upgrader 成功用上传的 ZIP 包覆盖当前已安装的插件或主题时触发。
  • 参数:$package(包文件路径)、$data(新插件或主题的数据数组)、$package_type(包类型,如 'plugin' 或 'theme')。
  • 相关函数:Theme_Upgrader::install() 和 Plugin_Upgrader::install() 使用此钩子。
  • 版本历史:从 WordPress 5.5.0 版本引入。

代码示例

do_action( 'upgrader_overwrote_package', $package, $this->new_plugin_data, 'plugin' );

📄 原文内容

Fires when the upgrader has successfully overwritten a currently installed plugin or theme with an uploaded zip package.

Parameters

$packagestring
The package file.
$dataarray
The new plugin or theme data.
$package_typestring
The package type ('plugin' or 'theme').

Source

do_action( 'upgrader_overwrote_package', $package, $this->new_plugin_data, 'plugin' );

Changelog

Version Description
5.5.0 Introduced.