add_settings_error()

最后更新于：2021-11-25 19:40:23

Register a settings error to be displayed to the user.

参数

$setting

(string) (Required) Slug title of the setting to which this error applies.

$code

(string) (Required) Slug-name to identify the error. Used as part of ‘id’ attribute in HTML output.

$message

(string) (Required) The formatted message text to display to the user (will be shown inside styled <div> and <p> tags).

$type

(string) (Optional) Message type, controls HTML class. Possible values include ‘error’, ‘success’, ‘warning’, ‘info’.

Default value: ‘error’

源文件

文件: gc-admin/includes/template.php

function add_settings_error( $setting, $code, $message, $type = 'error' ) {
	global $gc_settings_errors;

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

function change( $data ) {

    $message = null;
    $type = null;

    if ( null != $data ) {

        if ( false === get_option( 'myOption' ) ) {

            add_option( 'myOption', $data );
            $type = 'updated';
            $message = __( 'Successfully saved', 'my-text-domain' );

        } else {

            update_option( 'myOption', $data );
            $type = 'updated';
            $message = __( 'Successfully updated', 'my-text-domain' );

        }

    } else {

        $type = 'error';
        $message = __( 'Data can not be empty', 'my-text-domain' );

    }

    add_settings_error(
        'myUniqueIdentifyer',
        esc_attr( 'settings_updated' ),
        $message,
        $type
    );

}