函数文档

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.

Return

string[] Modified 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.