显示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/