3 * The custom header image script.
6 * @subpackage Administration
10 * The custom header image class.
14 * @subpackage Administration
16 class Custom_Image_Header {
19 * Callback for administration header.
25 var $admin_header_callback;
28 * Callback for header div.
34 var $admin_image_div_callback;
37 * Holds default headers.
43 var $default_headers = array();
46 * Holds custom headers uploaded by the user
52 var $uploaded_headers = array();
55 * Holds the page menu hook.
64 * Constructor - Register administration header callback.
67 * @param callback $admin_header_callback
68 * @param callback $admin_image_div_callback Optional custom image div output callback.
69 * @return Custom_Image_Header
71 function __construct($admin_header_callback, $admin_image_div_callback = '') {
72 $this->admin_header_callback = $admin_header_callback;
73 $this->admin_image_div_callback = $admin_image_div_callback;
75 add_action( 'admin_menu', array( $this, 'init' ) );
79 * Set up the hooks for the Custom Header admin page.
84 if ( ! current_user_can('edit_theme_options') )
87 $this->page = $page = add_theme_page(__('Header'), __('Header'), 'edit_theme_options', 'custom-header', array(&$this, 'admin_page'));
89 add_action("admin_print_scripts-$page", array(&$this, 'js_includes'));
90 add_action("admin_print_styles-$page", array(&$this, 'css_includes'));
91 add_action("admin_head-$page", array(&$this, 'help') );
92 add_action("admin_head-$page", array(&$this, 'take_action'), 50);
93 add_action("admin_head-$page", array(&$this, 'js'), 50);
94 if ( $this->admin_header_callback )
95 add_action("admin_head-$page", $this->admin_header_callback, 51);
99 * Adds contextual help.
104 get_current_screen()->add_help_tab( array(
106 'title' => __('Overview'),
108 '<p>' . __( 'This screen is used to customize the header section of your theme.') . '</p>' .
109 '<p>' . __( 'You can choose from the theme’s default header images, or use one of your own. You can also customize how your Site Title and Tagline are displayed.') . '<p>'
112 get_current_screen()->add_help_tab( array(
113 'id' => 'set-header-image',
114 'title' => __('Header Image'),
116 '<p>' . __( 'You can set a custom image header for your site. Simply upload the image and crop it, and the new header will go live immediately. Alternatively, you can use an image that has already been uploaded to your Media Library by clicking the “Choose Image” button.' ) . '</p>' .
117 '<p>' . __( 'Some themes come with additional header images bundled. If you see multiple images displayed, select the one you’d like and click the “Save Changes” button.' ) . '</p>' .
118 '<p>' . __( 'If your theme has more than one default header image, or you have uploaded more than one custom header image, you have the option of having WordPress display a randomly different image on each page of your site. Click the “Random” radio button next to the Uploaded Images or Default Images section to enable this feature.') . '</p>' .
119 '<p>' . __( 'If you don’t want a header image to be displayed on your site at all, click the “Remove Header Image” button at the bottom of the Header Image section of this page. If you want to re-enable the header image later, you just have to select one of the other image options and click “Save Changes”.') . '</p>'
122 get_current_screen()->add_help_tab( array(
123 'id' => 'set-header-text',
124 'title' => __('Header Text'),
126 '<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>' .
127 '<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. “#ff0000” for red, or by choosing a color using the color picker.' ) . '</p>' .
128 '<p>' . __( 'Don’t forget to click “Save Changes” when you’re done!') . '</p>'
131 get_current_screen()->set_help_sidebar(
132 '<p><strong>' . __( 'For more information:' ) . '</strong></p>' .
133 '<p>' . __( '<a href="http://codex.wordpress.org/Appearance_Header_Screen" target="_blank">Documentation on Custom Header</a>' ) . '</p>' .
134 '<p>' . __( '<a href="http://wordpress.org/support/" target="_blank">Support Forums</a>' ) . '</p>'
139 * Get the current step.
143 * @return int Current step
146 if ( ! isset( $_GET['step'] ) )
149 $step = (int) $_GET['step'];
150 if ( $step < 1 || 3 < $step ||
151 ( 2 == $step && ! wp_verify_nonce( $_REQUEST['_wpnonce-custom-header-upload'], 'custom-header-upload' ) ) ||
152 ( 3 == $step && ! wp_verify_nonce( $_REQUEST['_wpnonce'], 'custom-header-crop-image' ) )
160 * Set up the enqueue for the JavaScript files.
164 function js_includes() {
165 $step = $this->step();
167 if ( ( 1 == $step || 3 == $step ) ) {
169 wp_enqueue_script( 'custom-header' );
170 if ( current_theme_supports( 'custom-header', 'header-text' ) )
171 wp_enqueue_script( 'wp-color-picker' );
172 } elseif ( 2 == $step ) {
173 wp_enqueue_script('imgareaselect');
178 * Set up the enqueue for the CSS files
182 function css_includes() {
183 $step = $this->step();
185 if ( ( 1 == $step || 3 == $step ) && current_theme_supports( 'custom-header', 'header-text' ) )
186 wp_enqueue_style( 'wp-color-picker' );
187 elseif ( 2 == $step )
188 wp_enqueue_style('imgareaselect');
192 * Execute custom header modification.
196 function take_action() {
197 if ( ! current_user_can('edit_theme_options') )
200 if ( empty( $_POST ) )
203 $this->updated = true;
205 if ( isset( $_POST['resetheader'] ) ) {
206 check_admin_referer( 'custom-header-options', '_wpnonce-custom-header-options' );
207 $this->reset_header_image();
211 if ( isset( $_POST['removeheader'] ) ) {
212 check_admin_referer( 'custom-header-options', '_wpnonce-custom-header-options' );
213 $this->remove_header_image();
217 if ( isset( $_POST['text-color'] ) && ! isset( $_POST['display-header-text'] ) ) {
218 check_admin_referer( 'custom-header-options', '_wpnonce-custom-header-options' );
219 set_theme_mod( 'header_textcolor', 'blank' );
220 } elseif ( isset( $_POST['text-color'] ) ) {
221 check_admin_referer( 'custom-header-options', '_wpnonce-custom-header-options' );
222 $_POST['text-color'] = str_replace( '#', '', $_POST['text-color'] );
223 $color = preg_replace('/[^0-9a-fA-F]/', '', $_POST['text-color']);
224 if ( strlen($color) == 6 || strlen($color) == 3 )
225 set_theme_mod('header_textcolor', $color);
227 set_theme_mod( 'header_textcolor', 'blank' );
230 if ( isset( $_POST['default-header'] ) ) {
231 check_admin_referer( 'custom-header-options', '_wpnonce-custom-header-options' );
232 $this->set_header_image( $_POST['default-header'] );
238 * Process the default headers
242 function process_default_headers() {
243 global $_wp_default_headers;
245 if ( !empty($this->headers) )
248 if ( !isset($_wp_default_headers) )
251 $this->default_headers = $_wp_default_headers;
252 $template_directory_uri = get_template_directory_uri();
253 $stylesheet_directory_uri = get_stylesheet_directory_uri();
254 foreach ( array_keys($this->default_headers) as $header ) {
255 $this->default_headers[$header]['url'] = sprintf( $this->default_headers[$header]['url'], $template_directory_uri, $stylesheet_directory_uri );
256 $this->default_headers[$header]['thumbnail_url'] = sprintf( $this->default_headers[$header]['thumbnail_url'], $template_directory_uri, $stylesheet_directory_uri );
262 * Display UI for selecting one of several default headers.
264 * Show the random image option if this theme has multiple header images.
265 * Random image option is on by default if no header has been set.
269 function show_header_selector( $type = 'default' ) {
270 if ( 'default' == $type ) {
271 $headers = $this->default_headers;
273 $headers = get_uploaded_header_images();
277 if ( 1 < count( $headers ) ) {
278 echo '<div class="random-header">';
279 echo '<label><input name="default-header" type="radio" value="random-' . $type . '-image"' . checked( is_random_header_image( $type ), true, false ) . ' />';
280 echo __( '<strong>Random:</strong> Show a different image on each page.' );
285 echo '<div class="available-headers">';
286 foreach ( $headers as $header_key => $header ) {
287 $header_thumbnail = $header['thumbnail_url'];
288 $header_url = $header['url'];
289 $header_desc = empty( $header['description'] ) ? '' : $header['description'];
290 echo '<div class="default-header">';
291 echo '<label><input name="default-header" type="radio" value="' . esc_attr( $header_key ) . '" ' . checked( $header_url, get_theme_mod( 'header_image' ), false ) . ' />';
293 if ( !empty( $header['attachment_id'] ) )
294 $width = ' width="230"';
295 echo '<img src="' . set_url_scheme( $header_thumbnail ) . '" alt="' . esc_attr( $header_desc ) .'" title="' . esc_attr( $header_desc ) . '"' . $width . ' /></label>';
298 echo '<div class="clear"></div></div>';
302 * Execute Javascript depending on step.
307 $step = $this->step();
308 if ( ( 1 == $step || 3 == $step ) && current_theme_supports( 'custom-header', 'header-text' ) )
310 elseif ( 2 == $step )
315 * Display Javascript based on Step 1 and 3.
320 <script type="text/javascript">
323 var default_color = '#<?php echo get_theme_support( 'custom-header', 'default-text-color' ); ?>',
326 function pickColor(color) {
327 $('#name').css('color', color);
328 $('#desc').css('color', color);
329 $('#text-color').val(color);
332 function toggle_text() {
333 var checked = $('#display-header-text').prop('checked'),
335 header_text_fields.toggle( checked );
338 text_color = $('#text-color');
339 if ( '' == text_color.val().replace('#', '') ) {
340 text_color.val( default_color );
341 pickColor( default_color );
343 pickColor( text_color.val() );
347 $(document).ready(function() {
348 var text_color = $('#text-color');
349 header_text_fields = $('.displaying-header-text');
350 text_color.wpColorPicker({
351 change: function( event, ui ) {
352 pickColor( text_color.wpColorPicker('color') );
358 $('#display-header-text').click( toggle_text );
359 <?php if ( ! display_header_text() ) : ?>
370 * Display Javascript based on Step 2.
375 <script type="text/javascript">
377 function onEndCrop( coords ) {
378 jQuery( '#x1' ).val(coords.x);
379 jQuery( '#y1' ).val(coords.y);
380 jQuery( '#width' ).val(coords.w);
381 jQuery( '#height' ).val(coords.h);
384 jQuery(document).ready(function() {
385 var xinit = <?php echo absint( get_theme_support( 'custom-header', 'width' ) ); ?>;
386 var yinit = <?php echo absint( get_theme_support( 'custom-header', 'height' ) ); ?>;
387 var ratio = xinit / yinit;
388 var ximg = jQuery('img#upload').width();
389 var yimg = jQuery('img#upload').height();
391 if ( yimg < yinit || ximg < xinit ) {
392 if ( ximg / yimg > ratio ) {
394 xinit = yinit * ratio;
397 yinit = xinit / ratio;
401 jQuery('img#upload').imgAreaSelect({
410 if ( ! current_theme_supports( 'custom-header', 'flex-height' ) && ! current_theme_supports( 'custom-header', 'flex-width' ) ) {
412 aspectRatio: xinit + ':' + yinit,
415 if ( ! current_theme_supports( 'custom-header', 'flex-height' ) ) {
417 maxHeight: <?php echo get_theme_support( 'custom-header', 'height' ); ?>,
420 if ( ! current_theme_supports( 'custom-header', 'flex-width' ) ) {
422 maxWidth: <?php echo get_theme_support( 'custom-header', 'width' ); ?>,
426 onInit: function () {
427 jQuery('#width').val(xinit);
428 jQuery('#height').val(yinit);
430 onSelectChange: function(img, c) {
431 jQuery('#x1').val(c.x1);
432 jQuery('#y1').val(c.y1);
433 jQuery('#width').val(c.width);
434 jQuery('#height').val(c.height);
444 * Display first step of custom header image page.
449 $this->process_default_headers();
453 <?php screen_icon(); ?>
454 <h2><?php _e('Custom Header'); ?></h2>
456 <?php if ( ! empty( $this->updated ) ) { ?>
457 <div id="message" class="updated">
458 <p><?php printf( __( 'Header updated. <a href="%s">Visit your site</a> to see how it looks.' ), home_url( '/' ) ); ?></p>
462 <h3><?php _e( 'Header Image' ); ?></h3>
464 <table class="form-table">
468 <th scope="row"><?php _e( 'Preview' ); ?></th>
470 <?php if ( $this->admin_image_div_callback ) {
471 call_user_func( $this->admin_image_div_callback );
473 $custom_header = get_custom_header();
474 $header_image_style = 'background-image:url(' . esc_url( get_header_image() ) . ');';
475 if ( $custom_header->width )
476 $header_image_style .= 'max-width:' . $custom_header->width . 'px;';
477 if ( $custom_header->height )
478 $header_image_style .= 'height:' . $custom_header->height . 'px;';
480 <div id="headimg" style="<?php echo $header_image_style; ?>">
482 if ( display_header_text() )
483 $style = ' style="color:#' . get_header_textcolor() . ';"';
485 $style = ' style="display:none;"';
487 <h1><a id="name" class="displaying-header-text" <?php echo $style; ?> onclick="return false;" href="<?php bloginfo('url'); ?>"><?php bloginfo( 'name' ); ?></a></h1>
488 <div id="desc" class="displaying-header-text" <?php echo $style; ?>><?php bloginfo( 'description' ); ?></div>
493 <?php if ( current_theme_supports( 'custom-header', 'uploads' ) ) : ?>
495 <th scope="row"><?php _e( 'Select Image' ); ?></th>
497 <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 />
499 if ( ! current_theme_supports( 'custom-header', 'flex-height' ) && ! current_theme_supports( 'custom-header', 'flex-width' ) ) {
500 printf( __( 'Images of exactly <strong>%1$d × %2$d pixels</strong> will be used as-is.' ) . '<br />', get_theme_support( 'custom-header', 'width' ), get_theme_support( 'custom-header', 'height' ) );
501 } elseif ( current_theme_supports( 'custom-header', 'flex-height' ) ) {
502 if ( ! current_theme_supports( 'custom-header', 'flex-width' ) )
503 printf( __( 'Images should be at least <strong>%1$d pixels</strong> wide.' ) . ' ', get_theme_support( 'custom-header', 'width' ) );
504 } elseif ( current_theme_supports( 'custom-header', 'flex-width' ) ) {
505 if ( ! current_theme_supports( 'custom-header', 'flex-height' ) )
506 printf( __( 'Images should be at least <strong>%1$d pixels</strong> tall.' ) . ' ', get_theme_support( 'custom-header', 'height' ) );
508 if ( current_theme_supports( 'custom-header', 'flex-height' ) || current_theme_supports( 'custom-header', 'flex-width' ) ) {
509 if ( current_theme_supports( 'custom-header', 'width' ) )
510 printf( __( 'Suggested width is <strong>%1$d pixels</strong>.' ) . ' ', get_theme_support( 'custom-header', 'width' ) );
511 if ( current_theme_supports( 'custom-header', 'height' ) )
512 printf( __( 'Suggested height is <strong>%1$d pixels</strong>.' ) . ' ', get_theme_support( 'custom-header', 'height' ) );
515 <form enctype="multipart/form-data" id="upload-form" class="wp-upload-form" method="post" action="<?php echo esc_url( add_query_arg( 'step', 2 ) ) ?>">
517 <label for="upload"><?php _e( 'Choose an image from your computer:' ); ?></label><br />
518 <input type="file" id="upload" name="import" />
519 <input type="hidden" name="action" value="save" />
520 <?php wp_nonce_field( 'custom-header-upload', '_wpnonce-custom-header-upload' ); ?>
521 <?php submit_button( __( 'Upload' ), 'button', 'submit', false ); ?>
524 $modal_update_href = esc_url( add_query_arg( array(
525 'page' => 'custom-header',
527 '_wpnonce-custom-header-upload' => wp_create_nonce('custom-header-upload'),
528 ), admin_url('themes.php') ) );
531 <label for="choose-from-library-link"><?php _e( 'Or choose an image from your media library:' ); ?></label><br />
532 <a id="choose-from-library-link" class="button"
533 data-update-link="<?php echo esc_attr( $modal_update_href ); ?>"
534 data-choose="<?php esc_attr_e( 'Choose a Custom Header' ); ?>"
535 data-update="<?php esc_attr_e( 'Set as header' ); ?>"><?php _e( 'Choose Image' ); ?></a>
544 <form method="post" action="<?php echo esc_url( add_query_arg( 'step', 1 ) ) ?>">
545 <table class="form-table">
547 <?php if ( get_uploaded_header_images() ) : ?>
549 <th scope="row"><?php _e( 'Uploaded Images' ); ?></th>
551 <p><?php _e( 'You can choose one of your previously uploaded headers, or show a random one.' ) ?></p>
553 $this->show_header_selector( 'uploaded' );
558 if ( ! empty( $this->default_headers ) ) : ?>
560 <th scope="row"><?php _e( 'Default Images' ); ?></th>
562 <?php if ( current_theme_supports( 'custom-header', 'uploads' ) ) : ?>
563 <p><?php _e( 'If you don‘t want to upload your own image, you can use one of these cool headers, or show a random one.' ) ?></p>
565 <p><?php _e( 'You can use one of these cool headers or show a random one on each page.' ) ?></p>
568 $this->show_header_selector( 'default' );
573 if ( get_header_image() ) : ?>
575 <th scope="row"><?php _e( 'Remove Image' ); ?></th>
577 <p><?php _e( 'This will remove the header image. You will not be able to restore any customizations.' ) ?></p>
578 <?php submit_button( __( 'Remove Header Image' ), 'button', 'removeheader', false ); ?>
583 $default_image = get_theme_support( 'custom-header', 'default-image' );
584 if ( $default_image && get_header_image() != $default_image ) : ?>
586 <th scope="row"><?php _e( 'Reset Image' ); ?></th>
588 <p><?php _e( 'This will restore the original header image. You will not be able to restore any customizations.' ) ?></p>
589 <?php submit_button( __( 'Restore Original Header Image' ), 'button', 'resetheader', false ); ?>
596 <?php if ( current_theme_supports( 'custom-header', 'header-text' ) ) : ?>
598 <h3><?php _e( 'Header Text' ); ?></h3>
600 <table class="form-table">
603 <th scope="row"><?php _e( 'Header Text' ); ?></th>
606 <label><input type="checkbox" name="display-header-text" id="display-header-text"<?php checked( display_header_text() ); ?> /> <?php _e( 'Show header text with your image.' ); ?></label>
611 <tr valign="top" class="displaying-header-text">
612 <th scope="row"><?php _e( 'Text Color' ); ?></th>
616 $header_textcolor = display_header_text() ? get_header_textcolor() : get_theme_support( 'custom-header', 'default-text-color' );
618 if ( current_theme_supports( 'custom-header', 'default-text-color' ) ) {
619 $default_color = '#' . get_theme_support( 'custom-header', 'default-text-color' );
620 $default_color_attr = ' data-default-color="' . esc_attr( $default_color ) . '"';
621 echo '<input type="text" name="text-color" id="text-color" value="#' . esc_attr( $header_textcolor ) . '"' . $default_color_attr . ' />';
622 if ( $default_color )
623 echo ' <span class="description hide-if-js">' . sprintf( _x( 'Default: %s', 'color' ), $default_color ) . '</span>';
633 do_action( 'custom_header_options' );
635 wp_nonce_field( 'custom-header-options', '_wpnonce-custom-header-options' ); ?>
637 <?php submit_button( null, 'primary', 'save-header-options' ); ?>
644 * Display second step of custom header image page.
649 check_admin_referer('custom-header-upload', '_wpnonce-custom-header-upload');
650 if ( ! current_theme_supports( 'custom-header', 'uploads' ) )
651 wp_die( __( 'Cheatin’ uh?' ) );
653 if ( empty( $_POST ) && isset( $_GET['file'] ) ) {
654 $attachment_id = absint( $_GET['file'] );
655 $file = get_attached_file( $attachment_id, true );
656 $url = wp_get_attachment_image_src( $attachment_id, 'full');
658 } elseif ( isset( $_POST ) ) {
659 extract($this->step_2_manage_upload());
662 if ( file_exists( $file ) ) {
663 list( $width, $height, $type, $attr ) = getimagesize( $file );
665 $data = wp_get_attachment_metadata( $attachment_id );
666 $height = $data[ 'height' ];
667 $width = $data[ 'width' ];
672 // For flex, limit size of image displayed to 1500px unless theme says otherwise
673 if ( current_theme_supports( 'custom-header', 'flex-width' ) )
676 if ( current_theme_supports( 'custom-header', 'max-width' ) )
677 $max_width = max( $max_width, get_theme_support( 'custom-header', 'max-width' ) );
678 $max_width = max( $max_width, get_theme_support( 'custom-header', 'width' ) );
680 // If flexible height isn't supported and the image is the exact right size
681 if ( ! current_theme_supports( 'custom-header', 'flex-height' ) && ! current_theme_supports( 'custom-header', 'flex-width' )
682 && $width == get_theme_support( 'custom-header', 'width' ) && $height == get_theme_support( 'custom-header', 'height' ) )
685 if ( file_exists( $file ) )
686 wp_update_attachment_metadata( $attachment_id, wp_generate_attachment_metadata( $attachment_id, $file ) );
688 $this->set_header_image( compact( 'url', 'attachment_id', 'width', 'height' ) );
690 do_action('wp_create_file_in_uploads', $file, $attachment_id); // For replication
691 return $this->finished();
692 } elseif ( $width > $max_width ) {
693 $oitar = $width / $max_width;
694 $image = wp_crop_image($attachment_id, 0, 0, $width, $height, $max_width, $height / $oitar, false, str_replace(basename($file), 'midsize-'.basename($file), $file));
695 if ( ! $image || is_wp_error( $image ) )
696 wp_die( __( 'Image could not be processed. Please go back and try again.' ), __( 'Image Processing Error' ) );
698 $image = apply_filters('wp_create_file_in_uploads', $image, $attachment_id); // For replication
700 $url = str_replace(basename($url), basename($image), $url);
701 $width = $width / $oitar;
702 $height = $height / $oitar;
709 <?php screen_icon(); ?>
710 <h2><?php _e( 'Crop Header Image' ); ?></h2>
712 <form method="post" action="<?php echo esc_url(add_query_arg('step', 3)); ?>">
713 <p class="hide-if-no-js"><?php _e('Choose the part of the image you want to use as your header.'); ?></p>
714 <p class="hide-if-js"><strong><?php _e( 'You need Javascript to choose a part of the image.'); ?></strong></p>
716 <div id="crop_image" style="position: relative">
717 <img src="<?php echo esc_url( $url ); ?>" id="upload" width="<?php echo $width; ?>" height="<?php echo $height; ?>" />
720 <input type="hidden" name="x1" id="x1" value="0"/>
721 <input type="hidden" name="y1" id="y1" value="0"/>
722 <input type="hidden" name="width" id="width" value="<?php echo esc_attr( $width ); ?>"/>
723 <input type="hidden" name="height" id="height" value="<?php echo esc_attr( $height ); ?>"/>
724 <input type="hidden" name="attachment_id" id="attachment_id" value="<?php echo esc_attr( $attachment_id ); ?>" />
725 <input type="hidden" name="oitar" id="oitar" value="<?php echo esc_attr( $oitar ); ?>" />
726 <?php if ( empty( $_POST ) && isset( $_GET['file'] ) ) { ?>
727 <input type="hidden" name="create-new-attachment" value="true" />
729 <?php wp_nonce_field( 'custom-header-crop-image' ) ?>
732 <?php submit_button( __( 'Crop and Publish' ), 'primary', 'submit', false ); ?>
734 if ( isset( $oitar ) && 1 == $oitar && ( current_theme_supports( 'custom-header', 'flex-height' ) || current_theme_supports( 'custom-header', 'flex-width' ) ) )
735 submit_button( __( 'Skip Cropping, Publish Image as Is' ), 'secondary', 'skip-cropping', false );
745 * Upload the file to be cropped in the second step.
749 function step_2_manage_upload() {
750 $overrides = array('test_form' => false);
752 $uploaded_file = $_FILES['import'];
753 $wp_filetype = wp_check_filetype_and_ext( $uploaded_file['tmp_name'], $uploaded_file['name'], false );
754 if ( ! wp_match_mime_types( 'image', $wp_filetype['type'] ) )
755 wp_die( __( 'The uploaded file is not a valid image. Please try again.' ) );
757 $file = wp_handle_upload($uploaded_file, $overrides);
759 if ( isset($file['error']) )
760 wp_die( $file['error'], __( 'Image Upload Error' ) );
763 $type = $file['type'];
764 $file = $file['file'];
765 $filename = basename($file);
767 // Construct the object array
769 'post_title' => $filename,
770 'post_content' => $url,
771 'post_mime_type' => $type,
773 'context' => 'custom-header'
777 $attachment_id = wp_insert_attachment( $object, $file );
778 return compact( 'attachment_id', 'file', 'filename', 'url', 'type' );
782 * Display third step of custom header image page.
787 check_admin_referer( 'custom-header-crop-image' );
789 if ( ! current_theme_supports( 'custom-header', 'uploads' ) )
790 wp_die( __( 'Cheatin’ uh?' ) );
792 if ( ! empty( $_POST['skip-cropping'] ) && ! ( current_theme_supports( 'custom-header', 'flex-height' ) || current_theme_supports( 'custom-header', 'flex-width' ) ) )
793 wp_die( __( 'Cheatin’ uh?' ) );
795 if ( $_POST['oitar'] > 1 ) {
796 $_POST['x1'] = $_POST['x1'] * $_POST['oitar'];
797 $_POST['y1'] = $_POST['y1'] * $_POST['oitar'];
798 $_POST['width'] = $_POST['width'] * $_POST['oitar'];
799 $_POST['height'] = $_POST['height'] * $_POST['oitar'];
802 $attachment_id = absint( $_POST['attachment_id'] );
803 $original = get_attached_file($attachment_id);
807 // For flex, limit size of image displayed to 1500px unless theme says otherwise
808 if ( current_theme_supports( 'custom-header', 'flex-width' ) )
811 if ( current_theme_supports( 'custom-header', 'max-width' ) )
812 $max_width = max( $max_width, get_theme_support( 'custom-header', 'max-width' ) );
813 $max_width = max( $max_width, get_theme_support( 'custom-header', 'width' ) );
815 if ( ( current_theme_supports( 'custom-header', 'flex-height' ) && ! current_theme_supports( 'custom-header', 'flex-width' ) ) || $_POST['width'] > $max_width )
816 $dst_height = absint( $_POST['height'] * ( $max_width / $_POST['width'] ) );
817 elseif ( current_theme_supports( 'custom-header', 'flex-height' ) && current_theme_supports( 'custom-header', 'flex-width' ) )
818 $dst_height = absint( $_POST['height'] );
820 $dst_height = get_theme_support( 'custom-header', 'height' );
822 if ( ( current_theme_supports( 'custom-header', 'flex-width' ) && ! current_theme_supports( 'custom-header', 'flex-height' ) ) || $_POST['width'] > $max_width )
823 $dst_width = absint( $_POST['width'] * ( $max_width / $_POST['width'] ) );
824 elseif ( current_theme_supports( 'custom-header', 'flex-width' ) && current_theme_supports( 'custom-header', 'flex-height' ) )
825 $dst_width = absint( $_POST['width'] );
827 $dst_width = get_theme_support( 'custom-header', 'width' );
829 if ( empty( $_POST['skip-cropping'] ) )
830 $cropped = wp_crop_image( $attachment_id, (int) $_POST['x1'], (int) $_POST['y1'], (int) $_POST['width'], (int) $_POST['height'], $dst_width, $dst_height );
831 elseif ( ! empty( $_POST['create-new-attachment'] ) )
832 $cropped = _copy_image_file( $attachment_id );
834 $cropped = get_attached_file( $attachment_id );
836 if ( ! $cropped || is_wp_error( $cropped ) )
837 wp_die( __( 'Image could not be processed. Please go back and try again.' ), __( 'Image Processing Error' ) );
839 $cropped = apply_filters('wp_create_file_in_uploads', $cropped, $attachment_id); // For replication
841 $parent = get_post($attachment_id);
842 $parent_url = $parent->guid;
843 $url = str_replace( basename( $parent_url ), basename( $cropped ), $parent_url );
845 $size = @getimagesize( $cropped );
846 $image_type = ( $size ) ? $size['mime'] : 'image/jpeg';
848 // Construct the object array
850 'ID' => $attachment_id,
851 'post_title' => basename($cropped),
852 'post_content' => $url,
853 'post_mime_type' => $image_type,
855 'context' => 'custom-header'
857 if ( ! empty( $_POST['create-new-attachment'] ) )
858 unset( $object['ID'] );
860 // Update the attachment
861 $attachment_id = wp_insert_attachment( $object, $cropped );
862 wp_update_attachment_metadata( $attachment_id, wp_generate_attachment_metadata( $attachment_id, $cropped ) );
865 $height = $dst_height;
866 $this->set_header_image( compact( 'url', 'attachment_id', 'width', 'height' ) );
869 $medium = str_replace( basename( $original ), 'midsize-' . basename( $original ), $original );
870 if ( file_exists( $medium ) )
871 @unlink( apply_filters( 'wp_delete_file', $medium ) );
872 if ( empty( $_POST['create-new-attachment'] ) && empty( $_POST['skip-cropping'] ) )
873 @unlink( apply_filters( 'wp_delete_file', $original ) );
875 return $this->finished();
879 * Display last step of custom header image page.
883 function finished() {
884 $this->updated = true;
889 * Display the page based on the current step.
893 function admin_page() {
894 if ( ! current_user_can('edit_theme_options') )
895 wp_die(__('You do not have permission to customize headers.'));
896 $step = $this->step();
899 elseif ( 3 == $step )
906 * Unused since 3.5.0.
910 function attachment_fields_to_edit( $form_fields ) {
915 * Unused since 3.5.0.
919 function filter_upload_tabs( $tabs ) {
924 * Choose a header image, selected from existing uploaded and default headers,
925 * or provide an array of uploaded header data (either new, or from media library).
927 * @param mixed $choice Which header image to select. Allows for values of 'random-default-image',
928 * for randomly cycling among the default images; 'random-uploaded-image', for randomly cycling
929 * among the uploaded images; the key of a default image registered for that theme; and
930 * the key of an image uploaded for that theme (the basename of the URL).
931 * Or an array of arguments: attachment_id, url, width, height. All are required.
935 final public function set_header_image( $choice ) {
936 if ( is_array( $choice ) || is_object( $choice ) ) {
937 $choice = (array) $choice;
938 if ( ! isset( $choice['attachment_id'] ) || ! isset( $choice['url'] ) )
941 $choice['url'] = esc_url_raw( $choice['url'] );
943 $header_image_data = (object) array(
944 'attachment_id' => $choice['attachment_id'],
945 'url' => $choice['url'],
946 'thumbnail_url' => $choice['url'],
947 'height' => $choice['height'],
948 'width' => $choice['width'],
951 update_post_meta( $choice['attachment_id'], '_wp_attachment_is_custom_header', get_stylesheet() );
952 set_theme_mod( 'header_image', $choice['url'] );
953 set_theme_mod( 'header_image_data', $header_image_data );
957 if ( in_array( $choice, array( 'remove-header', 'random-default-image', 'random-uploaded-image' ) ) ) {
958 set_theme_mod( 'header_image', $choice );
959 remove_theme_mod( 'header_image_data' );
963 $uploaded = get_uploaded_header_images();
964 if ( $uploaded && isset( $uploaded[ $choice ] ) ) {
965 $header_image_data = $uploaded[ $choice ];
968 $this->process_default_headers();
969 if ( isset( $this->default_headers[ $choice ] ) )
970 $header_image_data = $this->default_headers[ $choice ];
975 set_theme_mod( 'header_image', esc_url_raw( $header_image_data['url'] ) );
976 set_theme_mod( 'header_image_data', $header_image_data );
980 * Remove a header image.
984 final public function remove_header_image() {
985 return $this->set_header_image( 'remove-header' );
989 * Reset a header image to the default image for the theme.
991 * This method does not do anything if the theme does not have a default header image.
995 final public function reset_header_image() {
996 $this->process_default_headers();
997 $default = get_theme_support( 'custom-header', 'default-image' );
1000 return $this->remove_header_image();
1002 $default = sprintf( $default, get_template_directory_uri(), get_stylesheet_directory_uri() );
1004 foreach ( $this->default_headers as $header => $details ) {
1005 if ( $details['url'] == $default ) {
1006 $default_data = $details;
1011 set_theme_mod( 'header_image', $default );
1012 set_theme_mod( 'header_image_data', (object) $default_data );