add_settings_error

函式
add_settings_error ( $setting, $code, $message, $type = 'error' )
引數
  • (string) $setting Slug title of the setting to which this error applies.
    Required:
  • (string) $code Slug-name to identify the error. Used as part of 'id' attribute in HTML output.
    Required:
  • (string) $message The formatted message text to display to the user (will be shown inside styled `<div>` and `<p>` tags).
    Required:
  • (string) $type Optional. Message type, controls HTML class. Possible values include 'error', 'success', 'warning', 'info'. Default 'error'.
    Required:
    Default: 'error'
定義位置
相關方法
settings_errorsget_settings_errorsadd_settings_sectionadd_settings_fielddo_settings_sections
引入
3.0.0
棄用
-

add_settings_error: 這個函式用來在WordPress設定頁面上新增一個新的錯誤或資訊。你可以使用這個函式在使用者在WordPress設定頁面儲存他們的設定時顯示一條資訊或錯誤。

註冊一個設定錯誤,以顯示給使用者。
設定API的一部分。使用它來向使用者顯示關於設定驗證問題、缺失設定或其他的資訊。

設定錯誤應該被新增到register_setting()中定義的$sanitize_callback函式中,用於給定的設定提供反饋。

預設情況下,資訊將在產生錯誤的提交後立即顯示。對settings_errors()的額外呼叫可以用來顯示錯誤,即使是在第一次訪問設定頁面時。

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
function add_settings_error( $setting, $code, $message, $type = 'error' ) {
global $wp_settings_errors;
$wp_settings_errors[] = array(
'setting' => $setting,
'code' => $code,
'message' => $message,
'type' => $type,
);
}
function add_settings_error( $setting, $code, $message, $type = 'error' ) { global $wp_settings_errors; $wp_settings_errors[] = array( 'setting' => $setting, 'code' => $code, 'message' => $message, 'type' => $type, ); }
function add_settings_error( $setting, $code, $message, $type = 'error' ) {
	global $wp_settings_errors;

	$wp_settings_errors[] = array(
		'setting' => $setting,
		'code'    => $code,
		'message' => $message,
		'type'    => $type,
	);
}

常見問題

FAQs
檢視更多 >