WordPress.org
Get WordPress

Make WordPress Core

Changeset 20212


Ignore:
Timestamp:
03/19/2012 05:12:44 PM (14 years ago)
Author:
nacin
Message:

Introduce new registration methods for custom headers and custom backgrounds. Backwards compatible, but old methods will be deprecated. see #20249. see #17242.

Custom header: Use add_theme_support('custom-header', $args) instead of add_custom_image_header(). Deprecates all use of constants.

  • HEADER_TEXTCOLOR is now (string) 'default-text-color'.
  • NO_HEADER_TEXT is nowi ! (bool) 'header-text'.
  • HEADER_IMAGE_WIDTH (and _HEIGHT) are now (int) 'width' and 'height'.
  • HEADER_IMAGE is now (string) 'default-image'.
  • The 3.4 arguments 'suggested-width' and 'suggested-height' are now just 'width' and 'height' (they are "suggested" when flex-width and flex-height are set).
  • Callback arguments for add_custom_image_header() can now be passed to add_theme_support().

Custom background: Use add_theme_support('custom-background, $args) instead of add_custom_background(). Deprecates all use of constants.

  • BACKGROUND_COLOR is now (string) 'default-color'.
  • BACKGROUND_IMAGE is now (string) 'default-image'.
  • Callback arguments for add_custom_background() can now be passed to add_theme_support().

Inheritance: add_theme_support() arguments for custom headers and custom backgrounds is a first-one-wins situation. This is not an unusual paradigm for theming as a child theme (which is included first) overrides a parent theme.

  • Once an argument is explicitly set, it cannot be overridden. You must hook in earlier and set it first.
  • Any argument that is not explicitly set before WP is loaded will inherit the default value for that argument.
  • It is therefore possible for a child theme to pass minimal arguments as long as the parent theme specifies others that may be necessary.
  • Allows for a child theme to alter callbacks for <head> and preview (previously, calling add_custom_image_header more than once broke things).
  • The just-in-time bits ensure that arguments fall back to default values, that the values of all constants are considered (such as one defined after an old add_custom_image_header call), and that all constants are defined (so as to be backwards compatible).

get_theme_support(): Introduce new second argument, which headers and backgrounds leverage to return an argument. current_theme_supports() already supported checking the truthiness of the argument.

  • For example, get_theme_support( 'custom-header', 'width' ) will return the width specified during registration.
  • If you had wanted the default image, use get_theme_support( 'custom-header', 'default-image' ) instead of HEADER_IMAGE.

Deprecate remove_custom_image_header(), remove_custom_background(). Use remove_theme_support('custom-header'), 'custom-background'.

Deprecate short-lived custom-header-uploads internal support; this is now (bool) 'uploads' for add_theme_support().

New 3.4 functions renamed or removed: Rename get_current_header_data() to get_custom_header(). Remove get_header_image_width() and _height() in favor of get_custom_header()->width and height.

Location:
trunk
Files:
4 edited

Legend:

Unmodified
Added
Removed

  • trunk/wp-admin/custom-background.php

    r19712 r20212  
    5454                $this->admin_header_callback = $admin_header_callback;
    5555                $this->admin_image_div_callback = $admin_image_div_callback;
     56
     57                add_action( 'admin_menu', array( $this, 'init' ) );
    5658        }
    5759
    … …  
    227229<?php endif; ?>
    228230
    229 <?php if ( defined( 'BACKGROUND_IMAGE' ) ) : // Show only if a default background image exists ?>
     231<?php if ( get_theme_support( 'custom-background', 'default-image' ) ) : ?>
    230232<tr valign="top">
    231233<th scope="row"><?php _e('Restore Original Image'); ?></th>

  • trunk/wp-admin/custom-header.php

    r20211 r20212  
    7272                $this->admin_header_callback = $admin_header_callback;
    7373                $this->admin_image_div_callback = $admin_image_div_callback;
     74
     75                add_action( 'admin_menu', array( $this, 'init' ) );
    7476        }
    7577
    … …  
    141143                $step = $this->step();
    142144
    143                 if ( ( 1 == $step || 3 == $step ) && $this->header_text() )
     145                if ( ( 1 == $step || 3 == $step ) && current_theme_supports( 'custom-header', 'header-text' ) )
    144146                        wp_enqueue_script('farbtastic');
    145147                elseif ( 2 == $step )
    … …  
    155157                $step = $this->step();
    156158
    157                 if ( ( 1 == $step || 3 == $step ) && $this->header_text() )
     159                if ( ( 1 == $step || 3 == $step ) && current_theme_supports( 'custom-header', 'header-text' ) )
    158160                        wp_enqueue_style('farbtastic');
    159161                elseif ( 2 == $step )
    … …  
    162164
    163165        /**
    164          * Check if header text is allowed
    165          *
    166          * @since 3.0.0
    167          */
    168         function header_text() {
    169                 if ( defined( 'NO_HEADER_TEXT' ) && NO_HEADER_TEXT )
    170                         return false;
    171 
    172                 return true;
    173         }
    174 
    175         /**
    176166         * Execute custom header modification.
    177167         *
    … …  
    190180                        check_admin_referer( 'custom-header-options', '_wpnonce-custom-header-options' );
    191181                        $this->process_default_headers();
    192                         $default = defined( 'HEADER_IMAGE' ) ? HEADER_IMAGE : '';
     182                        $default = get_theme_support( 'custom-header', 'default-image' );
    193183                        $default = sprintf( $default, get_template_directory_uri(), get_stylesheet_directory_uri() );
    194184                        foreach ( $this->default_headers as $header => $details ) {
    … …  
    200190                        set_theme_mod( 'header_image', $default );
    201191                        if ( empty( $default_data['width'] ) )
    202                                 $default_data['width'] = HEADER_IMAGE_WIDTH;
     192                                $default_data['width'] = get_theme_support( 'custom-header', 'width' );
    203193                        if ( empty( $default_data['height'] ) )
    204                                 $default_data['height'] = HEADER_IMAGE_HEIGHT;
     194                                $default_data['height'] = get_theme_support( 'custom-header', 'height' );
    205195                        set_theme_mod( 'header_image_data', (object) $default_data );
    206196                        return;
    … …  
    246236                                        set_theme_mod( 'header_image', esc_url( $this->default_headers[$_POST['default-header']]['url'] ) );
    247237                                        if ( empty( $this->default_headers[$_POST['default-header']]['width'] ) )
    248                                                 $this->default_headers[$_POST['default-header']]['width'] = HEADER_IMAGE_WIDTH;
     238                                                $this->default_headers[$_POST['default-header']]['width'] = get_theme_support( 'custom-header', 'width' );
    249239                                        if ( empty( $this->default_headers[$_POST['default-header']]['height'] ) )
    250                                                 $this->default_headers[$_POST['default-header']]['height'] = HEADER_IMAGE_HEIGHT;
     240                                                $this->default_headers[$_POST['default-header']]['height'] = get_theme_support( 'custom-header', 'height' );
    251241                                        set_theme_mod( 'header_image_data', (object) $this->default_headers[$_POST['default-header']] );
    252242                                }
    … …  
    326316        function js() {
    327317                $step = $this->step();
    328                 if ( ( 1 == $step || 3 == $step ) && $this->header_text() )
     318                if ( ( 1 == $step || 3 == $step ) && current_theme_supports( 'custom-header', 'header-text' ) )
    329319                        $this->js_1();
    330320                elseif ( 2 == $step )
    … …  
    342332        var text_objects = ['#name', '#desc', '#text-color-row'];
    343333        var farbtastic;
    344         var default_color = '#<?php echo HEADER_TEXTCOLOR; ?>';
     334        var default_color = '#<?php echo get_theme_support( 'custom-header', 'default-text-color' ); ?>';
    345335        var old_color = null;
    346336
    … …  
    412402
    413403                farbtastic = jQuery.farbtastic('#color-picker', function(color) { pickColor(color); });
    414                 <?php if ( $color = get_theme_mod('header_textcolor', HEADER_TEXTCOLOR) ) { ?>
     404                <?php if ( $color = get_header_textcolor() ) { ?>
    415405                pickColor('#<?php echo $color; ?>');
    416406                <?php } ?>
    417407
    418                 <?php if ( 'blank' == get_theme_mod( 'header_textcolor', HEADER_TEXTCOLOR ) || '' == get_theme_mod('header_textcolor', HEADER_TEXTCOLOR) || ! $this->header_text() ) { ?>
     408                <?php if ( 'blank' == $color || '' == $color || ! current_theme_supports( 'custom-header', 'header-text' ) ) { ?>
    419409                toggle_text();
    420410                <?php } ?>
    … …  
    441431
    442432        jQuery(document).ready(function() {
    443                 <?php
    444                 $xinit = HEADER_IMAGE_WIDTH;
    445                 $yinit = HEADER_IMAGE_HEIGHT;
    446                 $header_support = get_theme_support( 'custom-header' );
    447                 if ( !empty( $header_support[ 0 ][ 'suggested-width' ] ) )
    448                         $xinit = $header_support[ 0 ][ 'suggested-width' ];
    449                 if ( !empty( $header_support[ 0 ][ 'suggested-height' ] ) )
    450                         $yinit = $header_support[ 0 ][ 'suggested-height' ];
    451                 ?>
    452                 var xinit = <?php echo absint( $xinit ); ?>;
    453                 var yinit = <?php echo absint( $yinit ); ?>;
     433                var xinit = <?php echo absint( get_theme_support( 'custom-header', 'width' ) ); ?>;
     434                var yinit = <?php echo absint( get_theme_support( 'custom-header', 'height' ) ); ?>;
    454435                var ratio = xinit / yinit;
    455436                var ximg = jQuery('img#upload').width();
    … …  
    482463                        if ( ! current_theme_supports( 'custom-header', 'flex-height' ) ) {
    483464                        ?>
    484                         maxHeight: <?php echo HEADER_IMAGE_HEIGHT; ?>,
     465                        maxHeight: <?php echo get_theme_support( 'custom-header', 'height' ); ?>,
    485466                        <?php
    486467                        }
    487468                        if ( ! current_theme_supports( 'custom-header', 'flex-width' ) ) {
    488469                        ?>
    489                         maxWidth: <?php echo HEADER_IMAGE_WIDTH; ?>,
     470                        maxWidth: <?php echo get_theme_support( 'custom-header', 'width' ); ?>,
    490471                        <?php
    491472                        }
    … …  
    532513<tr valign="top">
    533514<th scope="row"><?php _e( 'Preview' ); ?></th>
    534 <td >
     515<td>
    535516        <?php if ( $this->admin_image_div_callback ) {
    536517          call_user_func( $this->admin_image_div_callback );
    537518        } else {
    538519        ?>
    539         <div id="headimg" style="background-image:url(<?php esc_url ( header_image() ) ?>);max-width:<?php echo get_header_image_width(); ?>px;height:<?php echo get_header_image_height(); ?>px;">
     520        <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;">
    540521                <?php
    541                 if ( 'blank' == get_theme_mod('header_textcolor', HEADER_TEXTCOLOR) || '' == get_theme_mod('header_textcolor', HEADER_TEXTCOLOR) || ! $this->header_text() )
     522                $color = get_header_textcolor();
     523                if ( 'blank' == $color || '' == $color || ! current_theme_supports( 'custom-header', 'header-text' ) )
    542524                        $style = ' style="display:none;"';
    543525                else
    544                         $style = ' style="color:#' . get_theme_mod( 'header_textcolor', HEADER_TEXTCOLOR ) . ';"';
     526                        $style = ' style="color:#' . $color . ';"';
    545527                ?>
    546528                <h1><a id="name"<?php echo $style; ?> onclick="return false;" href="<?php bloginfo('url'); ?>"><?php bloginfo( 'name' ); ?></a></h1>
    … …  
    550532</td>
    551533</tr>
    552 <?php if ( current_theme_supports( 'custom-header-uploads' ) ) : ?>
     534<?php if ( current_theme_supports( 'custom-header', 'uploads' ) ) : ?>
    553535<tr valign="top">
    554536<th scope="row"><?php _e( 'Upload Image' ); ?></th>
    … …  
    557539        <?php
    558540        if ( ! current_theme_supports( 'custom-header', 'flex-height' ) && ! current_theme_supports( 'custom-header', 'flex-width' ) ) {
    559                 printf( __( 'Images of exactly <strong>%1$d &times; %2$d pixels</strong> will be used as-is.' ) . '<br />', HEADER_IMAGE_WIDTH, HEADER_IMAGE_HEIGHT );
     541                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' ) );
    560542        } elseif ( current_theme_supports( 'custom-header', 'flex-height' ) ) {
    561543                if ( ! current_theme_supports( 'custom-header', 'flex-width' ) )
    562                         printf( __( 'Images should be at least <strong>%1$d pixels</strong> wide.' ) . '<br />', HEADER_IMAGE_WIDTH );
     544                        printf( __( 'Images should be at least <strong>%1$d pixels</strong> wide.' ) . ' ', get_theme_support( 'custom-header', 'width' ) );
    563545        } elseif ( current_theme_supports( 'custom-header', 'flex-width' ) ) {
    564546                if ( ! current_theme_supports( 'custom-header', 'flex-height' ) )
    565                         printf( __( 'Images should be at least <strong>%1$d pixels</strong> tall.' ) . '<br />', HEADER_IMAGE_HEIGHT );
     547                        printf( __( 'Images should be at least <strong>%1$d pixels</strong> tall.' ) . ' ', get_theme_support( 'custom-header', 'height' ) );
    566548        }
    567549        if ( current_theme_supports( 'custom-header', 'flex-height' ) || current_theme_supports( 'custom-header', 'flex-width' ) ) {
    568                 $header_support = get_theme_support( 'custom-header' );
    569                 if ( !empty( $header_support[ 0 ][ 'suggested-width' ] ) )
    570                         printf( __( 'Suggested width is <strong>%1$d pixels</strong>.' ) . '<br />', absint( $header_support[ 0 ][ 'suggested-width' ] ) );
    571                 if ( !empty( $header_support[ 0 ][ 'suggested-height' ] ) )
    572                         printf( __( 'Suggested height is <strong>%1$d pixels</strong>.' ) . '<br />', absint( $header_support[ 0 ][ 'suggested-height' ] ) );
     550                if ( current_theme_supports( 'custom-header', 'width' ) )
     551                        printf( __( 'Suggested width is <strong>%1$d pixels</strong>.' ) . ' ', get_theme_support( 'custom-header', 'width' ) );
     552                if ( current_theme_supports( 'custom-header', 'height' ) )
     553                        printf( __( 'Suggested height is <strong>%1$d pixels</strong>.' ) . ' ', get_theme_support( 'custom-header', 'height' ) );
    573554        }
    574555        ?></p>
    … …  
    606587<th scope="row"><?php _e( 'Default Images' ); ?></th>
    607588<td>
    608 <?php if ( current_theme_supports( 'custom-header-uploads' ) ) : ?>
     589<?php if ( current_theme_supports( 'custom-header', 'uploads' ) ) : ?>
    609590        <p><?php _e( 'If you don&lsquo;t want to upload your own image, you can use one of these cool headers, or show a random one.' ) ?></p>
    610591<?php else: ?>
    … …  
    627608        <?php endif;
    628609
    629         if ( defined( 'HEADER_IMAGE' ) && '' != HEADER_IMAGE ) : ?>
     610        if ( current_theme_supports( 'custom-header', 'default-image' ) ) : ?>
    630611<tr valign="top">
    631612<th scope="row"><?php _e( 'Reset Image' ); ?></th>
    … …  
    638619</tbody>
    639620</table>
    640         <?php if ( $this->header_text() ) : ?>
     621        <?php if ( current_theme_supports( 'custom-header', 'header-text' ) ) : ?>
    641622<table class="form-table">
    642623<tbody>
    … …  
    645626<td>
    646627        <p>
    647         <?php $hidetext = get_theme_mod( 'header_textcolor', HEADER_TEXTCOLOR ); ?>
    648         <label><input type="radio" value="1" name="hidetext" id="hidetext"<?php checked( ( 'blank' == $hidetext || empty( $hidetext ) )  ? true : false ); ?> /> <?php _e( 'No' ); ?></label>
    649         <label><input type="radio" value="0" name="hidetext" id="showtext"<?php checked( ( 'blank' == $hidetext || empty( $hidetext ) ) ? false : true ); ?> /> <?php _e( 'Yes' ); ?></label>
     628        <?php
     629                $show_text = get_header_textcolor();
     630                if ( 'blank' == $show_text )
     631                        $show_text = false;
     632                else
     633                        $show_text = (bool) $show_text;
     634        ?>
     635        <label><input type="radio" value="1" name="hidetext" id="hidetext"<?php checked( ! $show_text ); ?> /> <?php _e( 'No' ); ?></label>
     636        <label><input type="radio" value="0" name="hidetext" id="showtext"<?php checked( $show_text ); ?> /> <?php _e( 'Yes' ); ?></label>
    650637        </p>
    651638</td>
    … …  
    656643<td>
    657644        <p>
    658                 <input type="text" name="text-color" id="text-color" value="#<?php echo esc_attr( get_theme_mod( 'header_textcolor', HEADER_TEXTCOLOR ) ); ?>" />
     645                <input type="text" name="text-color" id="text-color" value="#<?php echo esc_attr( get_header_textcolor() ); ?>" />
    659646                <span class="description hide-if-js"><?php _e( 'If you want to hide header text, add <strong>#blank</strong> as text color.' );?></span>
    660647                <input type="button" class="button hide-if-no-js" value="<?php esc_attr_e( 'Select a Color' ); ?>" id="pickcolor" />
    … …  
    664651</tr>
    665652
    666         <?php if ( defined('HEADER_TEXTCOLOR') && get_theme_mod('header_textcolor') ) { ?>
     653        <?php if ( current_theme_supports( 'custom-header', 'default-text-color' ) && get_theme_mod( 'header_textcolor' ) ) { ?>
    667654<tr valign="top">
    668655<th scope="row"><?php _e('Reset Text Color'); ?></th>
    … …  
    695682        function step_2() {
    696683                check_admin_referer('custom-header-upload', '_wpnonce-custom-header-upload');
    697                 if ( ! current_theme_supports( 'custom-header-uploads' ) )
     684                if ( ! current_theme_supports( 'custom-header', 'uploads' ) )
    698685                        wp_die( __( 'Cheatin&#8217; uh?' ) );
    699686
    … …  
    723710                list($width, $height, $type, $attr) = getimagesize( $file );
    724711
    725                 $header_support = get_theme_support( 'custom-header' );
    726712                $max_width = 0;
    727713                // For flex, limit size of image displayed to 1500px unless theme says otherwise
    … …  
    729715                        $max_width = 1500;
    730716
    731                 if ( !empty( $header_support[ 0 ][ 'max-width' ] ) )
    732                         $max_width = max( $max_width, absint( $header_support[ 0 ][ 'max-width' ] ) );
    733 
    734                 if ( defined( 'HEADER_IMAGE_WIDTH' ) )
    735                         $max_width = max( $max_width, HEADER_IMAGE_WIDTH );
     717                if ( current_theme_supports( 'custom-header', 'max-width' ) )
     718                        $max_width = max( $max_width, get_theme_support( 'custom-header', 'max-width' ) );
     719                $max_width = max( $max_width, get_theme_support( 'custom-header', 'width' ) );
     720
    736721                // If flexible height isn't supported and the image is the exact right size
    737                 if ( ! current_theme_supports( 'custom-header', 'flex-height' ) && ! current_theme_supports( 'custom-header', 'flex-width' ) && $width == HEADER_IMAGE_WIDTH && $height == HEADER_IMAGE_HEIGHT ) {
     722                if ( ! current_theme_supports( 'custom-header', 'flex-height' ) && ! current_theme_supports( 'custom-header', 'flex-width' )
     723                        && $width == get_theme_support( 'custom-header', 'width' ) && $height == get_theme_support( 'custom-header', 'height' ) )
     724                {
    738725                        // Add the meta-data
    739726                        wp_update_attachment_metadata( $id, wp_generate_attachment_metadata( $id, $file ) );
    … …  
    792779         */
    793780        function step_3() {
    794                 check_admin_referer('custom-header-crop-image');
    795                 if ( ! current_theme_supports( 'custom-header-uploads' ) )
     781                check_admin_referer( 'custom-header-crop-image' );
     782
     783                if ( ! current_theme_supports( 'custom-header', 'uploads' ) )
    796784                        wp_die( __( 'Cheatin&#8217; uh?' ) );
    797785
    … …  
    806794                $original = get_attached_file($attachment_id);
    807795
    808                 $header_support = get_theme_support( 'custom-header' );
     796
    809797                $max_width = 0;
    810798                // For flex, limit size of image displayed to 1500px unless theme says otherwise
    … …  
    812800                        $max_width = 1500;
    813801
    814                 if ( !empty( $header_support[ 0 ][ 'max-width' ] ) )
    815                         $max_width = max( $max_width, absint( $header_support[ 0 ][ 'max-width' ] ) );
    816 
    817                 if ( defined( 'HEADER_IMAGE_WIDTH' ) )
    818                         $max_width = max( $max_width, HEADER_IMAGE_WIDTH );
     802                if ( current_theme_supports( 'custom-header', 'max-width' ) )
     803                        $max_width = max( $max_width, get_theme_support( 'custom-header', 'max-width' ) );
     804                $max_width = max( $max_width, get_theme_support( 'custom-header', 'width' ) );
    819805
    820806                if ( ( current_theme_supports( 'custom-header', 'flex-height' ) && ! current_theme_supports( 'custom-header', 'flex-width' ) ) || $_POST['width'] > $max_width )
    … …  
    823809                        $dst_height = absint( $_POST['height'] );
    824810                else
    825                         $dst_height = HEADER_IMAGE_HEIGHT;
     811                        $dst_height = get_theme_support( 'custom-header', 'height' );
    826812
    827813                if ( ( current_theme_supports( 'custom-header', 'flex-width' ) && ! current_theme_supports( 'custom-header', 'flex-height' ) ) || $_POST['width'] > $max_width )
    … …  
    830816                        $dst_width = absint( $_POST['width'] );
    831817                else
    832                         $dst_width = HEADER_IMAGE_WIDTH;
     818                        $dst_width = get_theme_support( 'custom-header', 'width' );
    833819
    834820                $cropped = wp_crop_image( $attachment_id, (int) $_POST['x1'], (int) $_POST['y1'], (int) $_POST['width'], (int) $_POST['height'], $dst_width, $dst_height );

  • trunk/wp-includes/class-wp-customize.php

    r20210 r20212  
    480480                        'sanitize_callback' => 'sanitize_hexcolor',
    481481                        'control'           => 'color',
    482                         'default'           => defined( 'HEADER_TEXTCOLOR' ) ? HEADER_TEXTCOLOR : ''
     482                        'default'           => get_theme_support( 'custom-header', 'default-text-color' ),
    483483                ) );
    484484
    … …  
    506506                         // @todo
    507507                         // not the default, it's the value.
    508                          // value is saved in get_theme_support( 'custom-header' )[0][ 'random-default' ]
     508                         // value is saved in get_theme_support( 'custom-header', 'random-default' )
    509509                        'default' => 'random-default-image'
    510510                ) );
    … …  
    523523                        'section'           => 'background',
    524524                        'control'           => 'color',
    525                         'default'           => defined( 'BACKGROUND_COLOR' ) ? BACKGROUND_COLOR : '',
     525                        'default'           => get_theme_support( 'custom-background', 'default-color' ),
    526526                        'sanitize_callback' => 'sanitize_hexcolor',
    527527                ) );

  • trunk/wp-includes/theme.php

    r20193 r20212  
    902902 *
    903903 * @since 2.1.0
    904  * @uses HEADER_TEXTCOLOR
    905904 *
    906905 * @return string
    907906 */
    908907function get_header_textcolor() {
    909         $default = defined('HEADER_TEXTCOLOR') ? HEADER_TEXTCOLOR : '';
    910 
    911         return get_theme_mod('header_textcolor', $default);
     908        return get_theme_mod('header_textcolor', get_theme_support( 'custom-header', 'default-text-color' ) );
    912909}
    913910
    … …  
    925922 *
    926923 * @since 2.1.0
    927  * @uses HEADER_IMAGE
    928924 *
    929925 * @return string
    930926 */
    931927function get_header_image() {
    932         $default = defined( 'HEADER_IMAGE' ) ? HEADER_IMAGE : '';
    933         $url = get_theme_mod( 'header_image', $default );
     928        $url = get_theme_mod( 'header_image', get_theme_support( 'custom-header', 'default-image' ) );
    934929
    935930        if ( 'remove-header' == $url )
    … …  
    971966                                $headers = $_wp_default_headers;
    972967                        } else {
    973                                 $is_random = get_theme_support( 'custom-header' );
    974                                 if ( isset( $is_random[ 0 ] ) && !empty( $is_random[ 0 ][ 'random-default' ] ) )
     968                                if ( current_theme_supports( 'custom-header', 'random-default' ) )
    975969                                        $headers = $_wp_default_headers;
    976970                        }
    … …  
    10111005 *
    10121006 * @since 3.2.0
    1013  * @uses HEADER_IMAGE
    10141007 *
    10151008 * @param string $type The random pool to use. any|default|uploaded
    … …  
    10171010 */
    10181011function is_random_header_image( $type = 'any' ) {
    1019         $default = defined( 'HEADER_IMAGE' ) ? HEADER_IMAGE : '';
    1020         $header_image_mod = get_theme_mod( 'header_image', $default );
     1012        $header_image_mod = get_theme_mod( 'header_image', get_theme_support( 'custom-header', 'default-image' ) );
    10211013
    10221014        if ( 'any' == $type ) {
    … …  
    10801072 * @return object
    10811073 */
    1082 function get_current_header_data() {
     1074function get_custom_header() {
    10831075        $data = is_random_header_image()? _get_random_header_data() : get_theme_mod( 'header_image_data' );
    10841076        $default = array(
    10851077                'url'           => '',
    10861078                'thumbnail_url' => '',
    1087                 'width'         => '',
    1088                 'height'        => '',
     1079                'width'         => get_theme_suppport( 'custom-header', 'width' ),
     1080                'height'        => get_theme_suppport( 'custom-header', 'height' ),
    10891081        );
    10901082        return (object) wp_parse_args( $data, $default );
    … …  
    10921084
    10931085/**
    1094  * Get the header image width.
    1095  *
    1096  * @since 3.4.0
    1097  *
    1098  * @return int
    1099  */
    1100 function get_header_image_width() {
    1101         return empty( get_current_header_data()->width )? HEADER_IMAGE_WIDTH : get_current_header_data()->width;
    1102 }
    1103 
    1104 /**
    1105  * Get the header image height.
    1106  *
    1107  * @since 3.4.0
    1108  *
    1109  * @return int
    1110  */
    1111 function get_header_image_height() {
    1112         return empty( get_current_header_data()->height )? HEADER_IMAGE_HEIGHT : get_current_header_data()->height;
    1113 }
    1114 
    1115 /**
    11161086 * Add callbacks for image header display.
    11171087 *
    1118  * The parameter $header_callback callback will be required to display the
    1119  * content for the 'wp_head' action. The parameter $admin_header_callback
    1120  * callback will be added to Custom_Image_Header class and that will be added
    1121  * to the 'admin_menu' action.
    1122  *
    11231088 * @since 2.1.0
    1124  * @uses Custom_Image_Header Sets up for $admin_header_callback for administration panel display.
     1089 * @deprecated 3.4.0
     1090 * @deprecated Use add_theme_support('custom-header', $args)
     1091 * @see add_theme_support()
    11251092 *
    11261093 * @param callback $header_callback Call on 'wp_head' action.
    … …  
    11291096 */
    11301097function add_custom_image_header( $header_callback, $admin_header_callback, $admin_image_div_callback = '' ) {
    1131         if ( ! empty( $header_callback ) )
    1132                 add_action('wp_head', $header_callback);
    1133 
    1134         $support = array( 'callback' => $header_callback );
    1135         $theme_support = get_theme_support( 'custom-header' );
    1136         if ( ! empty( $theme_support ) && is_array( $theme_support[ 0 ] ) )
    1137                 $support = array_merge( $theme_support[ 0 ], $support );
    1138         add_theme_support( 'custom-header',  $support );
    1139         add_theme_support( 'custom-header-uploads' );
    1140 
    1141         if ( ! is_admin() )
    1142                 return;
    1143 
    1144         global $custom_image_header;
    1145 
    1146         require_once( ABSPATH . 'wp-admin/custom-header.php' );
    1147         $custom_image_header = new Custom_Image_Header( $admin_header_callback, $admin_image_div_callback );
    1148         add_action( 'admin_menu', array( &$custom_image_header, 'init' ) );
     1098        # _deprecated_function( __FUNCTION__, '3.4', 'add_theme_support(\'custom-header\', $args)' );
     1099        return add_theme_support( 'custom-header', array(
     1100                'callback' => $header_callback,
     1101                'admin-header-callback' => $admin_header_callback,
     1102                'admin-image-div-callback' => $admin_image_div_callback,
     1103        ) );
    11491104}
    11501105
    … …  
    11531108 *
    11541109 * @since 3.1.0
    1155  * @see add_custom_image_header()
     1110 * @deprecated 3.4.0
     1111 * @deprecated Use remove_theme_support('custom-header')
     1112 * @see remove_theme_support()
    11561113 *
    11571114 * @return bool Whether support was removed.
    11581115 */
    11591116function remove_custom_image_header() {
    1160         if ( ! current_theme_supports( 'custom-header' ) )
    1161                 return false;
    1162 
    1163         $callback = get_theme_support( 'custom-header' );
    1164         remove_action( 'wp_head', $callback[0]['callback'] );
    1165         _remove_theme_support( 'custom-header' );
    1166         remove_theme_support( 'custom-header-uploads' );
    1167 
    1168         if ( is_admin() ) {
    1169                 remove_action( 'admin_menu', array( &$GLOBALS['custom_image_header'], 'init' ) );
    1170                 unset( $GLOBALS['custom_image_header'] );
    1171         }
    1172 
    1173         return true;
     1117        # _deprecated_function( __FUNCTION__, '3.4', 'remove_theme_support(\'custom-header\')' );
     1118        return remove_theme_support( 'custom-header' );
    11741119}
    11751120
    … …  
    12191164 */
    12201165function get_background_image() {
    1221         $default = defined('BACKGROUND_IMAGE') ? BACKGROUND_IMAGE : '';
    1222 
    1223         return get_theme_mod('background_image', $default);
     1166        return get_theme_mod('background_image', get_theme_support( 'custom-background', 'default-image' ) );
    12241167}
    12251168
    … …  
    12371180 *
    12381181 * @since 3.0.0
    1239  * @uses BACKGROUND_COLOR
    12401182 *
    12411183 * @return string
    12421184 */
    12431185function get_background_color() {
    1244         $default = defined('BACKGROUND_COLOR') ? BACKGROUND_COLOR : '';
    1245 
    1246         return get_theme_mod('background_color', $default);
     1186        return get_theme_mod('background_color', get_theme_support( 'custom-background', 'default-color' ) );
    12471187}
    12481188
    … …  
    12721212 */
    12731213function add_custom_background( $header_callback = '', $admin_header_callback = '', $admin_image_div_callback = '' ) {
    1274         if ( isset( $GLOBALS['custom_background'] ) )
    1275                 return;
    1276 
    1277         if ( empty( $header_callback ) )
    1278                 $header_callback = '_custom_background_cb';
    1279 
    1280         add_action( 'wp_head', $header_callback );
    1281 
    1282         add_theme_support( 'custom-background', array( 'callback' => $header_callback ) );
    1283 
    1284         if ( ! is_admin() )
    1285                 return;
    1286         require_once( ABSPATH . 'wp-admin/custom-background.php' );
    1287         $GLOBALS['custom_background'] = new Custom_Background( $admin_header_callback, $admin_image_div_callback );
    1288         add_action( 'admin_menu', array( &$GLOBALS['custom_background'], 'init' ) );
     1214        # _deprecated_function( __FUNCTION__, '3.4', 'add_theme_support(\'custom-background\', $args)' );
     1215        return add_theme_support( 'custom-background', array(
     1216                'callback' => $header_callback,
     1217                'admin-header-callback' => $admin_header_callback,
     1218                'admin-image-div-callback' => $admin_image_div_callback,
     1219        ) );
    12891220}
    12901221
    … …  
    12981229 */
    12991230function remove_custom_background() {
    1300         if ( ! current_theme_supports( 'custom-background' ) )
    1301                 return false;
    1302 
    1303         $callback = get_theme_support( 'custom-background' );
    1304         remove_action( 'wp_head', $callback[0]['callback'] );
    1305         _remove_theme_support( 'custom-background' );
    1306 
    1307         if ( is_admin() ) {
    1308                 remove_action( 'admin_menu', array( &$GLOBALS['custom_background'], 'init' ) );
    1309                 unset( $GLOBALS['custom_background'] );
    1310         }
    1311 
    1312         return true;
     1231        # _deprecated_function( __FUNCTION__, '3.4', 'remove_theme_support(\'custom-background\')' );
     1232        return remove_theme_support( 'custom-background' );
    13131233}
    13141234
    … …  
    13171237 *
    13181238 * @since 3.0.0
    1319  * @see add_custom_background()
    13201239 * @access protected
    13211240 */
    … …  
    14231342
    14241343        if ( func_num_args() == 1 )
    1425                 $_wp_theme_features[$feature] = true;
     1344                $args = true;
    14261345        else
    1427                 $_wp_theme_features[$feature] = array_slice( func_get_args(), 1 );
    1428 
    1429         if ( $feature == 'post-formats' && is_array( $_wp_theme_features[$feature][0] ) )
    1430                 $_wp_theme_features[$feature][0] = array_intersect( $_wp_theme_features[$feature][0], array_keys( get_post_format_slugs() ) );
    1431 }
     1346                $args = array_slice( func_get_args(), 1 );
     1347
     1348        switch ( $feature ) {
     1349                case 'post-formats' :
     1350                        if ( is_array( $args[0] ) )
     1351                                $args[0] = array_intersect( $args[0], array_keys( get_post_format_slugs() ) );
     1352                        break;
     1353
     1354                case 'custom-header-uploads' :
     1355                        return add_theme_support( 'custom-header', array( 'uploads' => true ) );
     1356                        break;
     1357
     1358                case 'custom-header' :
     1359                        $defaults = array(
     1360                                'default-image' => '',
     1361                                'random-default' => false,
     1362                                'width' => 0,
     1363                                'height' => 0,
     1364                                'flex-height' => false,
     1365                                'flex-width' => false,
     1366                                'default-text-color' => '',
     1367                                'header-text' => true,
     1368                                'uploads' => true,
     1369                                'callback' => '',
     1370                                'admin-header-callback' => '',
     1371                                'admin-image-div-callback' => '',
     1372                        );
     1373
     1374                        $jit = isset( $args[0]['__jit'] );
     1375                        unset( $args[0]['__jit'] );
     1376
     1377                        // Merge in data from previous add_theme_support() calls.
     1378                        // The first value registered wins. (A child theme is set up first.)
     1379                        if ( isset( $_wp_theme_features['custom-header'] ) )
     1380                                $args[0] = wp_parse_args( $_wp_theme_features['custom-header'][0], $args[0] );
     1381
     1382                        // Load in the defaults at the end, as we need to insure first one wins.
     1383                        // This will cause all constants to be defined, as each arg will then be set to the default.
     1384                        if ( $jit )
     1385                                $args[0] = wp_parse_args( $args[0], $defaults );
     1386
     1387                        // If a constant was defined, use that value. Otherwise, define the constant to ensure
     1388                        // the constant is always accurate (and is not defined later,  overriding our value).
     1389                        // As stated above, the first value wins.
     1390                        // Once we get to wp_loaded (just-in-time), define any constants we haven't already.
     1391                        // Constants are lame. Don't reference them. This is just for backwards compatibility.
     1392
     1393                        if ( defined( 'NO_HEADER_TEXT' ) )
     1394                                $args[0]['header-text'] = ! NO_HEADER_TEXT;
     1395                        elseif ( isset( $args[0]['header-text'] ) )
     1396                                define( 'NO_HEADER_TEXT', empty( $args[0]['header-text'] ) );
     1397
     1398                        if ( defined( 'HEADER_IMAGE_WIDTH' ) )
     1399                                $args[0]['width'] = (int) HEADER_IMAGE_WIDTH;
     1400                        elseif ( isset( $args[0]['width'] ) )
     1401                                define( 'HEADER_IMAGE_WIDTH', (int) $args[0]['width'] );
     1402
     1403                        if ( defined( 'HEADER_IMAGE_HEIGHT' ) )
     1404                                $args[0]['height'] = (int) HEADER_IMAGE_HEIGHT;
     1405                        elseif ( ! isset( $args[0]['height'] ) )
     1406                                define( 'HEADER_IMAGE_HEIGHT', (int) $args[0]['height'] );
     1407
     1408                        if ( defined( 'HEADER_TEXTCOLOR' ) )
     1409                                $args[0]['default-text-color'] = HEADER_TEXTCOLOR;
     1410                        elseif ( isset( $args[0]['default-text-color'] ) )
     1411                                define( 'HEADER_TEXTCOLOR', $args[0]['default-text-color'] );
     1412
     1413                        if ( defined( 'HEADER_IMAGE' ) )
     1414                                $args[0]['default-image'] = HEADER_IMAGE;
     1415
     1416                        if ( $jit && ! empty( $args[0]['default-image'] ) )
     1417                                $args[0]['random-default'] = false;
     1418
     1419                        if ( ! defined( 'HEADER_IMAGE' ) && ( isset( $args[0]['default-image'] ) || isset( $args[0]['random-default'] ) ) )
     1420                                define( 'HEADER_IMAGE', $args[0]['default-image'] );
     1421
     1422                        // If headers are supported, and we still don't have a defined width or height,
     1423                        // we have implicit flex sizes.
     1424                        if ( $jit ) {
     1425                                if ( empty( $args[0]['width'] ) && empty( $args[0]['flex-width'] ) )
     1426                                        $args[0]['flex-width'] = true;
     1427                                if ( empty( $args[0]['height'] ) && empty( $args[0]['flex-height'] ) )
     1428                                        $args[0]['flex-height'] = true;
     1429                        }
     1430
     1431                        break;
     1432
     1433                case 'custom-background' :
     1434                        $defaults = array(
     1435                                'default-image' => '',
     1436                                'default-color' => '',
     1437                                'callback' => '',
     1438                                'admin-header-callback' => '',
     1439                                'admin-image-div-callback' => '',
     1440                        );
     1441
     1442                        $jit = isset( $args[0]['__jit'] );
     1443                        unset( $args[0]['__jit'] );
     1444
     1445                        // Merge in data from previous add_theme_support() calls. The first value registered wins.
     1446                        if ( isset( $_wp_theme_features['custom-background'] ) )
     1447                                $args[0] = wp_parse_args( $_wp_theme_features['custom-background'][0], $args[0] );
     1448
     1449                        if ( $jit )
     1450                                $args[0] = wp_parse_args( $args[0], $defaults );
     1451
     1452                        if ( defined( 'BACKGROUND_COLOR' ) )
     1453                                $args[0]['default-color'] = BACKGROUND_COLOR;
     1454                        elseif ( isset( $args[0]['default-color'] ) || $jit )
     1455                                define( 'BACKGROUND_COLOR', $args[0]['default-color'] );
     1456
     1457                        if ( defined( 'BACKGROUND_IMAGE' ) )
     1458                                $args[0]['default-image'] = BACKGROUND_IMAGE;
     1459                        elseif ( isset( $args[0]['default-image'] ) || $jit )
     1460                                define( 'BACKGROUND_IMAGE', $args[0]['default-image'] );
     1461
     1462                        if ( empty( $args[0]['callback'] ) )
     1463                                $args[0]['callback'] = '_custom_background_cb';
     1464
     1465                        break;
     1466        }
     1467
     1468        $_wp_theme_features[ $feature ] = $args;
     1469}
     1470
     1471/**
     1472 * Registers the internal custom header and background routines.
     1473 *
     1474 * @since 3.4.0
     1475 * @access private
     1476 */
     1477function _custom_header_background_just_in_time() {
     1478        global $custom_image_header, $custom_background;
     1479
     1480        if ( current_theme_supports( 'custom-header' ) ) {
     1481                // In case any constants were defined after an add_custom_image_header() call, re-run.
     1482                add_theme_support( 'custom-header', array( '__jit' => true ) );
     1483
     1484                $args = get_theme_support( 'custom-header' );
     1485                if ( $args[0]['callback'] )
     1486                        add_action( 'wp_head', $args[0]['callback'] );
     1487
     1488                if ( is_admin() ) {
     1489                        require_once( ABSPATH . 'wp-admin/custom-header.php' );
     1490                        $custom_image_header = new Custom_Image_Header( $args[0]['admin-header-callback'], $args[0]['admin-image-div-callback'] );
     1491                }
     1492        }
     1493
     1494        if ( current_theme_supports( 'custom-background' ) ) {
     1495                // In case any constants were defined after an add_custom_background() call, re-run.
     1496                add_theme_support( 'custom-background', array( '__jit' => true ) );
     1497
     1498                $args = get_theme_support( 'custom-background' );
     1499                add_action( 'wp_head', $args[0]['callback'] );
     1500
     1501                if ( is_admin() ) {
     1502                        require_once( ABSPATH . 'wp-admin/custom-background.php' );
     1503                        $custom_background = new Custom_Background( $args[0]['admin-header-callback'], $args[0]['admin-image-div-callback'] );
     1504                }
     1505        }               
     1506}
     1507add_action( 'wp_loaded', '_custom_header_background_just_in_time' );
    14321508
    14331509/**
    … …  
    14401516function get_theme_support( $feature ) {
    14411517        global $_wp_theme_features;
    1442         if ( !isset( $_wp_theme_features[$feature] ) )
     1518        if ( ! isset( $_wp_theme_features[ $feature ] ) )
    14431519                return false;
    1444         else
    1445                 return $_wp_theme_features[$feature];
     1520
     1521        if ( func_num_args() <= 1 )
     1522                return $_wp_theme_features[ $feature ];
     1523
     1524        $args = array_slice( func_get_args(), 1 );
     1525        switch ( $feature ) {
     1526                case 'custom-header' :
     1527                case 'custom-background' :
     1528                        if ( isset( $_wp_theme_features[ $feature ][0][ $args[0] ] ) )
     1529                                return $_wp_theme_features[ $feature ][0][ $args[0] ];
     1530                        return false;
     1531                        break;
     1532                default :
     1533                        return $_wp_theme_features[ $feature ];
     1534                        break;
     1535        }
    14461536}
    14471537
    … …  
    14591549function remove_theme_support( $feature ) {
    14601550        // Blacklist: for internal registrations not used directly by themes.
    1461         if ( in_array( $feature, array( 'custom-background', 'custom-header', 'editor-style', 'widgets', 'menus' ) ) )
     1551        if ( in_array( $feature, array( 'editor-style', 'widgets', 'menus' ) ) )
    14621552                return false;
     1553
    14631554        return _remove_theme_support( $feature );
    14641555}
    … …  
    14731564        global $_wp_theme_features;
    14741565
    1475         if ( ! isset( $_wp_theme_features[$feature] ) )
     1566        switch ( $feature ) {
     1567                case 'custom-header-uploads' :
     1568                        if ( ! isset( $_wp_theme_features['custom-header'] ) )
     1569                                return false;
     1570                        add_theme_support( 'custom-header', array( 'uploads' => false ) );
     1571                        return; // Do not continue - custom-header-uploads no longer exists.
     1572        }
     1573
     1574        if ( ! isset( $_wp_theme_features[ $feature ] ) )
    14761575                return false;
    1477         unset( $_wp_theme_features[$feature] );
     1576
     1577        switch ( $feature ) {
     1578                case 'custom-header' :
     1579                        $support = get_theme_support( 'custom-header' );
     1580                        if ( $support[0]['callback'] )
     1581                                remove_action( 'wp_head', $support[0]['callback'] );
     1582                        remove_action( 'admin_menu', array( $GLOBALS['custom_image_header'], 'init' ) );
     1583                        unset( $GLOBALS['custom_image_header'] );
     1584                        break;
     1585
     1586                case 'custom-header' :
     1587                        $support = get_theme_support( 'custom-background' );
     1588                        remove_action( 'wp_head', $support[0]['callback'] );
     1589                        remove_action( 'admin_menu', array( $GLOBALS['custom_background'], 'init' ) );
     1590                        unset( $GLOBALS['custom_background'] );
     1591                        break;
     1592        }
     1593
     1594        unset( $_wp_theme_features[ $feature ] );
    14781595        return true;
    14791596}
    … …  
    14881605function current_theme_supports( $feature ) {
    14891606        global $_wp_theme_features;
     1607
     1608        if ( 'custom-header-uploads' == $feature )
     1609                return current_theme_supports( 'custom-header', 'uploads' );
    14901610
    14911611        if ( !isset( $_wp_theme_features[$feature] ) )
Note: See TracChangeset for help on using the changeset viewer.