钩子文档

validate_plugin_requirements

💡 云策文档标注

概述

validate_plugin_requirements 是一个 WordPress 过滤器,用于自定义插件需求验证的响应。它允许站点管理员添加额外的验证步骤,但不会在核心验证失败时触发。

关键要点

  • 过滤器名称:validate_plugin_requirements
  • 参数:$met_requirements(bool 或 WP_Error,表示插件是否满足需求)和 $plugin(字符串,插件文件路径)
  • 用途:扩展插件验证逻辑,例如添加自定义检查
  • 限制:当插件因 WordPress 或 PHP 版本不兼容等核心验证失败时,此过滤器不会触发
  • 相关函数:validate_plugin_requirements() 位于 wp-admin/includes/plugin.php
  • 引入版本:WordPress 6.9.0

📄 原文内容

Filters the plugin requirement validation response.

Description

If a plugin fails due to a Core-provided validation (incompatible WP, PHP versions), this filter will not fire. A WP_Error response will already be returned.

This filter is intended to add additional validation steps by site administrators.

Parameters

$met_requirementsbool|WP_Error
True if the plugin meets requirements, WP_Error if not.
$pluginstring
Path to the plugin file relative to the plugins directory.

Source

return apply_filters( 'validate_plugin_requirements', true, $plugin );

Changelog

Version Description
6.9.0 Introduced.