add_settings_error() │ WP 3.0.0

Припустимо, що ми зареєстрували опцію функцією register_setting() , в параметрі $sanitize_callback вказали функцію перевірки: sanitize_opt() .

Нижче приклад цієї функції, в якій реєструється повідомлення про перевірку та збереження значення опції:

function sanitize_opt( $value ) {
	$option_name = 'my_option'; // Назва опції
	$message = 'Дані успішно оновлені.';
	$type = 'updated';

	if( empty($value) ) {
		$type = 'error';
		$message = 'Поле хххх не може бути порожнім';
	}

	if( is_numeric($value) ){
		$type = 'error';
		$message = 'Поле хххх не може бути числом';
	}

	// Очистимо опцію
	$ Value = sanitize_text_field ($ Value);

	add_settings_error( $option_name, 'settings_updated', $message, $type );

	if( $type === 'error' )
		return get_option ($ option_name);
	else
		return $value;
}

Припустимо, ми створили сторінку налаштувань з двома полями форми: input і checkbox (дивіться другий приклад на сторінці API налаштувань ). Тепер нам потрібно перевірити значення цих полів і якщо вони не відповідають нормам, зареєструвати помилки, які WordPress при збереженні виведе автоматично:

/**
 * функція перевірки значень опцій та реєстрації помилок, якщо потрібно!
 * передбачається що ми реєстрували опцію так:
 * register_setting( 'primer_group', 'primer_option', 'primer_options_check');
 */
function primer_options_check( $data ) {
	$option_name = 'my_option'; // Назва опції

	// перевіряємо поле input
	$message = $type = null;

	if ( empty( $data['input'] ) ) {
		$type = 'error';
		$message = 'Поле "Назва опції" не може бути порожнім';
	}
	elseif( preg_match( '~[0-9]~', $data['input'] ) ){
		$ data['input'] = null;
		$type = 'error';
		$message = 'Поле "Назва опції" не може містити цифри';
	}

	if( $message ){
		add_settings_error( 'primer_input', 'input', $message, $type );
	}

	// перевіряємо поле checkbox
	$message = $type = null;

	if( empty( $data['checkbox'] ) ){
		$type = 'error';
		$message = 'Чекбокс слід зазначити!';
	}

	if( $message ){
		add_settings_error( 'primer_checkbox', 'checkbox', $message, $type );
	}

	if( $type === 'error' )
		return get_option ($ option_name);
	else
		return $data;
}