]> scripts.mit.edu Git - autoinstalls/wordpress.git/blobdiff - wp-admin/custom-header.php
WordPress 3.9.1
[autoinstalls/wordpress.git] / wp-admin / custom-header.php
index fc9d4f126f10894ea7e8b1edd341857a50138cb9..1c9971f5aa8d191990c0b0f4d4cfd8fe5cbfbed3 100644 (file)
@@ -43,7 +43,7 @@ class Custom_Image_Header {
        var $default_headers = array();
 
        /**
        var $default_headers = array();
 
        /**
-        * Holds custom headers uploaded by the user
+        * Holds custom headers uploaded by the user.
         *
         * @var array
         * @since 3.2.0
         *
         * @var array
         * @since 3.2.0
@@ -73,6 +73,11 @@ class Custom_Image_Header {
                $this->admin_image_div_callback = $admin_image_div_callback;
 
                add_action( 'admin_menu', array( $this, 'init' ) );
                $this->admin_image_div_callback = $admin_image_div_callback;
 
                add_action( 'admin_menu', array( $this, 'init' ) );
+
+               add_action( 'customize_save_after',         array( $this, 'customize_set_last_used' ) );
+               add_action( 'wp_ajax_custom-header-crop',   array( $this, 'ajax_header_crop'        ) );
+               add_action( 'wp_ajax_custom-header-add',    array( $this, 'ajax_header_add'         ) );
+               add_action( 'wp_ajax_custom-header-remove', array( $this, 'ajax_header_remove'      ) );
        }
 
        /**
        }
 
        /**
@@ -84,21 +89,16 @@ class Custom_Image_Header {
                if ( ! current_user_can('edit_theme_options') )
                        return;
 
                if ( ! current_user_can('edit_theme_options') )
                        return;
 
-               $this->page = $page = add_theme_page(__('Header'), __('Header'), 'edit_theme_options', 'custom-header', array(&$this, 'admin_page'));
+               $this->page = $page = add_theme_page(__('Header'), __('Header'), 'edit_theme_options', 'custom-header', array($this, 'admin_page'));
 
 
-               add_action("admin_print_scripts-$page", array(&$this, 'js_includes'));
-               add_action("admin_print_styles-$page", array(&$this, 'css_includes'));
-               add_action("admin_head-$page", array(&$this, 'help') );
-               add_action("admin_head-$page", array(&$this, 'take_action'), 50);
-               add_action("admin_head-$page", array(&$this, 'js'), 50);
+               add_action("admin_print_scripts-$page", array($this, 'js_includes'));
+               add_action("admin_print_styles-$page", array($this, 'css_includes'));
+               add_action("admin_head-$page", array($this, 'help') );
+               add_action("admin_head-$page", array($this, 'take_action'), 50);
+               add_action("admin_head-$page", array($this, 'js'), 50);
                if ( $this->admin_header_callback )
                        add_action("admin_head-$page", $this->admin_header_callback, 51);
 
                if ( $this->admin_header_callback )
                        add_action("admin_head-$page", $this->admin_header_callback, 51);
 
-               if ( isset( $_REQUEST['context'] ) && $_REQUEST['context'] == 'custom-header' ) {
-                       add_filter( 'attachment_fields_to_edit', array( $this, 'attachment_fields_to_edit' ), 10, 2 );
-                       add_filter( 'media_upload_tabs', array( $this, 'filter_upload_tabs' ) );
-                       add_filter( 'media_upload_mime_type_links', '__return_empty_array' );
-               }
        }
 
        /**
        }
 
        /**
@@ -130,14 +130,14 @@ class Custom_Image_Header {
                        'title'   => __('Header Text'),
                        'content' =>
                                '<p>' . sprintf( __( 'For most themes, the header text is your Site Title and Tagline, as defined in the <a href="%1$s">General Settings</a> section.' ), admin_url( 'options-general.php' ) ) . '<p>' .
                        'title'   => __('Header Text'),
                        'content' =>
                                '<p>' . sprintf( __( 'For most themes, the header text is your Site Title and Tagline, as defined in the <a href="%1$s">General Settings</a> section.' ), admin_url( 'options-general.php' ) ) . '<p>' .
-                               '<p>' . __( 'In the Header Text section of this page, you can choose whether to display this text or hide it. You can also choose a color for the text by typing in a legitimate HTML hex value (eg: &#8220;#ff0000&#8221; for red) or by clicking &#8220;Select a Color&#8221; and dialing in a color using the color picker.') . '</p>' .
-                               '<p>' . __( 'Don&#8217;t forget to Save Changes when you&#8217;re done!') . '</p>'
+                               '<p>' . __( 'In the Header Text section of this page, you can choose whether to display this text or hide it. You can also choose a color for the text by clicking the Select Color button and either typing in a legitimate HTML hex value, e.g. &#8220;#ff0000&#8221; for red, or by choosing a color using the color picker.' ) . '</p>' .
+                               '<p>' . __( 'Don&#8217;t forget to click &#8220;Save Changes&#8221; when you&#8217;re done!') . '</p>'
                ) );
 
                get_current_screen()->set_help_sidebar(
                        '<p><strong>' . __( 'For more information:' ) . '</strong></p>' .
                        '<p>' . __( '<a href="http://codex.wordpress.org/Appearance_Header_Screen" target="_blank">Documentation on Custom Header</a>' ) . '</p>' .
                ) );
 
                get_current_screen()->set_help_sidebar(
                        '<p><strong>' . __( 'For more information:' ) . '</strong></p>' .
                        '<p>' . __( '<a href="http://codex.wordpress.org/Appearance_Header_Screen" target="_blank">Documentation on Custom Header</a>' ) . '</p>' .
-                       '<p>' . __( '<a href="http://wordpress.org/support/" target="_blank">Support Forums</a>' ) . '</p>'
+                       '<p>' . __( '<a href="https://wordpress.org/support/" target="_blank">Support Forums</a>' ) . '</p>'
                );
        }
 
                );
        }
 
@@ -171,11 +171,10 @@ class Custom_Image_Header {
                $step = $this->step();
 
                if ( ( 1 == $step || 3 == $step ) ) {
                $step = $this->step();
 
                if ( ( 1 == $step || 3 == $step ) ) {
-                       add_thickbox();
-                       wp_enqueue_script( 'media-upload' );
+                       wp_enqueue_media();
                        wp_enqueue_script( 'custom-header' );
                        if ( current_theme_supports( 'custom-header', 'header-text' ) )
                        wp_enqueue_script( 'custom-header' );
                        if ( current_theme_supports( 'custom-header', 'header-text' ) )
-                               wp_enqueue_script('farbtastic');
+                               wp_enqueue_script( 'wp-color-picker' );
                } elseif ( 2 == $step ) {
                        wp_enqueue_script('imgareaselect');
                }
                } elseif ( 2 == $step ) {
                        wp_enqueue_script('imgareaselect');
                }
@@ -184,13 +183,13 @@ class Custom_Image_Header {
        /**
         * Set up the enqueue for the CSS files
         *
        /**
         * Set up the enqueue for the CSS files
         *
-        * @since 2.7
+        * @since 2.7.0
         */
        function css_includes() {
                $step = $this->step();
 
                if ( ( 1 == $step || 3 == $step ) && current_theme_supports( 'custom-header', 'header-text' ) )
         */
        function css_includes() {
                $step = $this->step();
 
                if ( ( 1 == $step || 3 == $step ) && current_theme_supports( 'custom-header', 'header-text' ) )
-                       wp_enqueue_style('farbtastic');
+                       wp_enqueue_style( 'wp-color-picker' );
                elseif ( 2 == $step )
                        wp_enqueue_style('imgareaselect');
        }
                elseif ( 2 == $step )
                        wp_enqueue_style('imgareaselect');
        }
@@ -215,12 +214,6 @@ class Custom_Image_Header {
                        return;
                }
 
                        return;
                }
 
