钩子文档

validate_theme_requirements

💡 云策文档标注

概述

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

关键要点

  • 过滤器名称:validate_theme_requirements
  • 用途:过滤主题需求验证的响应,支持添加自定义验证逻辑
  • 触发条件:仅在主题通过核心验证(如 WordPress 和 PHP 版本兼容性)后触发,否则返回 WP_Error
  • 参数:$met_requirements(布尔值或 WP_Error,表示验证结果)和 $stylesheet(字符串,主题目录名)
  • 相关函数:validate_theme_requirements() 用于验证主题的 WordPress 和 PHP 版本需求
  • 引入版本:WordPress 6.9.0

代码示例

return apply_filters( 'validate_theme_requirements', true, $stylesheet );

注意事项

此过滤器不会在核心验证失败时触发,因为此时已返回 WP_Error。它主要用于扩展验证过程,而非替代核心验证。


📄 原文内容

Filters the theme requirement validation response.

Description

If a theme 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 theme meets requirements, WP_Error if not.
$stylesheetstring
Directory name for the theme.

Source

return apply_filters( 'validate_theme_requirements', true, $stylesheet );

Changelog

Version Description
6.9.0 Introduced.