钩子文档

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.