-               if ( isset( $_POST['resettext'] ) ) {
-                       check_admin_referer( 'custom-header-options', '_wpnonce-custom-header-options' );
-                       remove_theme_mod('header_textcolor');
-                       return;
-               }
-
                if ( isset( $_POST['removeheader'] ) ) {
                        check_admin_referer( 'custom-header-options', '_wpnonce-custom-header-options' );
                        $this->remove_header_image();
                if ( isset( $_POST['removeheader'] ) ) {
                        check_admin_referer( 'custom-header-options', '_wpnonce-custom-header-options' );
                        $this->remove_header_image();
@@ -261,6 +254,10 @@ class Custom_Image_Header {
                if ( !isset($_wp_default_headers) )
                        return;
 
                if ( !isset($_wp_default_headers) )
                        return;
 
+               if ( ! empty( $this->default_headers ) ) {
+                       return;
+               }
+
                $this->default_headers = $_wp_default_headers;
                $template_directory_uri = get_template_directory_uri();
                $stylesheet_directory_uri = get_stylesheet_directory_uri();
                $this->default_headers = $_wp_default_headers;
                $template_directory_uri = get_template_directory_uri();
                $stylesheet_directory_uri = get_stylesheet_directory_uri();
@@ -268,7 +265,6 @@ class Custom_Image_Header {
                        $this->default_headers[$header]['url'] =  sprintf( $this->default_headers[$header]['url'], $template_directory_uri, $stylesheet_directory_uri );
                        $this->default_headers[$header]['thumbnail_url'] =  sprintf( $this->default_headers[$header]['thumbnail_url'], $template_directory_uri, $stylesheet_directory_uri );
                }
                        $this->default_headers[$header]['url'] =  sprintf( $this->default_headers[$header]['url'], $template_directory_uri, $stylesheet_directory_uri );
                        $this->default_headers[$header]['thumbnail_url'] =  sprintf( $this->default_headers[$header]['thumbnail_url'], $template_directory_uri, $stylesheet_directory_uri );
                }
-
        }
 
        /**
        }
 
        /**
@@ -332,7 +328,6 @@ class Custom_Image_Header {
        function js_1() { ?>
 <script type="text/javascript">
 /* <![CDATA[ */
        function js_1() { ?>
 <script type="text/javascript">
 /* <![CDATA[ */
-var farbtastic;
 (function($){
        var default_color = '#<?php echo get_theme_support( 'custom-header', 'default-text-color' ); ?>',
                header_text_fields;
 (function($){
        var default_color = '#<?php echo get_theme_support( 'custom-header', 'default-text-color' ); ?>',
                header_text_fields;
@@ -341,7 +336,6 @@ var farbtastic;
                $('#name').css('color', color);
                $('#desc').css('color', color);
                $('#text-color').val(color);
                $('#name').css('color', color);
                $('#desc').css('color', color);
                $('#text-color').val(color);
-               farbtastic.setColor(color);
        }
 
        function toggle_text() {
        }
 
        function toggle_text() {
@@ -360,45 +354,20 @@ var farbtastic;
        }
 
        $(document).ready(function() {
        }
 
        $(document).ready(function() {
+               var text_color = $('#text-color');
                header_text_fields = $('.displaying-header-text');
                header_text_fields = $('.displaying-header-text');
-               $('#pickcolor').click(function(e) {
-                       e.preventDefault();
-                       $('#color-picker').show();
+               text_color.wpColorPicker({
+                       change: function( event, ui ) {
+                               pickColor( text_color.wpColorPicker('color') );
+                       },
+                       clear: function() {
+                               pickColor( '' );
+                       }
                });
                });
-
                $('#display-header-text').click( toggle_text );
                $('#display-header-text').click( toggle_text );
-
-               $('#defaultcolor').click(function() {
-                       pickColor(default_color);
-                       $('#text-color').val(default_color);
-               });
-
-               $('#text-color').keyup(function() {
-                       var _hex = $('#text-color').val();
-                       var hex = _hex;
-                       if ( hex[0] != '#' )
-                               hex = '#' + hex;
-                       hex = hex.replace(/[^#a-fA-F0-9]+/, '');
-                       if ( hex != _hex )
-                               $('#text-color').val(hex);
-                       if ( hex.length == 4 || hex.length == 7 )
-                               pickColor( hex );
-               });
-
-               $(document).mousedown(function(){
-                       $('#color-picker').each( function() {
-                               var display = $(this).css('display');
-                               if (display == 'block')
-                                       $(this).fadeOut(2);
-                       });
-               });
-
-               farbtastic = $.farbtastic('#color-picker', function(color) { pickColor(color); });
-               <?php if ( display_header_text() ) { ?>
-               pickColor('#<?php echo get_header_textcolor(); ?>');
-               <?php } else { ?>
+               <?php if ( ! display_header_text() ) : ?>
                toggle_text();
                toggle_text();
-               <?php } ?>
+               <?php endif; ?>
        });
 })(jQuery);
 /* ]]> */
        });
 })(jQuery);
 /* ]]> */
@@ -490,8 +459,7 @@ var farbtastic;
 ?>
 
 <div class="wrap">
 ?>
 
 <div class="wrap">
-<?php screen_icon(); ?>
-<h2><?php _e('Custom Header'); ?></h2>
+<h2><?php _e( 'Custom Header' ); ?></h2>
 
 <?php if ( ! empty( $this->updated ) ) { ?>
 <div id="message" class="updated">
 
 <?php if ( ! empty( $this->updated ) ) { ?>
 <div id="message" class="updated">
@@ -504,14 +472,22 @@ var farbtastic;
 <table class="form-table">
 <tbody>
 
 <table class="form-table">
 <tbody>
 
-<tr valign="top">
+<?php if ( get_custom_header() || display_header_text() ) : ?>
+<tr>
 <th scope="row"><?php _e( 'Preview' ); ?></th>
 <td>
 <th scope="row"><?php _e( 'Preview' ); ?></th>
 <td>
-       <?php if ( $this->admin_image_div_callback ) {
-         call_user_func( $this->admin_image_div_callback );
+       <?php
+       if ( $this->admin_image_div_callback ) {
+               call_user_func( $this->admin_image_div_callback );
        } else {
        } else {
+               $custom_header = get_custom_header();
+               $header_image_style = 'background-image:url(' . esc_url( get_header_image() ) . ');';
+               if ( $custom_header->width )
+                       $header_image_style .= 'max-width:' . $custom_header->width . 'px;';
+               if ( $custom_header->height )
+                       $header_image_style .= 'height:' . $custom_header->height . 'px;';
        ?>
        ?>
-       <div id="headimg" style="background-image:url(<?php esc_url ( header_image() ) ?>);max-width:<?php echo get_custom_header()->width; ?>px;height:<?php echo get_custom_header()->height; ?>px;">
+       <div id="headimg" style="<?php echo $header_image_style; ?>">
                <?php
                if ( display_header_text() )
                        $style = ' style="color:#' . get_header_textcolor() . ';"';
                <?php
                if ( display_header_text() )
                        $style = ' style="color:#' . get_header_textcolor() . ';"';
@@ -524,11 +500,13 @@ var farbtastic;
        <?php } ?>
 </td>
 </tr>
        <?php } ?>
 </td>
 </tr>
+<?php endif; ?>
+
 <?php if ( current_theme_supports( 'custom-header', 'uploads' ) ) : ?>
 <?php if ( current_theme_supports( 'custom-header', 'uploads' ) ) : ?>
-<tr valign="top">
+<tr>
 <th scope="row"><?php _e( 'Select Image' ); ?></th>
 <td>
 <th scope="row"><?php _e( 'Select Image' ); ?></th>
 <td>
-       <p><?php _e( 'You can upload a custom header image to be shown at the top of your site instead of the default one. On the next screen you will be able to crop the image.' ); ?><br />
+       <p><?php _e( 'You can select an image to be shown at the top of your site by uploading from your computer or choosing from your media library. After selecting an image you will be able to crop it.' ); ?><br />
        <?php
        if ( ! current_theme_supports( 'custom-header', 'flex-height' ) && ! current_theme_supports( 'custom-header', 'flex-width' ) ) {
                printf( __( 'Images of exactly <strong>%1$d &times; %2$d pixels</strong> will be used as-is.' ) . '<br />', get_theme_support( 'custom-header', 'width' ), get_theme_support( 'custom-header', 'height' ) );
        <?php
        if ( ! current_theme_supports( 'custom-header', 'flex-height' ) && ! current_theme_supports( 'custom-header', 'flex-width' ) ) {
                printf( __( 'Images of exactly <strong>%1$d &times; %2$d pixels</strong> will be used as-is.' ) . '<br />', get_theme_support( 'custom-header', 'width' ), get_theme_support( 'custom-header', 'height' ) );
@@ -546,7 +524,7 @@ var farbtastic;
                        printf( __( 'Suggested height is <strong>%1$d pixels</strong>.' ) . ' ', get_theme_support( 'custom-header', 'height' ) );
        }
        ?></p>
                        printf( __( 'Suggested height is <strong>%1$d pixels</strong>.' ) . ' ', get_theme_support( 'custom-header', 'height' ) );
        }
        ?></p>
-       <form enctype="multipart/form-data" id="upload-form" method="post" action="<?php echo esc_attr( add_query_arg( 'step', 2 ) ) ?>">
+       <form enctype="multipart/form-data" id="upload-form" class="wp-upload-form" method="post" action="<?php echo esc_url( add_query_arg( 'step', 2 ) ) ?>">
        <p>
                <label for="upload"><?php _e( 'Choose an image from your computer:' ); ?></label><br />
                <input type="file" id="upload" name="import" />
        <p>
                <label for="upload"><?php _e( 'Choose an image from your computer:' ); ?></label><br />
                <input type="file" id="upload" name="import" />
@@ -555,13 +533,18 @@ var farbtastic;
                <?php submit_button( __( 'Upload' ), 'button', 'submit', false ); ?>
        </p>
        <?php
                <?php submit_button( __( 'Upload' ), 'button', 'submit', false ); ?>
        </p>
        <?php
-               $image_library_url = get_upload_iframe_src( 'image', null, 'library' );
-               $image_library_url = remove_query_arg( 'TB_iframe', $image_library_url );
-               $image_library_url = add_query_arg( array( 'context' => 'custom-header', 'TB_iframe' => 1 ), $image_library_url );
+               $modal_update_href = esc_url( add_query_arg( array(
+                       'page' => 'custom-header',
+                       'step' => 2,
+                       '_wpnonce-custom-header-upload' => wp_create_nonce('custom-header-upload'),
+               ), admin_url('themes.php') ) );
        ?>
        <p>
                <label for="choose-from-library-link"><?php _e( 'Or choose an image from your media library:' ); ?></label><br />
        ?>
        <p>
                <label for="choose-from-library-link"><?php _e( 'Or choose an image from your media library:' ); ?></label><br />
-               <a id="choose-from-library-link" class="button thickbox" href="<?php echo esc_url( $image_library_url ); ?>"><?php _e( 'Choose Image' ); ?></a>
+               <a id="choose-from-library-link" class="button"
+                       data-update-link="<?php echo esc_attr( $modal_update_href ); ?>"
+                       data-choose="<?php esc_attr_e( 'Choose a Custom Header' ); ?>"
+                       data-update="<?php esc_attr_e( 'Set as header' ); ?>"><?php _e( 'Choose Image' ); ?></a>
        </p>
        </form>
 </td>
        </p>
        </form>
 </td>
@@ -570,11 +553,11 @@ var farbtastic;
 </tbody>
 </table>
 
 </tbody>
 </table>
 
-<form method="post" action="<?php echo esc_attr( add_query_arg( 'step', 1 ) ) ?>">
+<form method="post" action="<?php echo esc_url( add_query_arg( 'step', 1 ) ) ?>">
 <table class="form-table">
 <tbody>
        <?php if ( get_uploaded_header_images() ) : ?>
 <table class="form-table">
 <tbody>
        <?php if ( get_uploaded_header_images() ) : ?>
-<tr valign="top">
+<tr>
 <th scope="row"><?php _e( 'Uploaded Images' ); ?></th>
 <td>
        <p><?php _e( 'You can choose one of your previously uploaded headers, or show a random one.' ) ?></p>
 <th scope="row"><?php _e( 'Uploaded Images' ); ?></th>
 <td>
        <p><?php _e( 'You can choose one of your previously uploaded headers, or show a random one.' ) ?></p>
@@ -585,7 +568,7 @@ var farbtastic;
 </tr>
        <?php endif;
        if ( ! empty( $this->default_headers ) ) : ?>
 </tr>
        <?php endif;
        if ( ! empty( $this->default_headers ) ) : ?>
-<tr valign="top">
+<tr>
 <th scope="row"><?php _e( 'Default Images' ); ?></th>
 <td>
 <?php if ( current_theme_supports( 'custom-header', 'uploads' ) ) : ?>
 <th scope="row"><?php _e( 'Default Images' ); ?></th>
 <td>
 <?php if ( current_theme_supports( 'custom-header', 'uploads' ) ) : ?>
@@ -600,7 +583,7 @@ var farbtastic;
 </tr>
        <?php endif;
        if ( get_header_image() ) : ?>
 </tr>
        <?php endif;
        if ( get_header_image() ) : ?>
-<tr valign="top">
+<tr>
 <th scope="row"><?php _e( 'Remove Image' ); ?></th>
 <td>
        <p><?php _e( 'This will remove the header image. You will not be able to restore any customizations.' ) ?></p>
 <th scope="row"><?php _e( 'Remove Image' ); ?></th>
 <td>
        <p><?php _e( 'This will remove the header image. You will not be able to restore any customizations.' ) ?></p>
@@ -611,7 +594,7 @@ var farbtastic;
 
        $default_image = get_theme_support( 'custom-header', 'default-image' );
        if ( $default_image && get_header_image() != $default_image ) : ?>
 
        $default_image = get_theme_support( 'custom-header', 'default-image' );
        if ( $default_image && get_header_image() != $default_image ) : ?>
-<tr valign="top">
+<tr>
 <th scope="row"><?php _e( 'Reset Image' ); ?></th>
 <td>
        <p><?php _e( 'This will restore the original header image. You will not be able to restore any customizations.' ) ?></p>
 <th scope="row"><?php _e( 'Reset Image' ); ?></th>
 <td>
        <p><?php _e( 'This will restore the original header image. You will not be able to restore any customizations.' ) ?></p>
@@ -628,7 +611,7 @@ var farbtastic;
 
 <table class="form-table">
 <tbody>
 
 <table class="form-table">
 <tbody>
-<tr valign="top">
+<tr>
 <th scope="row"><?php _e( 'Header Text' ); ?></th>
 <td>
        <p>
 <th scope="row"><?php _e( 'Header Text' ); ?></th>
 <td>
        <p>
@@ -637,35 +620,33 @@ var farbtastic;
 </td>
 </tr>
 
 </td>
 </tr>
 
-<tr valign="top" class="displaying-header-text">
+<tr class="displaying-header-text">
 <th scope="row"><?php _e( 'Text Color' ); ?></th>
 <td>
        <p>
 <th scope="row"><?php _e( 'Text Color' ); ?></th>
 <td>
        <p>
-<?php if ( display_header_text() ) : ?>
-               <input type="text" name="text-color" id="text-color" value="#<?php echo esc_attr( get_header_textcolor() ); ?>" />
-<?php else : ?>
-               <input type="text" name="text-color" id="text-color" value="#<?php echo esc_attr( get_theme_support( 'custom-header', 'default-text-color' ) ); ?>" />
-<?php endif; ?>
-               <a href="#" class="hide-if-no-js" id="pickcolor"><?php _e( 'Select a Color' ); ?></a>
+<?php
+$header_textcolor = display_header_text() ? get_header_textcolor() : get_theme_support( 'custom-header', 'default-text-color' );
+$default_color = '';
+if ( current_theme_supports( 'custom-header', 'default-text-color' ) ) {
+       $default_color = '#' . get_theme_support( 'custom-header', 'default-text-color' );
+       $default_color_attr = ' data-default-color="' . esc_attr( $default_color ) . '"';
+       echo '<input type="text" name="text-color" id="text-color" value="#' . esc_attr( $header_textcolor ) . '"' . $default_color_attr . ' />';
+       if ( $default_color )
+               echo ' <span class="description hide-if-js">' . sprintf( _x( 'Default: %s', 'color' ), $default_color ) . '</span>';
+}
+?>
        </p>
        </p>
-       <div id="color-picker" style="z-index: 100; background:#eee; border:1px solid #ccc; position:absolute; display:none;"></div>
 </td>
 </tr>
 </td>
 </tr>
-
-       <?php if ( current_theme_supports( 'custom-header', 'default-text-color' ) && get_theme_mod( 'header_textcolor' ) ) { ?>
-<tr valign="top">
-<th scope="row"><?php _e('Reset Text Color'); ?></th>
-<td>
-       <p><?php _e( 'This will restore the original header text. You will not be able to restore any customizations.' ) ?></p>
-       <?php submit_button( __( 'Restore Original Header Text' ), 'button', 'resettext', false ); ?>
-</td>
-</tr>
-       <?php } ?>
-
 </tbody>
 </table>
 <?php endif;
 
 </tbody>
 </table>
 <?php endif;
 
+/**
+ * Fires just before the submit button in the custom header options form.
+ *
+ * @since 3.1.0
+ */
 do_action( 'custom_header_options' );
 
 wp_nonce_field( 'custom-header-options', '_wpnonce-custom-header-options' ); ?>
 do_action( 'custom_header_options' );
 
 wp_nonce_field( 'custom-header-options', '_wpnonce-custom-header-options' ); ?>
@@ -699,8 +680,8 @@ wp_nonce_field( 'custom-header-options', '_wpnonce-custom-header-options' ); ?>
                        list( $width, $height, $type, $attr ) = getimagesize( $file );
                } else {
                        $data = wp_get_attachment_metadata( $attachment_id );
                        list( $width, $height, $type, $attr ) = getimagesize( $file );
                } else {
                        $data = wp_get_attachment_metadata( $attachment_id );
-                       $height = $data[ 'height' ];
-                       $width = $data[ 'width' ];
+                       $height = isset( $data[ 'height' ] ) ? $data[ 'height' ] : 0;
+                       $width = isset( $data[ 'width' ] ) ? $data[ 'width' ] : 0;
                        unset( $data );
                }
 
                        unset( $data );
                }
 
@@ -723,7 +704,16 @@ wp_nonce_field( 'custom-header-options', '_wpnonce-custom-header-options' ); ?>
 
                        $this->set_header_image( compact( 'url', 'attachment_id', 'width', 'height' ) );
 
 
                        $this->set_header_image( compact( 'url', 'attachment_id', 'width', 'height' ) );
 
-                       do_action('wp_create_file_in_uploads', $file, $attachment_id); // For replication
+                       /**
+                        * Fires after the header image is set or an error is returned.
+                        *
+                        * @since 2.1.0
+                        *
+                        * @param string $file          Path to the file.
+                        * @param int    $attachment_id Attachment ID.
+                        */
+                       do_action( 'wp_create_file_in_uploads', $file, $attachment_id ); // For replication
+
                        return $this->finished();
                } elseif ( $width > $max_width ) {
                        $oitar = $width / $max_width;
                        return $this->finished();
                } elseif ( $width > $max_width ) {
                        $oitar = $width / $max_width;
@@ -731,7 +721,8 @@ wp_nonce_field( 'custom-header-options', '_wpnonce-custom-header-options' ); ?>
                        if ( ! $image || is_wp_error( $image ) )
                                wp_die( __( 'Image could not be processed. Please go back and try again.' ), __( 'Image Processing Error' ) );
 
                        if ( ! $image || is_wp_error( $image ) )
                                wp_die( __( 'Image could not be processed. Please go back and try again.' ), __( 'Image Processing Error' ) );
 
-                       $image = apply_filters('wp_create_file_in_uploads', $image, $attachment_id); // For replication
+                       /** This filter is documented in wp-admin/custom-header.php */
+                       $image = apply_filters( 'wp_create_file_in_uploads', $image, $attachment_id ); // For replication
 
                        $url = str_replace(basename($url), basename($image), $url);
                        $width = $width / $oitar;
 
                        $url = str_replace(basename($url), basename($image), $url);
                        $width = $width / $oitar;
@@ -742,10 +733,9 @@ wp_nonce_field( 'custom-header-options', '_wpnonce-custom-header-options' ); ?>
                ?>
 
 <div class="wrap">
                ?>
 
 <div class="wrap">
-<?php screen_icon(); ?>
 <h2><?php _e( 'Crop Header Image' ); ?></h2>
 
 <h2><?php _e( 'Crop Header Image' ); ?></h2>
 
-<form method="post" action="<?php echo esc_attr(add_query_arg('step', 3)); ?>">
+<form method="post" action="<?php echo esc_url(add_query_arg('step', 3)); ?>">
        <p class="hide-if-no-js"><?php _e('Choose the part of the image you want to use as your header.'); ?></p>
        <p class="hide-if-js"><strong><?php _e( 'You need Javascript to choose a part of the image.'); ?></strong></p>
 
        <p class="hide-if-no-js"><?php _e('Choose the part of the image you want to use as your header.'); ?></p>
        <p class="hide-if-js"><strong><?php _e( 'You need Javascript to choose a part of the image.'); ?></strong></p>
 
@@ -767,7 +757,7 @@ wp_nonce_field( 'custom-header-options', '_wpnonce-custom-header-options' ); ?>
        <p class="submit">
        <?php submit_button( __( 'Crop and Publish' ), 'primary', 'submit', false ); ?>
        <?php
        <p class="submit">
        <?php submit_button( __( 'Crop and Publish' ), 'primary', 'submit', false ); ?>
        <?php
-       if ( isset( $oitar ) && 1 == $oitar )
+       if ( isset( $oitar ) && 1 == $oitar && ( current_theme_supports( 'custom-header', 'flex-height' ) || current_theme_supports( 'custom-header', 'flex-width' ) ) )
                submit_button( __( 'Skip Cropping, Publish Image as Is' ), 'secondary', 'skip-cropping', false );
        ?>
        </p>
                submit_button( __( 'Skip Cropping, Publish Image as Is' ), 'secondary', 'skip-cropping', false );
        ?>
        </p>
@@ -784,7 +774,13 @@ wp_nonce_field( 'custom-header-options', '_wpnonce-custom-header-options' ); ?>
         */
        function step_2_manage_upload() {
                $overrides = array('test_form' => false);
         */
        function step_2_manage_upload() {
                $overrides = array('test_form' => false);
-               $file = wp_handle_upload($_FILES['import'], $overrides);
+
+               $uploaded_file = $_FILES['import'];
+               $wp_filetype = wp_check_filetype_and_ext( $uploaded_file['tmp_name'], $uploaded_file['name'], false );
+               if ( ! wp_match_mime_types( 'image', $wp_filetype['type'] ) )
+                       wp_die( __( 'The uploaded file is not a valid image. Please try again.' ) );
+
+               $file = wp_handle_upload($uploaded_file, $overrides);
 
                if ( isset($file['error']) )
                        wp_die( $file['error'],  __( 'Image Upload Error' ) );
 
                if ( isset($file['error']) )
                        wp_die( $file['error'],  __( 'Image Upload Error' ) );
@@ -819,6 +815,9 @@ wp_nonce_field( 'custom-header-options', '_wpnonce-custom-header-options' ); ?>
                if ( ! current_theme_supports( 'custom-header', 'uploads' ) )
                        wp_die( __( 'Cheatin&#8217; uh?' ) );
 
                if ( ! current_theme_supports( 'custom-header', 'uploads' ) )
                        wp_die( __( 'Cheatin&#8217; uh?' ) );
 
+               if ( ! empty( $_POST['skip-cropping'] ) && ! ( current_theme_supports( 'custom-header', 'flex-height' ) || current_theme_supports( 'custom-header', 'flex-width' ) ) )
+                       wp_die( __( 'Cheatin&#8217; uh?' ) );
+
                if ( $_POST['oitar'] > 1 ) {
                        $_POST['x1'] = $_POST['x1'] * $_POST['oitar'];
                        $_POST['y1'] = $_POST['y1'] * $_POST['oitar'];
                if ( $_POST['oitar'] > 1 ) {
                        $_POST['x1'] = $_POST['x1'] * $_POST['oitar'];
                        $_POST['y1'] = $_POST['y1'] * $_POST['oitar'];
@@ -829,32 +828,15 @@ wp_nonce_field( 'custom-header-options', '_wpnonce-custom-header-options' ); ?>
                $attachment_id = absint( $_POST['attachment_id'] );
                $original = get_attached_file($attachment_id);
 
                $attachment_id = absint( $_POST['attachment_id'] );
                $original = get_attached_file($attachment_id);
 
-
-               $max_width = 0;
-               // For flex, limit size of image displayed to 1500px unless theme says otherwise
-               if ( current_theme_supports( 'custom-header', 'flex-width' ) )
-                       $max_width = 1500;
-
-               if ( current_theme_supports( 'custom-header', 'max-width' ) )
-                       $max_width = max( $max_width, get_theme_support( 'custom-header', 'max-width' ) );
-               $max_width = max( $max_width, get_theme_support( 'custom-header', 'width' ) );
-
-               if ( ( current_theme_supports( 'custom-header', 'flex-height' ) && ! current_theme_supports( 'custom-header', 'flex-width' ) ) || $_POST['width'] > $max_width )
-                       $dst_height = absint( $_POST['height'] * ( $max_width / $_POST['width'] ) );
-               elseif ( current_theme_supports( 'custom-header', 'flex-height' ) && current_theme_supports( 'custom-header', 'flex-width' ) )
-                       $dst_height = absint( $_POST['height'] );
-               else
-                       $dst_height = get_theme_support( 'custom-header', 'height' );
-
-               if ( ( current_theme_supports( 'custom-header', 'flex-width' ) && ! current_theme_supports( 'custom-header', 'flex-height' ) ) || $_POST['width'] > $max_width )
-                       $dst_width = absint( $_POST['width'] * ( $max_width / $_POST['width'] ) );
-               elseif ( current_theme_supports( 'custom-header', 'flex-width' ) && current_theme_supports( 'custom-header', 'flex-height' ) )
-                       $dst_width = absint( $_POST['width'] );
-               else
-                       $dst_width = get_theme_support( 'custom-header', 'width' );
+               $dimensions = $this->get_header_dimensions( array(
+                       'height' => $_POST['height'],
+                       'width'  => $_POST['width'],
+               ) );
+               $height = $dimensions['dst_height'];
+               $width = $dimensions['dst_width'];
 
                if ( empty( $_POST['skip-cropping'] ) )
 
                if ( empty( $_POST['skip-cropping'] ) )
-                       $cropped = wp_crop_image( $attachment_id, (int) $_POST['x1'], (int) $_POST['y1'], (int) $_POST['width'], (int) $_POST['height'], $dst_width, $dst_height );
+                       $cropped = wp_crop_image( $attachment_id, (int) $_POST['x1'], (int) $_POST['y1'], (int) $_POST['width'], (int) $_POST['height'], $width, $height );
                elseif ( ! empty( $_POST['create-new-attachment'] ) )
                        $cropped = _copy_image_file( $attachment_id );
                else
                elseif ( ! empty( $_POST['create-new-attachment'] ) )
                        $cropped = _copy_image_file( $attachment_id );
                else
@@ -863,41 +845,37 @@ wp_nonce_field( 'custom-header-options', '_wpnonce-custom-header-options' ); ?>
                if ( ! $cropped || is_wp_error( $cropped ) )
                        wp_die( __( 'Image could not be processed. Please go back and try again.' ), __( 'Image Processing Error' ) );
 
                if ( ! $cropped || is_wp_error( $cropped ) )
                        wp_die( __( 'Image could not be processed. Please go back and try again.' ), __( 'Image Processing Error' ) );
 
-               $cropped = apply_filters('wp_create_file_in_uploads', $cropped, $attachment_id); // For replication
+               /** This filter is documented in wp-admin/custom-header.php */
+               $cropped = apply_filters( 'wp_create_file_in_uploads', $cropped, $attachment_id ); // For replication
 
 
-               $parent = get_post($attachment_id);
-               $parent_url = $parent->guid;
-               $url = str_replace( basename( $parent_url ), basename( $cropped ), $parent_url );
-
-               $size = @getimagesize( $cropped );
-               $image_type = ( $size ) ? $size['mime'] : 'image/jpeg';
+               $object = $this->create_attachment_object( $cropped, $attachment_id );
 
 
-               // Construct the object array
-               $object = array(
-                       'ID' => $attachment_id,
-                       'post_title' => basename($cropped),
-                       'post_content' => $url,
-                       'post_mime_type' => $image_type,
-                       'guid' => $url,
-                       'context' => 'custom-header'
-               );
                if ( ! empty( $_POST['create-new-attachment'] ) )
                        unset( $object['ID'] );
 
                // Update the attachment
                if ( ! empty( $_POST['create-new-attachment'] ) )
                        unset( $object['ID'] );
 
                // Update the attachment
-               $attachment_id = wp_insert_attachment( $object, $cropped );
-               wp_update_attachment_metadata( $attachment_id, wp_generate_attachment_metadata( $attachment_id, $cropped ) );
+               $attachment_id = $this->insert_attachment( $object, $cropped );
 
 
-               $width = $dst_width;
-               $height = $dst_height;
+               $url = $object['guid'];
                $this->set_header_image( compact( 'url', 'attachment_id', 'width', 'height' ) );
 
                // cleanup
                $medium = str_replace( basename( $original ), 'midsize-' . basename( $original ), $original );
                $this->set_header_image( compact( 'url', 'attachment_id', 'width', 'height' ) );
 
                // cleanup
                $medium = str_replace( basename( $original ), 'midsize-' . basename( $original ), $original );
-               if ( file_exists( $medium ) )
+               if ( file_exists( $medium ) ) {
+                       /**
+                        * Filter the path of the file to delete.
+                        *
+                        * @since 2.1.0
+                        *
+                        * @param string $medium Path to the file to delete.
+                        */
                        @unlink( apply_filters( 'wp_delete_file', $medium ) );
                        @unlink( apply_filters( 'wp_delete_file', $medium ) );
-               if ( empty( $_POST['create-new-attachment'] ) && empty( $_POST['skip-cropping'] ) )
+               }
+
+               if ( empty( $_POST['create-new-attachment'] ) && empty( $_POST['skip-cropping'] ) ) {
+                       /** This filter is documented in wp-admin/custom-header.php */
                        @unlink( apply_filters( 'wp_delete_file', $original ) );
                        @unlink( apply_filters( 'wp_delete_file', $original ) );
+               }
 
                return $this->finished();
        }
 
                return $this->finished();
        }
@@ -930,32 +908,21 @@ wp_nonce_field( 'custom-header-options', '_wpnonce-custom-header-options' ); ?>
        }
 
        /**
        }
 
        /**
-        * Replace default attachment actions with "Set as header" link.
+        * Unused since 3.5.0.
         *
         * @since 3.4.0
         */
         *
         * @since 3.4.0
         */
-       function attachment_fields_to_edit( $form_fields, $post ) {
-               $form_fields = array();
-               $href = esc_url(add_query_arg(array(
-                       'page' => 'custom-header',
-                       'step' => 2,
-                       '_wpnonce-custom-header-upload' => wp_create_nonce('custom-header-upload'),
-                       'file' => $post->ID
-               ), admin_url('themes.php')));
-
-               $form_fields['buttons'] = array( 'tr' => '<tr class="submit"><td></td><td><a data-location="' . $href . '" class="wp-set-header">' . __( 'Set as header' ) . '</a></td></tr>' );
-               $form_fields['context'] = array( 'input' => 'hidden', 'value' => 'custom-header' );
-
+       function attachment_fields_to_edit( $form_fields ) {
                return $form_fields;
        }
 
        /**
                return $form_fields;
        }
 
        /**
-        * Leave only "Media Library" tab in the uploader window.
+        * Unused since 3.5.0.
         *
         * @since 3.4.0
         */
         *
         * @since 3.4.0
         */
-       function filter_upload_tabs() {
-               return array( 'library' => __('Media Library') );
+       function filter_upload_tabs( $tabs ) {
+               return $tabs;
        }
 
        /**
        }
 
        /**
@@ -1039,6 +1006,7 @@ wp_nonce_field( 'custom-header-options', '_wpnonce-custom-header-options' ); ?>
 
                $default = sprintf( $default, get_template_directory_uri(), get_stylesheet_directory_uri() );
 
 
                $default = sprintf( $default, get_template_directory_uri(), get_stylesheet_directory_uri() );
 
+               $default_data = array();
                foreach ( $this->default_headers as $header => $details ) {
                        if ( $details['url'] == $default ) {
                                $default_data = $details;
                foreach ( $this->default_headers as $header => $details ) {
                        if ( $details['url'] == $default ) {
                                $default_data = $details;
@@ -1049,4 +1017,269 @@ wp_nonce_field( 'custom-header-options', '_wpnonce-custom-header-options' ); ?>
                set_theme_mod( 'header_image', $default );
                set_theme_mod( 'header_image_data', (object) $default_data );
        }
                set_theme_mod( 'header_image', $default );
                set_theme_mod( 'header_image_data', (object) $default_data );
        }
+
+       /**
+        * Calculate width and height based on what the currently selected theme supports.
+        *
+        * @return array dst_height and dst_width of header image.
+        */
+       final public function get_header_dimensions( $dimensions ) {
+               $max_width = 0;
+               $width = absint( $dimensions['width'] );
+               $height = absint( $dimensions['height'] );
+               $theme_height = get_theme_support( 'custom-header', 'height' );
+               $theme_width = get_theme_support( 'custom-header', 'width' );
+               $has_flex_width = current_theme_supports( 'custom-header', 'flex-width' );
+               $has_flex_height = current_theme_supports( 'custom-header', 'flex-height' );
+               $has_max_width = current_theme_supports( 'custom-header', 'max-width' ) ;
+               $dst = array( 'dst_height' => null, 'dst_height' => null );
+
+               // For flex, limit size of image displayed to 1500px unless theme says otherwise
+               if ( $has_flex_width ) {
+                       $max_width = 1500;
+               }
+
+               if ( $has_max_width ) {
+                       $max_width = max( $max_width, get_theme_support( 'custom-header', 'max-width' ) );
+               }
+               $max_width = max( $max_width, $theme_width );
+
+               if ( $has_flex_height && ( ! $has_flex_width || $width > $max_width ) ) {
+                       $dst['dst_height'] = absint( $height * ( $max_width / $width ) );
+               }
+               elseif ( $has_flex_height && $has_flex_width ) {
+                       $dst['dst_height'] = $height;
+               }
+               else {
+                       $dst['dst_height'] = $theme_height;
+               }
+
+               if ( $has_flex_width && ( ! $has_flex_height || $width > $max_width ) ) {
+                       $dst['dst_width'] = absint( $width * ( $max_width / $width ) );
+               }
+               elseif ( $has_flex_width && $has_flex_height ) {
+                       $dst['dst_width'] = $width;
+               }
+               else {
+                       $dst['dst_width'] = $theme_width;
+               }
+
+               return $dst;
+       }
+
+       /**
+        * Create an attachment 'object'.
+        *
+        * @param string $cropped Cropped image URL.
+        * @param int $parent_attachment_id Attachment ID of parent image.
+        *
+        * @return array Attachment object.
+        */
+       final public function create_attachment_object( $cropped, $parent_attachment_id ) {
+               $parent = get_post( $parent_attachment_id );
+               $parent_url = $parent->guid;
+               $url = str_replace( basename( $parent_url ), basename( $cropped ), $parent_url );
+
+               $size = @getimagesize( $cropped );
+               $image_type = ( $size ) ? $size['mime'] : 'image/jpeg';
+
+               $object = array(
+                       'ID' => $parent_attachment_id,
+                       'post_title' => basename($cropped),
+                       'post_content' => $url,
+                       'post_mime_type' => $image_type,
+                       'guid' => $url,
+                       'context' => 'custom-header'
+               );
+
+               return $object;
+       }
+
+       /**
+        * Insert an attachment & its metadata.
+        *
+        * @param array $object Attachment object.
+        * @param string $cropped Cropped image URL.
+        *
+        * @return int Attachment ID.
+        */
+       final public function insert_attachment( $object, $cropped ) {
+               $attachment_id = wp_insert_attachment( $object, $cropped );
+               $metadata = wp_generate_attachment_metadata( $attachment_id, $cropped );
+               /**
+                * Allows us to insert custom meta data for an attachment.
+                *
+                */
+               $metadata = apply_filters( 'wp_header_image_attachment_metadata', $metadata );
+               wp_update_attachment_metadata( $attachment_id, $metadata );
+               return $attachment_id;
+       }
+
+       /**
+        * Gets attachment uploaded by Media Manager, crops it, then saves it as a
+        * new object. Returns JSON-encoded object details.
+        */
+       function ajax_header_crop() {
+               check_ajax_referer( 'image_editor-' . $_POST['id'], 'nonce' );
+
+               if ( ! current_user_can( 'edit_theme_options' ) ) {
+                       wp_send_json_error();
+               }
+
+               if ( ! current_theme_supports( 'custom-header', 'uploads' ) ) {
+                       wp_send_json_error();
+               }
+
+               $crop_details = $_POST['cropDetails'];
+
+               $dimensions = $this->get_header_dimensions( array(
+                       'height' => $crop_details['height'],
+                       'width'  => $crop_details['width'],
+               ) );
+
+               $attachment_id = absint( $_POST['id'] );
+
+               $cropped = wp_crop_image(
+                       $attachment_id,
+                       (int) $crop_details['x1'],
+                       (int) $crop_details['y1'],
+                       (int) $crop_details['width'],
+                       (int) $crop_details['height'],
+                       (int) $dimensions['dst_width'],
+                       (int) $dimensions['dst_height']
+               );
+
+               if ( ! $cropped || is_wp_error( $cropped ) ) {
+                       wp_send_json_error( array( 'message' => __( 'Image could not be processed. Please go back and try again.' ) ) );
+               }
+
+               $cropped = apply_filters( 'wp_create_file_in_uploads', $cropped, $attachment_id ); // For replication
+
+               $object = $this->create_attachment_object( $cropped, $attachment_id );
+
+               unset( $object['ID'] );
+
+               $new_attachment_id = $this->insert_attachment( $object, $cropped );
+
+               $object['attachment_id'] = $new_attachment_id;
+               $object['width']         = $dimensions['dst_width'];
+               $object['height']        = $dimensions['dst_height'];
+
+               wp_send_json_success( $object );
+       }
+
+       /**
+        * Given an attachment ID for a header image, updates its "last used"
+        * timestamp to now.
+        *
+        * Triggered when the user tries adds a new header image from the
+        * Media Manager, even if s/he doesn't save that change.
+        */
+       function ajax_header_add() {
+               check_ajax_referer( 'header-add', 'nonce' );
+
+               if ( ! current_user_can( 'edit_theme_options' ) ) {
+                       wp_send_json_error();
+               }
+
+               $attachment_id = absint( $_POST['attachment_id'] );
+               if ( $attachment_id < 1 ) {
+                       wp_send_json_error();
+               }
+
+               $key = '_wp_attachment_custom_header_last_used_' . get_stylesheet();
+               update_post_meta( $attachment_id, $key, time() );
+               update_post_meta( $attachment_id, '_wp_attachment_is_custom_header', get_stylesheet() );
+
+               wp_send_json_success();
+       }
+
+       /**
+        * Given an attachment ID for a header image, unsets it as a user-uploaded
+        * header image for the current theme.
+        *
+        * Triggered when the user clicks the overlay "X" button next to each image
+        * choice in the Customizer's Header tool.
+        */
+       function ajax_header_remove() {
+               check_ajax_referer( 'header-remove', 'nonce' );
+
+               if ( ! current_user_can( 'edit_theme_options' ) ) {
+                       wp_send_json_error();
+               }
+
+               $attachment_id = absint( $_POST['attachment_id'] );
+               if ( $attachment_id < 1 ) {
+                       wp_send_json_error();
+               }
+
+               $key = '_wp_attachment_custom_header_last_used_' . get_stylesheet();
+               delete_post_meta( $attachment_id, $key );
+               delete_post_meta( $attachment_id, '_wp_attachment_is_custom_header', get_stylesheet() );
+
+               wp_send_json_success();
+       }
+
+       function customize_set_last_used( $wp_customize ) {
+               $data = $wp_customize->get_setting( 'header_image_data' )->post_value();
+
+               if ( ! isset( $data['attachment_id'] ) ) {
+                       return;
+               }
+
+               $attachment_id = $data['attachment_id'];
+               $key = '_wp_attachment_custom_header_last_used_' . get_stylesheet();
+               update_post_meta( $attachment_id, $key, time() );
+       }
+
+       public function get_default_header_images() {
+               $this->process_default_headers();
+
+               // Get the default image if there is one.
+               $default = get_theme_support( 'custom-header', 'default-image' );
+
+               if ( ! $default ) { // If not,
+                       return $this->default_headers; // easy peasy.
+               }
+
+               $default = sprintf( $default, get_template_directory_uri(), get_stylesheet_directory_uri() );
+               $already_has_default = false;
+
+               foreach ( $this->default_headers as $k => $h ) {
+                       if ( $h['url'] === $default ) {
+                               $already_has_default = true;
+                               break;
+                       }
+               }
+
+               if ( $already_has_default ) {
+                       return $this->default_headers;
+               }
+
+               // If the one true image isn't included in the default set, prepend it.
+               $header_images = array();
+               $header_images['default'] = array(
+                       'url'           => $default,
+                       'thumbnail_url' => $default,
+                       'description'   => 'Default'
+               );
+
+               // The rest of the set comes after.
+               $header_images = array_merge( $header_images, $this->default_headers );
+               return $header_images;
+       }
+
+       public function get_uploaded_header_images() {
+               $header_images = get_uploaded_header_images();
+               $timestamp_key = '_wp_attachment_custom_header_last_used_' . get_stylesheet();
+               $alt_text_key = '_wp_attachment_image_alt';
+
+               foreach ( $header_images as &$header_image ) {
+                       $header_meta = get_post_meta( $header_image['attachment_id'] );
+                       $header_image['timestamp'] = isset( $header_meta[ $timestamp_key ] ) ? $header_meta[ $timestamp_key ] : '';
+                       $header_image['alt_text'] = isset( $header_meta[ $alt_text_key ] ) ? $header_meta[ $alt_text_key ] : '';
+               }
+
+               return $header_images;
+       }
 }
 }