site_health_test_rest_capability_{$check}
云策文档标注
概述
此文档介绍 WordPress 的 site_health_test_rest_capability_{$check} 过滤器,用于动态修改运行特定站点健康检查所需的用户权限。开发者可以通过此 Hook 自定义权限要求,增强安全性和灵活性。
关键要点
- 过滤器名称:site_health_test_rest_capability_{$check},其中 {$check} 是站点健康检查的标识符。
- 参数:$default_capability(默认权限字符串)和 $check(检查标识符字符串)。
- 用途:允许开发者覆盖默认权限,控制谁可以执行特定的站点健康检查。
- 相关函数:在 WP_REST_Site_Health_Controller::validate_request_permission() 中使用,用于验证 REST API 请求权限。
- 版本历史:从 WordPress 5.6.0 版本开始引入。
代码示例
$capability = apply_filters( "site_health_test_rest_capability_{$check}", $default_capability, $check );
原文内容
Filters the capability needed to run a given Site Health check.
Parameters
$default_capabilitystring-
The default capability required for this check.
$checkstring-
The Site Health check being performed.
Source
$capability = apply_filters( "site_health_test_rest_capability_{$check}", $default_capability, $check );
Changelog
| Version | Description |
|---|---|
| 5.6.0 | Introduced. |