WP_Customize_Header_Image_Setting::update() WordPress Method
The WP_Customize_Header_Image_Setting::update() method is used to update the header image for a WordPress site. This method accepts two parameters: the new header image URL and the crop position. The crop position is an optional parameter that can be used to specify how the header image should be cropped.
WP_Customize_Header_Image_Setting::update( mixed $value ) #
Parameters
- $value
(mixed)(Required)The value to update.
Source
File: wp-includes/customize/class-wp-customize-header-image-setting.php
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 = isset( $args[0]['admin-head-callback'] ) ? $args[0]['admin-head-callback'] : null; $admin_preview_callback = isset( $args[0]['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 ); } }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
3.4.0 | Introduced. |