upgrader_pre_download
云策文档标注
概述
upgrader_pre_download 是一个 WordPress 过滤器钩子,用于控制是否在下载包之前返回包文件。它允许开发者在下载过程中进行干预,例如基于条件阻止下载。
关键要点
- 这是一个过滤器钩子,用于在 WP_Upgrader 下载包之前决定是否返回包文件。
- 参数包括 $reply(布尔值,默认 false 表示继续下载)、$package(包文件名)、$upgrader(WP_Upgrader 实例)和 $hook_extra(额外参数数组)。
- 从 WordPress 5.5.0 版本开始添加了 $hook_extra 参数,最初在 3.7.0 版本引入。
- 常用于 WP_Upgrader::download_package() 方法中,开发者可以挂钩此过滤器以自定义下载逻辑。
原文内容
Filters whether to return the package.
Parameters
$replybool-
Whether to bail without returning the package.
Default false. $packagestring-
The package file name.
$upgraderWP_Upgrader-
The WP_Upgrader instance.
$hook_extraarray-
Extra arguments passed to hooked filters.
Source
$reply = apply_filters( 'upgrader_pre_download', false, $package, $this, $hook_extra );