WP_Customize_Header_Image_Setting::update │ public │ WP 3.4.0

Method of the class: WP_Customize_Header_Image_Setting{}

No Hooks.

Returns

true. Always returns true.

Usage

$WP_Customize_Header_Image_Setting = new WP_Customize_Header_Image_Setting();
$WP_Customize_Header_Image_Setting->update( $value );

$value(mixed) (required)

The value to update.

Notes

• Global. Custom_Image_Header. $custom_image_header

Changelog

WP_Customize_Header_Image_Setting::update() WP Customize Header Image Setting::update code ^{WP 7.0}

public function update( $value ) {
	global $custom_image_header;

	// If _custom_header_background_just_in_time() fails to initialize $custom_image_header when not is_admin().
	if ( empty( $custom_image_header ) ) {
		require_once ABSPATH . 'wp-admin/includes/class-custom-image-header.php';
		$args                   = get_theme_support( 'custom-header' );
		$admin_head_callback    = $args[0]['admin-head-callback'] ?? null;
		$admin_preview_callback = $args[0]['admin-preview-callback'] ?? null;
		$custom_image_header    = new Custom_Image_Header( $admin_head_callback, $admin_preview_callback );
	}

	/*
	 * If the value doesn't exist (removed or random),
	 * use the header_image value.
	 */
	if ( ! $value ) {
		$value = $this->manager->get_setting( 'header_image' )->post_value();
	}

	if ( is_array( $value ) && isset( $value['choice'] ) ) {
		$custom_image_header->set_header_image( $value['choice'] );
	} else {
		$custom_image_header->set_header_image( $value );
	}
	return true;
}