钩子文档

install_plugin_overwrite_actions

💡 云策文档标注

概述

install_plugin_overwrite_actions 是一个 WordPress 过滤器钩子,用于在允许覆盖安装时,过滤单个插件安装失败后显示的操作链接列表。它允许开发者自定义这些链接,例如添加或移除选项。

关键要点

  • 这是一个过滤器钩子,用于修改插件安装失败后的操作链接。
  • 主要应用于允许覆盖安装的场景,例如通过上传新版本插件。
  • 参数包括 $install_actions(操作链接数组)、$api(WordPress.org API 数据对象)和 $new_plugin_data(上传插件数据数组)。
  • 在 WordPress 5.5.0 版本中引入。

注意事项

  • 此钩子仅在插件安装失败且允许覆盖时触发,需确保使用场景正确。
  • 修改 $install_actions 数组时,应保持链接格式和功能一致性,避免破坏用户界面。

📄 原文内容

Filters the list of action links available following a single plugin installation failure when overwriting is allowed.

Parameters

$install_actionsstring[]
Array of plugin action links.
$apiobject
Object containing WordPress.org API plugin data.
$new_plugin_dataarray
Array with uploaded plugin data.

Source

$install_actions = apply_filters( 'install_plugin_overwrite_actions', $install_actions, $this->api, $new_plugin_data );

Changelog

Version Description
5.5.0 Introduced.