get_settings_errors

Source code

function get_settings_errors( $setting = '', $sanitize = FALSE ) {

	global $wp_settings_errors;



	// If $sanitize is true, manually re-run the sanitizisation for this option

	// This allows the $sanitize_callback from register_setting() to run, adding

	// any settings errors you want to show by default.

	if ( $sanitize )

		sanitize_option( $setting, get_option($setting));



	// If settings were passed back from options.php then use them

	// Ignore transients if $sanitize is true, we dont' want the old values anyway

	if ( isset($_GET['settings-updated']) && $_GET['settings-updated'] && get_transient('settings_errors') ) {

		$settings_errors = get_transient('settings_errors');

		delete_transient('settings_errors');

	// Otherwise check global in case validation has been run on this pageload

	} elseif ( count( $wp_settings_errors ) ) {

		$settings_errors = $wp_settings_errors;

	} else {

		return;

	}



	// Filter the results to those of a specific setting if one was set

	if ( $setting ) {

		foreach ( (array) $settings_errors as $key => $details )

			if ( $setting != $details['setting'] )

				unset( $settings_errors[$key] );

	}

	return $settings_errors;

}