dashboard_php_nag_class()
云策文档标注
概述
该函数用于在 WordPress 仪表板中,根据 PHP 版本的安全性状态,向 PHP 版本警告添加额外的 CSS 类。它通过检查 PHP 版本信息,动态修改 meta box 的类数组。
关键要点
- 函数名:dashboard_php_nag_class(),接受一个字符串数组参数 $classes,返回修改后的字符串数组。
- 核心逻辑:调用 wp_check_php_version() 获取 PHP 版本响应,根据响应中的 is_secure 和 is_lower_than_future_minimum 标志,添加相应的 CSS 类。
- 添加的类:如果 PHP 版本不安全,添加 'php-no-security-updates' 类;如果版本低于未来最低要求,添加 'php-version-lower-than-future-minimum' 类。
- 相关函数:依赖 wp_check_php_version() 来检查 PHP 版本状态。
- 版本历史:自 WordPress 5.1.0 版本引入。
代码示例
function dashboard_php_nag_class( $classes ) {
$response = wp_check_php_version();
if ( ! $response ) {
return $classes;
}
if ( isset( $response['is_secure'] ) && ! $response['is_secure'] ) {
$classes[] = 'php-no-security-updates';
} elseif ( $response['is_lower_than_future_minimum'] ) {
$classes[] = 'php-version-lower-than-future-minimum';
}
return $classes;
}
原文内容
Adds an additional class to the PHP nag if the current version is insecure.
Parameters
$classesstring[]required-
Array of meta box classes.
Source
function dashboard_php_nag_class( $classes ) {
$response = wp_check_php_version();
if ( ! $response ) {
return $classes;
}
if ( isset( $response['is_secure'] ) && ! $response['is_secure'] ) {
$classes[] = 'php-no-security-updates';
} elseif ( $response['is_lower_than_future_minimum'] ) {
$classes[] = 'php-version-lower-than-future-minimum';
}
return $classes;
}
Changelog
| Version | Description |
|---|---|
| 5.1.0 | Introduced. |