显示add_settings_error()注册的设置错误。

原型

settings_errors( string $setting = '', bool $sanitize = false, bool $hide_on_update = false )

描述

Settings API的一部分。为get_settings_errors()检索的每个错误输出一个div。

参数

$setting (string) (Optional) slug标题的特定设置谁是你想要的错误。

$sanitize (bool) (Optional) 是否在返回错误之前重新清理设置值。

$hide_on_update (bool) (Optional) 如果设置为true,则如果已提交设置页面,则不会显示错误。

源文件

路径:wp-admin/includes/template.php

<?php
...
function settings_errors( $setting = '', $sanitize = false, $hide_on_update = false ) {
	if ( $hide_on_update && ! empty( $_GET['settings-updated'] ) )
		return;
	$settings_errors = get_settings_errors( $setting, $sanitize );
	if ( empty( $settings_errors ) )
		return;
	$output = '';
	foreach ( $settings_errors as $key => $details ) {
		$css_id = 'setting-error-' . $details['code'];
		$css_class = $details['type'] . ' settings-error notice is-dismissible';
		$output .= "<div id='$css_id' class='$css_class'> n";
		$output .= "<p><strong>{$details['message']}</strong></p>";
		$output .= "</div> n";
	}
	echo $output;
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/settings_errors/