2007-05-01 13:46:55 -04:00
< ? php
2008-08-16 03:27:34 -04:00
/**
* The custom header image script .
*
* @ package WordPress
* @ subpackage Administration
*/
/**
* The custom header image class .
*
2010-03-30 14:55:35 -04:00
* @ since 2.1 . 0
2008-08-16 03:27:34 -04:00
* @ package WordPress
* @ subpackage Administration
*/
2007-05-01 13:46:55 -04:00
class Custom_Image_Header {
2008-08-16 03:27:34 -04:00
/**
* Callback for administration header .
*
2015-09-25 19:58:25 -04:00
* @ var callable
2010-03-30 14:55:35 -04:00
* @ since 2.1 . 0
2008-08-16 03:27:34 -04:00
*/
2015-01-10 17:11:22 -05:00
public $admin_header_callback ;
2007-05-01 13:46:55 -04:00
2010-01-28 14:00:16 -05:00
/**
* Callback for header div .
*
2015-09-25 19:58:25 -04:00
* @ var callable
2010-03-26 15:13:36 -04:00
* @ since 3.0 . 0
2010-01-28 14:00:16 -05:00
*/
2015-01-10 17:11:22 -05:00
public $admin_image_div_callback ;
2010-01-28 14:00:16 -05:00
2010-03-30 14:55:35 -04:00
/**
* Holds default headers .
*
* @ var array
* @ since 3.0 . 0
* @ access private
*/
2015-01-10 17:11:22 -05:00
public $default_headers = array ();
2010-05-27 20:27:53 -04:00
2014-11-03 00:15:22 -05:00
/**
2015-09-24 09:39:25 -04:00
* Used to trigger a success message when settings updated and set to true .
*
* @ since 3.0 . 0
* @ access private
2014-11-03 00:15:22 -05:00
* @ var bool
*/
private $updated ;
2008-08-16 03:27:34 -04:00
/**
2011-04-29 16:05:12 -04:00
* Constructor - Register administration header callback .
2008-08-16 03:27:34 -04:00
*
2010-03-30 14:55:35 -04:00
* @ since 2.1 . 0
2015-09-25 19:58:25 -04:00
* @ param callable $admin_header_callback
* @ param callable $admin_image_div_callback Optional custom image div output callback .
2008-08-16 03:27:34 -04:00
*/
2014-05-18 17:31:16 -04:00
public function __construct ( $admin_header_callback , $admin_image_div_callback = '' ) {
2007-05-01 13:46:55 -04:00
$this -> admin_header_callback = $admin_header_callback ;
2010-01-28 14:00:16 -05:00
$this -> admin_image_div_callback = $admin_image_div_callback ;
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.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20212 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-19 13:12:44 -04:00
add_action ( 'admin_menu' , array ( $this , 'init' ) );
2014-03-11 00:13:16 -04:00
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' ) );
2007-05-01 13:46:55 -04:00
}
2008-08-16 03:27:34 -04:00
/**
2010-03-17 00:39:50 -04:00
* Set up the hooks for the Custom Header admin page .
2008-08-16 03:27:34 -04:00
*
2010-03-30 14:55:35 -04:00
* @ since 2.1 . 0
2008-08-16 03:27:34 -04:00
*/
2014-05-18 17:31:16 -04:00
public function init () {
2015-01-09 16:07:22 -05:00
$page = add_theme_page ( __ ( 'Header' ), __ ( 'Header' ), 'edit_theme_options' , 'custom-header' , array ( $this , 'admin_page' ) );
if ( ! $page ) {
2010-02-10 11:49:16 -05:00
return ;
2015-01-09 16:07:22 -05:00
}
2010-02-10 11:49:16 -05:00
2015-01-09 16:07:22 -05:00
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 );
}
2007-05-01 13:46:55 -04:00
}
2010-05-27 20:27:53 -04:00
/**
* Adds contextual help .
*
* @ since 3.0 . 0
*/
2014-05-18 17:31:16 -04:00
public function help () {
2011-11-30 21:28:47 -05:00
get_current_screen () -> add_help_tab ( array (
'id' => 'overview' ,
'title' => __ ( 'Overview' ),
'content' =>
2012-05-03 17:54:50 -04:00
'<p>' . __ ( 'This screen is used to customize the header section of your theme.' ) . '</p>' .
'<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>'
) );
2012-05-27 12:25:43 -04:00
2012-05-03 17:54:50 -04:00
get_current_screen () -> add_help_tab ( array (
'id' => 'set-header-image' ,
'title' => __ ( 'Header Image' ),
'content' =>
2012-06-04 10:13:20 -04:00
'<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>' .
2012-05-03 17:54:50 -04:00
'<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>' .
'<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>' .
2012-05-11 03:12:20 -04:00
'<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>'
2012-05-03 17:54:50 -04:00
) );
2012-05-27 12:25:43 -04:00
2012-05-03 17:54:50 -04:00
get_current_screen () -> add_help_tab ( array (
'id' => 'set-header-text' ,
'title' => __ ( 'Header Text' ),
'content' =>
2012-05-03 18:00:25 -04:00
'<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>' .
2012-11-08 14:32:49 -05:00
'<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>' .
2012-11-22 03:45:15 -05:00
'<p>' . __ ( 'Don’t forget to click “Save Changes” when you’re done!' ) . '</p>'
2011-11-30 21:22:07 -05:00
) );
2011-11-01 23:12:37 -04:00
2011-11-02 16:14:10 -04:00
get_current_screen () -> set_help_sidebar (
2011-11-01 23:12:37 -04:00
'<p><strong>' . __ ( 'For more information:' ) . '</strong></p>' .
2015-04-12 17:29:32 -04:00
'<p>' . __ ( '<a href="https://codex.wordpress.org/Appearance_Header_Screen" target="_blank">Documentation on Custom Header</a>' ) . '</p>' .
2014-03-07 23:14:15 -05:00
'<p>' . __ ( '<a href="https://wordpress.org/support/" target="_blank">Support Forums</a>' ) . '</p>'
2011-11-01 23:12:37 -04:00
);
2010-05-27 20:27:53 -04:00
}
2008-08-16 03:27:34 -04:00
/**
* Get the current step .
*
2010-03-30 14:55:35 -04:00
* @ since 2.6 . 0
2008-08-16 03:27:34 -04:00
*
* @ return int Current step
*/
2014-05-18 17:31:16 -04:00
public function step () {
2008-08-16 03:27:34 -04:00
if ( ! isset ( $_GET [ 'step' ] ) )
return 1 ;
$step = ( int ) $_GET [ 'step' ];
2012-04-04 20:20:28 -04:00
if ( $step < 1 || 3 < $step ||
( 2 == $step && ! wp_verify_nonce ( $_REQUEST [ '_wpnonce-custom-header-upload' ], 'custom-header-upload' ) ) ||
( 3 == $step && ! wp_verify_nonce ( $_REQUEST [ '_wpnonce' ], 'custom-header-crop-image' ) )
)
return 1 ;
2008-08-16 03:27:34 -04:00
2008-04-16 16:58:03 -04:00
return $step ;
2007-05-01 13:46:55 -04:00
}
2008-08-16 03:27:34 -04:00
/**
2010-03-17 00:39:50 -04:00
* Set up the enqueue for the JavaScript files .
2008-08-16 03:27:34 -04:00
*
2010-03-30 14:55:35 -04:00
* @ since 2.1 . 0
2008-08-16 03:27:34 -04:00
*/
2014-05-18 17:31:16 -04:00
public function js_includes () {
2008-04-16 16:58:03 -04:00
$step = $this -> step ();
2008-08-16 03:27:34 -04:00
2012-04-04 20:20:28 -04:00
if ( ( 1 == $step || 3 == $step ) ) {
2012-11-09 06:59:05 -05:00
wp_enqueue_media ();
2012-04-04 20:20:28 -04:00
wp_enqueue_script ( 'custom-header' );
if ( current_theme_supports ( 'custom-header' , 'header-text' ) )
2012-09-26 21:57:38 -04:00
wp_enqueue_script ( 'wp-color-picker' );
2012-04-04 20:20:28 -04:00
} elseif ( 2 == $step ) {
2010-05-25 18:05:51 -04:00
wp_enqueue_script ( 'imgareaselect' );
2012-04-04 20:20:28 -04:00
}
2008-04-16 16:58:03 -04:00
}
2007-05-01 13:46:55 -04:00
2008-08-28 13:42:21 -04:00
/**
2010-03-17 00:39:50 -04:00
* Set up the enqueue for the CSS files
2008-08-28 13:42:21 -04:00
*
2013-12-24 13:57:12 -05:00
* @ since 2.7 . 0
2008-08-28 13:42:21 -04:00
*/
2014-05-18 17:31:16 -04:00
public function css_includes () {
2008-08-28 13:42:21 -04:00
$step = $this -> step ();
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.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20212 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-19 13:12:44 -04:00
if ( ( 1 == $step || 3 == $step ) && current_theme_supports ( 'custom-header' , 'header-text' ) )
2012-09-26 21:57:38 -04:00
wp_enqueue_style ( 'wp-color-picker' );
2009-03-27 12:45:55 -04:00
elseif ( 2 == $step )
2010-05-25 18:05:51 -04:00
wp_enqueue_style ( 'imgareaselect' );
}
2010-05-25 22:42:15 -04:00
2008-08-16 03:27:34 -04:00
/**
* Execute custom header modification .
*
2010-03-30 14:55:35 -04:00
* @ since 2.6 . 0
2008-08-16 03:27:34 -04:00
*/
2014-05-18 17:31:16 -04:00
public function take_action () {
2010-05-12 15:19:57 -04:00
if ( ! current_user_can ( 'edit_theme_options' ) )
2010-02-10 11:49:16 -05:00
return ;
2010-05-25 18:05:51 -04:00
if ( empty ( $_POST ) )
return ;
$this -> updated = true ;
if ( isset ( $_POST [ 'resetheader' ] ) ) {
check_admin_referer ( 'custom-header-options' , '_wpnonce-custom-header-options' );
2012-06-09 20:32:19 -04:00
$this -> reset_header_image ();
2010-05-25 18:05:51 -04:00
return ;
}
if ( isset ( $_POST [ 'removeheader' ] ) ) {
check_admin_referer ( 'custom-header-options' , '_wpnonce-custom-header-options' );
2012-06-09 20:32:19 -04:00
$this -> remove_header_image ();
2010-05-25 18:05:51 -04:00
return ;
}
2012-03-21 16:55:58 -04:00
if ( isset ( $_POST [ 'text-color' ] ) && ! isset ( $_POST [ 'display-header-text' ] ) ) {
2012-03-21 15:10:13 -04:00
check_admin_referer ( 'custom-header-options' , '_wpnonce-custom-header-options' );
set_theme_mod ( 'header_textcolor' , 'blank' );
} elseif ( isset ( $_POST [ 'text-color' ] ) ) {
2010-05-25 18:05:51 -04:00
check_admin_referer ( 'custom-header-options' , '_wpnonce-custom-header-options' );
$_POST [ 'text-color' ] = str_replace ( '#' , '' , $_POST [ 'text-color' ] );
2012-03-21 15:10:13 -04:00
$color = preg_replace ( '/[^0-9a-fA-F]/' , '' , $_POST [ 'text-color' ]);
if ( strlen ( $color ) == 6 || strlen ( $color ) == 3 )
set_theme_mod ( 'header_textcolor' , $color );
elseif ( ! $color )
2010-05-25 18:05:51 -04:00
set_theme_mod ( 'header_textcolor' , 'blank' );
2007-05-01 13:46:55 -04:00
}
2010-02-25 14:32:10 -05:00
2011-04-28 19:02:16 -04:00
if ( isset ( $_POST [ 'default-header' ] ) ) {
2010-05-25 18:05:51 -04:00
check_admin_referer ( 'custom-header-options' , '_wpnonce-custom-header-options' );
2012-06-09 20:32:19 -04:00
$this -> set_header_image ( $_POST [ 'default-header' ] );
return ;
2010-02-25 14:18:44 -05:00
}
}
/**
* Process the default headers
*
2010-03-30 14:55:35 -04:00
* @ since 3.0 . 0
2015-05-28 17:41:30 -04:00
*
* @ global array $_wp_default_headers
2010-02-25 14:18:44 -05:00
*/
2014-05-18 17:31:16 -04:00
public function process_default_headers () {
2010-02-25 14:18:44 -05:00
global $_wp_default_headers ;
if ( ! isset ( $_wp_default_headers ) )
return ;
2014-05-06 01:07:13 -04:00
if ( ! empty ( $this -> default_headers ) ) {
2014-03-29 06:53:15 -04:00
return ;
}
2010-02-25 14:18:44 -05:00
$this -> default_headers = $_wp_default_headers ;
2011-08-04 08:40:15 -04:00
$template_directory_uri = get_template_directory_uri ();
$stylesheet_directory_uri = get_stylesheet_directory_uri ();
2010-02-25 14:18:44 -05:00
foreach ( array_keys ( $this -> default_headers ) as $header ) {
2011-08-04 08:40:15 -04:00
$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 );
2010-02-25 14:18:44 -05:00
}
}
/**
* Display UI for selecting one of several default headers .
*
2011-04-28 19:02:16 -04:00
* Show the random image option if this theme has multiple header images .
* Random image option is on by default if no header has been set .
*
2010-02-25 14:18:44 -05:00
* @ since 3.0 . 0
2016-01-09 20:26:25 -05:00
*
* @ param string $type The header type . One of 'default' ( for the Uploaded Images control )
* or 'uploaded' ( for the Uploaded Images control ) .
2010-02-25 14:18:44 -05:00
*/
2014-05-18 17:31:16 -04:00
public function show_header_selector ( $type = 'default' ) {
2011-04-28 19:02:16 -04:00
if ( 'default' == $type ) {
$headers = $this -> default_headers ;
} else {
$headers = get_uploaded_header_images ();
$type = 'uploaded' ;
}
2011-05-05 16:15:19 -04:00
if ( 1 < count ( $headers ) ) {
echo '<div class="random-header">' ;
echo '<label><input name="default-header" type="radio" value="random-' . $type . '-image"' . checked ( is_random_header_image ( $type ), true , false ) . ' />' ;
2015-05-03 12:18:28 -04:00
_e ( '<strong>Random:</strong> Show a different image on each page.' );
2011-05-05 16:15:19 -04:00
echo '</label>' ;
echo '</div>' ;
}
echo '<div class="available-headers">' ;
2011-04-28 19:02:16 -04:00
foreach ( $headers as $header_key => $header ) {
2010-05-25 18:05:51 -04:00
$header_thumbnail = $header [ 'thumbnail_url' ];
$header_url = $header [ 'url' ];
2015-12-13 19:09:27 -05:00
$header_alt_text = empty ( $header [ 'alt_text' ] ) ? '' : $header [ 'alt_text' ];
2011-04-28 19:02:16 -04:00
echo '<div class="default-header">' ;
echo '<label><input name="default-header" type="radio" value="' . esc_attr ( $header_key ) . '" ' . checked ( $header_url , get_theme_mod ( 'header_image' ), false ) . ' />' ;
$width = '' ;
2012-02-02 18:35:37 -05:00
if ( ! empty ( $header [ 'attachment_id' ] ) )
2011-04-28 19:02:16 -04:00
$width = ' width="230"' ;
2015-12-13 19:09:27 -05:00
echo '<img src="' . set_url_scheme ( $header_thumbnail ) . '" alt="' . esc_attr ( $header_alt_text ) . '"' . $width . ' /></label>' ;
2011-04-28 19:02:16 -04:00
echo '</div>' ;
}
2010-05-25 18:05:51 -04:00
echo '<div class="clear"></div></div>' ;
2007-05-01 13:46:55 -04:00
}
2008-08-16 03:27:34 -04:00
/**
2014-12-01 19:31:22 -05:00
* Execute JavaScript depending on step .
2008-08-16 03:27:34 -04:00
*
2010-03-30 14:55:35 -04:00
* @ since 2.1 . 0
2008-08-16 03:27:34 -04:00
*/
2014-05-18 17:31:16 -04:00
public function js () {
2008-04-16 16:58:03 -04:00
$step = $this -> step ();
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.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20212 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-19 13:12:44 -04:00
if ( ( 1 == $step || 3 == $step ) && current_theme_supports ( 'custom-header' , 'header-text' ) )
2008-04-16 16:58:03 -04:00
$this -> js_1 ();
elseif ( 2 == $step )
$this -> js_2 ();
}
2007-05-01 13:46:55 -04:00
2008-08-16 03:27:34 -04:00
/**
2014-12-01 19:31:22 -05:00
* Display JavaScript based on Step 1 and 3.
2008-08-16 03:27:34 -04:00
*
2010-03-30 14:55:35 -04:00
* @ since 2.6 . 0
2008-08-16 03:27:34 -04:00
*/
2014-05-18 17:31:16 -04:00
public function js_1 () {
2014-05-06 11:27:54 -04:00
$default_color = '' ;
if ( current_theme_supports ( 'custom-header' , 'default-text-color' ) ) {
$default_color = get_theme_support ( 'custom-header' , 'default-text-color' );
if ( $default_color && false === strpos ( $default_color , '#' ) ) {
$default_color = '#' . $default_color ;
}
}
?>
2008-04-16 16:58:03 -04:00
< script type = " text/javascript " >
2012-03-21 15:10:13 -04:00
( function ( $ ){
2020-10-29 15:00:24 -04:00
var default_color = '<?php echo esc_js( $default_color ); ?>' ,
2012-03-21 15:10:13 -04:00
header_text_fields ;
2007-05-01 13:46:55 -04:00
2014-05-18 17:43:14 -04:00
function pickColor ( color ) {
2012-03-21 15:10:13 -04:00
$ ( '#name' ) . css ( 'color' , color );
$ ( '#desc' ) . css ( 'color' , color );
$ ( '#text-color' ) . val ( color );
2007-05-01 13:46:55 -04:00
}
2008-12-09 13:03:31 -05:00
2014-05-18 17:43:14 -04:00
function toggle_text () {
2012-03-21 15:10:13 -04:00
var checked = $ ( '#display-header-text' ) . prop ( 'checked' ),
text_color ;
header_text_fields . toggle ( checked );
if ( ! checked )
2010-05-25 18:05:51 -04:00
return ;
2012-03-21 15:10:13 -04:00
text_color = $ ( '#text-color' );
if ( '' == text_color . val () . replace ( '#' , '' ) ) {
text_color . val ( default_color );
pickColor ( default_color );
2010-05-25 18:05:51 -04:00
} else {
2012-03-21 15:10:13 -04:00
pickColor ( text_color . val () );
2010-05-25 18:05:51 -04:00
}
}
2012-03-21 15:10:13 -04:00
$ ( document ) . ready ( function () {
2012-09-26 21:57:38 -04:00
var text_color = $ ( '#text-color' );
2012-03-21 15:10:13 -04:00
header_text_fields = $ ( '.displaying-header-text' );
2012-09-26 21:57:38 -04:00
text_color . wpColorPicker ({
change : function ( event , ui ) {
pickColor ( text_color . wpColorPicker ( 'color' ) );
},
clear : function () {
pickColor ( '' );
}
2008-08-28 13:42:21 -04:00
});
2012-03-21 15:10:13 -04:00
$ ( '#display-header-text' ) . click ( toggle_text );
2012-09-26 21:57:38 -04:00
< ? php if ( ! display_header_text () ) : ?>
2012-04-04 20:20:28 -04:00
toggle_text ();
2012-09-26 21:57:38 -04:00
< ? php endif ; ?>
2011-05-23 19:33:30 -04:00
});
2012-03-21 15:10:13 -04:00
})( jQuery );
2007-05-01 13:46:55 -04:00
</ script >
< ? php
}
2008-08-16 03:27:34 -04:00
/**
2014-12-01 19:31:22 -05:00
* Display JavaScript based on Step 2.
2008-08-16 03:27:34 -04:00
*
2010-03-30 14:55:35 -04:00
* @ since 2.6 . 0
2008-08-16 03:27:34 -04:00
*/
2014-05-18 17:31:16 -04:00
public function js_2 () { ?>
2008-04-16 16:58:03 -04:00
< script type = " text/javascript " >
2014-05-18 17:43:14 -04:00
function onEndCrop ( coords ) {
2009-03-27 12:45:55 -04:00
jQuery ( '#x1' ) . val ( coords . x );
jQuery ( '#y1' ) . val ( coords . y );
jQuery ( '#width' ) . val ( coords . w );
jQuery ( '#height' ) . val ( coords . h );
2008-04-16 16:58:03 -04:00
}
2008-08-28 13:42:21 -04:00
jQuery ( document ) . ready ( function () {
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.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20212 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-19 13:12:44 -04:00
var xinit = < ? php echo absint ( get_theme_support ( 'custom-header' , 'width' ) ); ?> ;
var yinit = < ? php echo absint ( get_theme_support ( 'custom-header' , 'height' ) ); ?> ;
2008-08-28 13:42:21 -04:00
var ratio = xinit / yinit ;
2010-06-14 04:25:34 -04:00
var ximg = jQuery ( 'img#upload' ) . width ();
var yimg = jQuery ( 'img#upload' ) . height ();
2009-04-20 14:18:39 -04:00
2008-08-28 13:42:21 -04:00
if ( yimg < yinit || ximg < xinit ) {
if ( ximg / yimg > ratio ) {
yinit = yimg ;
xinit = yinit * ratio ;
} else {
xinit = ximg ;
yinit = xinit / ratio ;
2008-04-16 16:58:03 -04:00
}
}
2009-03-27 12:45:55 -04:00
2010-06-14 04:25:34 -04:00
jQuery ( 'img#upload' ) . imgAreaSelect ({
2010-05-25 18:05:51 -04:00
handles : true ,
keys : true ,
show : true ,
x1 : 0 ,
y1 : 0 ,
x2 : xinit ,
y2 : yinit ,
2012-02-02 18:35:37 -05:00
< ? php
if ( ! current_theme_supports ( 'custom-header' , 'flex-height' ) && ! current_theme_supports ( 'custom-header' , 'flex-width' ) ) {
?>
aspectRatio : xinit + ':' + yinit ,
< ? php
}
if ( ! current_theme_supports ( 'custom-header' , 'flex-height' ) ) {
?>
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.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20212 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-19 13:12:44 -04:00
maxHeight : < ? php echo get_theme_support ( 'custom-header' , 'height' ); ?> ,
2012-02-02 18:35:37 -05:00
< ? php
}
if ( ! current_theme_supports ( 'custom-header' , 'flex-width' ) ) {
?>
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.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20212 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-19 13:12:44 -04:00
maxWidth : < ? php echo get_theme_support ( 'custom-header' , 'width' ); ?> ,
2012-02-02 18:35:37 -05:00
< ? php
}
?>
2014-05-18 17:43:14 -04:00
onInit : function () {
2010-05-25 18:05:51 -04:00
jQuery ( '#width' ) . val ( xinit );
jQuery ( '#height' ) . val ( yinit );
},
onSelectChange : function ( img , c ) {
jQuery ( '#x1' ) . val ( c . x1 );
jQuery ( '#y1' ) . val ( c . y1 );
jQuery ( '#width' ) . val ( c . width );
jQuery ( '#height' ) . val ( c . height );
}
2009-03-27 12:45:55 -04:00
});
2008-08-28 13:42:21 -04:00
});
2008-04-16 16:58:03 -04:00
</ script >
< ? php
}
2008-08-16 03:27:34 -04:00
/**
* Display first step of custom header image page .
*
2010-03-30 14:55:35 -04:00
* @ since 2.1 . 0
2008-08-16 03:27:34 -04:00
*/
2014-05-18 17:31:16 -04:00
public function step_1 () {
2010-02-25 14:18:44 -05:00
$this -> process_default_headers ();
2010-05-25 18:05:51 -04:00
?>
2007-05-01 13:46:55 -04:00
< div class = " wrap " >
2015-06-27 11:41:25 -04:00
< h1 >< ? php _e ( 'Custom Header' ); ?> </h1>
2010-03-18 15:06:57 -04:00
2014-11-20 10:29:23 -05:00
< ? php if ( current_user_can ( 'customize' ) ) { ?>
2014-11-30 07:21:22 -05:00
< div class = " notice notice-info hide-if-no-customize " >
2014-11-20 10:29:23 -05:00
< p >
< ? php
printf (
__ ( 'You can now manage and live-preview Custom Header in the <a href="%1$s">Customizer</a>.' ),
admin_url ( 'customize.php?autofocus[control]=header_image' )
);
?>
</ p >
</ div >
< ? php } ?>
2010-05-25 18:05:51 -04:00
< ? php if ( ! empty ( $this -> updated ) ) { ?>
2010-03-18 15:06:57 -04:00
< div id = " message " class = " updated " >
2010-05-04 13:13:11 -04:00
< p >< ? php printf ( __ ( 'Header updated. <a href="%s">Visit your site</a> to see how it looks.' ), home_url ( '/' ) ); ?> </p>
2010-03-18 15:06:57 -04:00
</ div >
2007-05-01 13:46:55 -04:00
< ? php } ?>
2012-03-21 15:10:13 -04:00
< h3 >< ? php _e ( 'Header Image' ); ?> </h3>
2010-05-25 18:05:51 -04:00
< table class = " form-table " >
< tbody >
2007-05-01 13:46:55 -04:00
2013-08-27 08:27:10 -04:00
< ? php if ( get_custom_header () || display_header_text () ) : ?>
2014-01-24 14:06:15 -05:00
< tr >
2010-05-25 18:05:51 -04:00
< th scope = " row " >< ? php _e ( 'Preview' ); ?> </th>
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.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20212 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-19 13:12:44 -04:00
< td >
2013-12-29 03:06:11 -05:00
< ? php
if ( $this -> admin_image_div_callback ) {
call_user_func ( $this -> admin_image_div_callback );
2010-05-25 18:05:51 -04:00
} else {
2012-08-14 15:24:36 -04:00
$custom_header = get_custom_header ();
2015-01-10 16:08:22 -05:00
$header_image = get_header_image ();
if ( $header_image ) {
$header_image_style = 'background-image:url(' . esc_url ( $header_image ) . ');' ;
} else {
$header_image_style = '' ;
}
2012-08-14 15:24:36 -04:00
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;' ;
2010-05-25 18:05:51 -04:00
?>
2012-08-14 15:24:36 -04:00
< div id = " headimg " style = " <?php echo $header_image_style ; ?> " >
2010-05-25 18:05:51 -04:00
< ? php
2012-03-21 15:10:13 -04:00
if ( display_header_text () )
$style = ' style="color:#' . get_header_textcolor () . ';"' ;
2010-05-25 18:05:51 -04:00
else
2012-03-21 15:10:13 -04:00
$style = ' style="display:none;"' ;
2010-05-25 18:05:51 -04:00
?>
2014-11-13 07:00:57 -05:00
< h1 >< a id = " name " class = " displaying-header-text " < ? php echo $style ; ?> onclick="return false;" href="<?php bloginfo('url'); ?>" tabindex="-1"><?php bloginfo( 'name' ); ?></a></h1>
2012-03-21 15:10:13 -04:00
< div id = " desc " class = " displaying-header-text " < ? php echo $style ; ?> ><?php bloginfo( 'description' ); ?></div>
2010-05-25 18:05:51 -04:00
</ div >
< ? php } ?>
</ td >
</ tr >
2013-08-27 08:27:10 -04:00
< ? php endif ; ?>
2015-06-23 14:20:27 -04:00
< ? php if ( current_user_can ( 'upload_files' ) && current_theme_supports ( 'custom-header' , 'uploads' ) ) : ?>
2014-01-24 14:06:15 -05:00
< tr >
2012-05-24 17:07:39 -04:00
< th scope = " row " >< ? php _e ( 'Select Image' ); ?> </th>
2010-05-25 18:05:51 -04:00
< td >
2012-08-14 14:32:26 -04:00
< 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 />
2012-02-02 18:35:37 -05:00
< ? php
if ( ! current_theme_supports ( 'custom-header' , 'flex-height' ) && ! current_theme_supports ( 'custom-header' , 'flex-width' ) ) {
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.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20212 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-19 13:12:44 -04:00
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' ) );
2012-02-02 18:35:37 -05:00
} elseif ( current_theme_supports ( 'custom-header' , 'flex-height' ) ) {
if ( ! current_theme_supports ( 'custom-header' , 'flex-width' ) )
2016-02-23 18:43:26 -05:00
printf (
/* translators: %s: size in pixels */
__ ( 'Images should be at least %s wide.' ) . ' ' ,
sprintf (
/* translators: %d: custom header width */
'<strong>' . __ ( '%d pixels' ) . '</strong>' ,
get_theme_support ( 'custom-header' , 'width' )
)
);
2012-02-02 18:35:37 -05:00
} elseif ( current_theme_supports ( 'custom-header' , 'flex-width' ) ) {
if ( ! current_theme_supports ( 'custom-header' , 'flex-height' ) )
2016-02-23 18:43:26 -05:00
printf (
/* translators: %s: size in pixels */
__ ( 'Images should be at least %s tall.' ) . ' ' ,
sprintf (
/* translators: %d: custom header height */
'<strong>' . __ ( '%d pixels' ) . '</strong>' ,
get_theme_support ( 'custom-header' , 'height' )
)
);
2012-02-02 18:35:37 -05:00
}
if ( current_theme_supports ( 'custom-header' , 'flex-height' ) || current_theme_supports ( 'custom-header' , 'flex-width' ) ) {
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.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20212 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-19 13:12:44 -04:00
if ( current_theme_supports ( 'custom-header' , 'width' ) )
2016-02-23 18:43:26 -05:00
printf (
/* translators: %s: size in pixels */
__ ( 'Suggested width is %s.' ) . ' ' ,
sprintf (
/* translators: %d: custom header width */
'<strong>' . __ ( '%d pixels' ) . '</strong>' ,
get_theme_support ( 'custom-header' , 'width' )
)
);
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.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20212 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-19 13:12:44 -04:00
if ( current_theme_supports ( 'custom-header' , 'height' ) )
2016-02-23 18:43:26 -05:00
printf (
/* translators: %s: size in pixels */
__ ( 'Suggested height is %s.' ) . ' ' ,
sprintf (
/* translators: %d: custom header height */
'<strong>' . __ ( '%d pixels' ) . '</strong>' ,
get_theme_support ( 'custom-header' , 'height' )
)
);
2012-02-02 18:35:37 -05:00
}
?> </p>
2012-11-10 00:30:51 -05:00
< form enctype = " multipart/form-data " id = " upload-form " class = " wp-upload-form " method = " post " action = " <?php echo esc_url( add_query_arg( 'step', 2 ) ) ?> " >
2010-05-25 18:05:51 -04:00
< p >
< label for = " upload " >< ? php _e ( 'Choose an image from your computer:' ); ?> </label><br />
< input type = " file " id = " upload " name = " import " />
< input type = " hidden " name = " action " value = " save " />
2012-05-24 17:03:38 -04:00
< ? php wp_nonce_field ( 'custom-header-upload' , '_wpnonce-custom-header-upload' ); ?>
2012-11-07 20:51:05 -05:00
< ? php submit_button ( __ ( 'Upload' ), 'button' , 'submit' , false ); ?>
2010-05-25 18:05:51 -04:00
</ p >
2012-04-04 20:20:28 -04:00
< ? php
2012-11-09 06:59:05 -05:00
$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' ) ) );
2012-04-04 20:20:28 -04:00
?>
2012-05-24 17:03:38 -04:00
< p >
< label for = " choose-from-library-link " >< ? php _e ( 'Or choose an image from your media library:' ); ?> </label><br />
2014-11-13 07:00:57 -05:00
< button id = " choose-from-library-link " class = " button "
2012-11-09 06:59:05 -05:00
data - update - link = " <?php echo esc_attr( $modal_update_href ); ?> "
data - choose = " <?php esc_attr_e( 'Choose a Custom Header' ); ?> "
2014-11-13 07:00:57 -05:00
data - update = " <?php esc_attr_e( 'Set as header' ); ?> " >< ? php _e ( 'Choose Image' ); ?> </button>
2012-05-24 17:03:38 -04:00
</ p >
</ form >
2010-05-25 18:05:51 -04:00
</ td >
</ tr >
2010-10-17 03:12:34 -04:00
< ? php endif ; ?>
2010-05-25 18:05:51 -04:00
</ tbody >
</ table >
2012-11-10 00:30:51 -05:00
< form method = " post " action = " <?php echo esc_url( add_query_arg( 'step', 1 ) ) ?> " >
2014-10-29 17:41:43 -04:00
< ? php submit_button ( null , 'screen-reader-text' , 'save-header-options' , false ); ?>
2010-05-25 18:05:51 -04:00
< table class = " form-table " >
< tbody >
2011-04-28 19:02:16 -04:00
< ? php if ( get_uploaded_header_images () ) : ?>
2014-01-24 14:06:15 -05:00
< tr >
2011-04-28 19:02:16 -04:00
< th scope = " row " >< ? php _e ( 'Uploaded Images' ); ?> </th>
< td >
2011-05-05 16:15:19 -04:00
< p >< ? php _e ( 'You can choose one of your previously uploaded headers, or show a random one.' ) ?> </p>
2011-04-28 19:02:16 -04:00
< ? php
$this -> show_header_selector ( 'uploaded' );
?>
</ td >
</ tr >
< ? php endif ;
if ( ! empty ( $this -> default_headers ) ) : ?>
2014-01-24 14:06:15 -05:00
< tr >
2010-05-25 18:05:51 -04:00
< th scope = " row " >< ? php _e ( 'Default Images' ); ?> </th>
< td >
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.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20212 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-19 13:12:44 -04:00
< ? php if ( current_theme_supports ( 'custom-header' , 'uploads' ) ) : ?>
2011-05-05 16:15:19 -04:00
< 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>
2010-10-17 03:12:34 -04:00
< ? php else : ?>
2011-05-05 16:15:19 -04:00
< p >< ? php _e ( 'You can use one of these cool headers or show a random one on each page.' ) ?> </p>
2010-10-17 03:12:34 -04:00
< ? php endif ; ?>
2010-05-25 18:05:51 -04:00
< ? php
2011-04-28 19:02:16 -04:00
$this -> show_header_selector ( 'default' );
2010-05-25 18:05:51 -04:00
?>
</ td >
</ tr >
< ? php endif ;
2011-04-29 15:45:30 -04:00
if ( get_header_image () ) : ?>
2014-01-24 14:06:15 -05:00
< tr >
2010-05-25 18:05:51 -04:00
< 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>
2010-10-28 17:56:43 -04:00
< ? php submit_button ( __ ( 'Remove Header Image' ), 'button' , 'removeheader' , false ); ?>
2010-05-25 18:05:51 -04:00
</ td >
</ tr >
< ? php endif ;
2012-05-30 17:58:27 -04:00
$default_image = get_theme_support ( 'custom-header' , 'default-image' );
if ( $default_image && get_header_image () != $default_image ) : ?>
2014-01-24 14:06:15 -05:00
< tr >
2010-05-25 18:05:51 -04:00
< 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>
2010-10-28 17:56:43 -04:00
< ? php submit_button ( __ ( 'Restore Original Header Image' ), 'button' , 'resetheader' , false ); ?>
2010-05-25 18:05:51 -04:00
</ td >
</ tr >
< ? php endif ; ?>
</ tbody >
</ table >
2012-03-21 15:10:13 -04:00
< ? php if ( current_theme_supports ( 'custom-header' , 'header-text' ) ) : ?>
< h3 >< ? php _e ( 'Header Text' ); ?> </h3>
2010-05-25 18:05:51 -04:00
< table class = " form-table " >
< tbody >
2014-01-24 14:06:15 -05:00
< tr >
2012-03-21 15:10:13 -04:00
< th scope = " row " >< ? php _e ( 'Header Text' ); ?> </th>
2010-05-25 18:05:51 -04:00
< td >
< p >
2012-03-21 15:10:13 -04:00
< 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>
2010-05-25 18:05:51 -04:00
</ p >
</ td >
</ tr >
2014-01-24 14:06:15 -05:00
< tr class = " displaying-header-text " >
2010-05-25 18:05:51 -04:00
< th scope = " row " >< ? php _e ( 'Text Color' ); ?> </th>
< td >
< p >
2014-05-06 11:27:54 -04:00
< ? php
$default_color = '' ;
if ( current_theme_supports ( 'custom-header' , 'default-text-color' ) ) {
$default_color = get_theme_support ( 'custom-header' , 'default-text-color' );
if ( $default_color && false === strpos ( $default_color , '#' ) ) {
$default_color = '#' . $default_color ;
}
}
$default_color_attr = $default_color ? ' data-default-color="' . esc_attr ( $default_color ) . '"' : '' ;
$header_textcolor = display_header_text () ? get_header_textcolor () : get_theme_support ( 'custom-header' , 'default-text-color' );
if ( $header_textcolor && false === strpos ( $header_textcolor , '#' ) ) {
$header_textcolor = '#' . $header_textcolor ;
}
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' ), esc_html ( $default_color ) ) . '</span>' ;
}
?>
2010-05-25 18:05:51 -04:00
</ p >
</ td >
</ tr >
</ tbody >
</ table >
2012-03-21 15:10:13 -04:00
< ? php endif ;
2010-10-19 03:48:22 -04:00
2013-10-16 19:26:10 -04:00
/**
* Fires just before the submit button in the custom header options form .
*
* @ since 3.1 . 0
*/
2010-10-19 03:48:22 -04:00
do_action ( 'custom_header_options' );
2010-05-25 18:05:51 -04:00
wp_nonce_field ( 'custom-header-options' , '_wpnonce-custom-header-options' ); ?>
2010-10-17 14:24:34 -04:00
2010-10-28 17:56:43 -04:00
< ? php submit_button ( null , 'primary' , 'save-header-options' ); ?>
2007-05-01 13:46:55 -04:00
</ form >
</ div >
2010-05-25 18:05:51 -04:00
< ? php }
2007-05-01 13:46:55 -04:00
2008-08-16 03:27:34 -04:00
/**
* Display second step of custom header image page .
*
2010-03-30 14:55:35 -04:00
* @ since 2.1 . 0
2008-08-16 03:27:34 -04:00
*/
2014-05-18 17:31:16 -04:00
public function step_2 () {
2010-05-25 18:05:51 -04:00
check_admin_referer ( 'custom-header-upload' , '_wpnonce-custom-header-upload' );
2015-09-02 12:29:21 -04:00
if ( ! current_theme_supports ( 'custom-header' , 'uploads' ) ) {
wp_die (
'<h1>' . __ ( 'Cheatin’ uh?' ) . '</h1>' .
'<p>' . __ ( 'The current theme does not support uploading a custom header image.' ) . '</p>' ,
403
);
}
2010-10-17 03:12:34 -04:00
2012-04-04 20:20:28 -04:00
if ( empty ( $_POST ) && isset ( $_GET [ 'file' ] ) ) {
2012-06-09 20:32:19 -04:00
$attachment_id = absint ( $_GET [ 'file' ] );
$file = get_attached_file ( $attachment_id , true );
2014-05-13 00:54:14 -04:00
$url = wp_get_attachment_image_src ( $attachment_id , 'full' );
2012-04-04 20:20:28 -04:00
$url = $url [ 0 ];
} elseif ( isset ( $_POST ) ) {
2014-05-13 00:54:14 -04:00
$data = $this -> step_2_manage_upload ();
$attachment_id = $data [ 'attachment_id' ];
$file = $data [ 'file' ];
$url = $data [ 'url' ];
2012-04-04 20:20:28 -04:00
}
2007-05-01 13:46:55 -04:00
2012-04-06 16:47:24 -04:00
if ( file_exists ( $file ) ) {
list ( $width , $height , $type , $attr ) = getimagesize ( $file );
} else {
2012-06-09 20:32:19 -04:00
$data = wp_get_attachment_metadata ( $attachment_id );
2013-03-29 16:51:35 -04:00
$height = isset ( $data [ 'height' ] ) ? $data [ 'height' ] : 0 ;
$width = isset ( $data [ 'width' ] ) ? $data [ 'width' ] : 0 ;
2012-04-06 16:47:24 -04:00
unset ( $data );
}
2007-05-01 13:46:55 -04:00
2012-02-02 18:35:37 -05:00
$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 ;
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.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20212 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-19 13:12:44 -04:00
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' ) );
2012-02-02 18:35:37 -05:00
// If flexible height isn't supported and the image is the exact right size
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.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20212 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-19 13:12:44 -04:00
if ( ! current_theme_supports ( 'custom-header' , 'flex-height' ) && ! current_theme_supports ( 'custom-header' , 'flex-width' )
&& $width == get_theme_support ( 'custom-header' , 'width' ) && $height == get_theme_support ( 'custom-header' , 'height' ) )
{
2008-02-26 16:07:15 -05:00
// Add the meta-data
2012-04-06 16:47:24 -04:00
if ( file_exists ( $file ) )
2012-06-09 20:32:19 -04:00
wp_update_attachment_metadata ( $attachment_id , wp_generate_attachment_metadata ( $attachment_id , $file ) );
$this -> set_header_image ( compact ( 'url' , 'attachment_id' , 'width' , 'height' ) );
2008-02-26 16:07:15 -05:00
2013-10-16 19:26:10 -04:00
/**
* 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
2007-05-01 13:46:55 -04:00
return $this -> finished ();
2012-02-02 18:35:37 -05:00
} elseif ( $width > $max_width ) {
$oitar = $width / $max_width ;
2012-06-09 20:32:19 -04:00
$image = wp_crop_image ( $attachment_id , 0 , 0 , $width , $height , $max_width , $height / $oitar , false , str_replace ( basename ( $file ), 'midsize-' . basename ( $file ), $file ));
2012-05-11 12:15:15 -04:00
if ( ! $image || is_wp_error ( $image ) )
2011-12-13 18:45:31 -05:00
wp_die ( __ ( 'Image could not be processed. Please go back and try again.' ), __ ( 'Image Processing Error' ) );
2009-12-23 13:39:31 -05:00
2013-10-24 18:59:20 -04:00
/** This filter is documented in wp-admin/custom-header.php */
2013-10-16 19:26:10 -04:00
$image = apply_filters ( 'wp_create_file_in_uploads' , $image , $attachment_id ); // For replication
2007-05-01 13:46:55 -04:00
$url = str_replace ( basename ( $url ), basename ( $image ), $url );
$width = $width / $oitar ;
$height = $height / $oitar ;
} else {
$oitar = 1 ;
}
?>
< div class = " wrap " >
2015-06-27 11:41:25 -04:00
< h1 >< ? php _e ( 'Crop Header Image' ); ?> </h1>
2010-05-25 18:05:51 -04:00
2012-11-10 00:30:51 -05:00
< form method = " post " action = " <?php echo esc_url(add_query_arg('step', 3)); ?> " >
2010-05-25 18:05:51 -04:00
< p class = " hide-if-no-js " >< ? php _e ( 'Choose the part of the image you want to use as your header.' ); ?> </p>
2015-07-12 15:43:24 -04:00
< p class = " hide-if-js " >< strong >< ? php _e ( 'You need JavaScript to choose a part of the image.' ); ?> </strong></p>
2010-05-25 18:05:51 -04:00
< div id = " crop_image " style = " position: relative " >
2015-11-07 11:12:27 -05:00
< img src = " <?php echo esc_url( $url ); ?> " id = " upload " width = " <?php echo $width ; ?> " height = " <?php echo $height ; ?> " alt = " " />
2010-05-25 18:05:51 -04:00
</ div >
< input type = " hidden " name = " x1 " id = " x1 " value = " 0 " />
< input type = " hidden " name = " y1 " id = " y1 " value = " 0 " />
< input type = " hidden " name = " width " id = " width " value = " <?php echo esc_attr( $width ); ?> " />
< input type = " hidden " name = " height " id = " height " value = " <?php echo esc_attr( $height ); ?> " />
2012-06-09 20:32:19 -04:00
< input type = " hidden " name = " attachment_id " id = " attachment_id " value = " <?php echo esc_attr( $attachment_id ); ?> " />
2010-05-25 18:05:51 -04:00
< input type = " hidden " name = " oitar " id = " oitar " value = " <?php echo esc_attr( $oitar ); ?> " />
2012-04-04 20:20:28 -04:00
< ? php if ( empty ( $_POST ) && isset ( $_GET [ 'file' ] ) ) { ?>
2012-05-16 13:47:55 -04:00
< input type = " hidden " name = " create-new-attachment " value = " true " />
2012-04-04 20:20:28 -04:00
< ? php } ?>
2010-05-25 18:05:51 -04:00
< ? php wp_nonce_field ( 'custom-header-crop-image' ) ?>
2010-10-19 03:48:22 -04:00
2012-06-02 12:57:10 -04:00
< p class = " submit " >
< ? php submit_button ( __ ( 'Crop and Publish' ), 'primary' , 'submit' , false ); ?>
< ? php
2012-11-09 06:59:05 -05:00
if ( isset ( $oitar ) && 1 == $oitar && ( current_theme_supports ( 'custom-header' , 'flex-height' ) || current_theme_supports ( 'custom-header' , 'flex-width' ) ) )
2012-06-02 12:57:10 -04:00
submit_button ( __ ( 'Skip Cropping, Publish Image as Is' ), 'secondary' , 'skip-cropping' , false );
2012-05-16 13:47:55 -04:00
?>
2010-05-25 18:05:51 -04:00
</ p >
2007-05-01 13:46:55 -04:00
</ form >
</ div >
< ? php
}
2012-04-04 20:20:28 -04:00
2012-06-04 10:37:57 -04:00
/**
* Upload the file to be cropped in the second step .
*
* @ since 3.4 . 0
*/
2014-05-18 17:31:16 -04:00
public function step_2_manage_upload () {
2012-04-04 20:20:28 -04:00
$overrides = array ( 'test_form' => false );
2012-11-10 00:36:37 -05:00
$uploaded_file = $_FILES [ 'import' ];
2015-01-09 16:07:22 -05:00
$wp_filetype = wp_check_filetype_and_ext ( $uploaded_file [ 'tmp_name' ], $uploaded_file [ 'name' ] );
2012-11-10 00:36:37 -05:00
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 );
2012-04-04 20:20:28 -04:00
if ( isset ( $file [ 'error' ]) )
wp_die ( $file [ 'error' ], __ ( 'Image Upload Error' ) );
$url = $file [ 'url' ];
$type = $file [ 'type' ];
$file = $file [ 'file' ];
$filename = basename ( $file );
// Construct the object array
$object = array (
'post_title' => $filename ,
'post_content' => $url ,
'post_mime_type' => $type ,
'guid' => $url ,
'context' => 'custom-header'
);
// Save the data
2012-06-09 20:32:19 -04:00
$attachment_id = wp_insert_attachment ( $object , $file );
return compact ( 'attachment_id' , 'file' , 'filename' , 'url' , 'type' );
2012-04-04 20:20:28 -04:00
}
2008-08-16 03:27:34 -04:00
/**
* Display third step of custom header image page .
*
2010-03-30 14:55:35 -04:00
* @ since 2.1 . 0
2015-09-16 06:43:25 -04:00
* @ since 4.4 . 0 Switched to using wp_get_attachment_url () instead of the guid
* for retrieving the header image URL .
2008-08-16 03:27:34 -04:00
*/
2014-05-18 17:31:16 -04:00
public function step_3 () {
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.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20212 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-19 13:12:44 -04:00
check_admin_referer ( 'custom-header-crop-image' );
2015-09-02 12:29:21 -04:00
if ( ! current_theme_supports ( 'custom-header' , 'uploads' ) ) {
wp_die (
'<h1>' . __ ( 'Cheatin’ uh?' ) . '</h1>' .
'<p>' . __ ( 'The current theme does not support uploading a custom header image.' ) . '</p>' ,
403
);
}
2010-10-17 03:12:34 -04:00
2015-09-02 12:29:21 -04:00
if ( ! empty ( $_POST [ 'skip-cropping' ] ) && ! ( current_theme_supports ( 'custom-header' , 'flex-height' ) || current_theme_supports ( 'custom-header' , 'flex-width' ) ) ) {
wp_die (
'<h1>' . __ ( 'Cheatin’ uh?' ) . '</h1>' .
'<p>' . __ ( 'The current theme does not support a flexible sized header image.' ) . '</p>' ,
403
);
}
2012-11-09 06:59:05 -05:00
2007-05-01 13:46:55 -04:00
if ( $_POST [ 'oitar' ] > 1 ) {
$_POST [ 'x1' ] = $_POST [ 'x1' ] * $_POST [ 'oitar' ];
$_POST [ 'y1' ] = $_POST [ 'y1' ] * $_POST [ 'oitar' ];
$_POST [ 'width' ] = $_POST [ 'width' ] * $_POST [ 'oitar' ];
$_POST [ 'height' ] = $_POST [ 'height' ] * $_POST [ 'oitar' ];
}
2011-06-13 04:50:16 -04:00
$attachment_id = absint ( $_POST [ 'attachment_id' ] );
$original = get_attached_file ( $attachment_id );
2007-05-01 13:46:55 -04:00
2014-03-11 00:13:16 -04:00
$dimensions = $this -> get_header_dimensions ( array (
'height' => $_POST [ 'height' ],
'width' => $_POST [ 'width' ],
) );
$height = $dimensions [ 'dst_height' ];
$width = $dimensions [ 'dst_width' ];
2012-02-02 18:35:37 -05:00
2012-05-16 13:47:55 -04:00
if ( empty ( $_POST [ 'skip-cropping' ] ) )
2014-03-11 00:13:16 -04:00
$cropped = wp_crop_image ( $attachment_id , ( int ) $_POST [ 'x1' ], ( int ) $_POST [ 'y1' ], ( int ) $_POST [ 'width' ], ( int ) $_POST [ 'height' ], $width , $height );
2012-05-16 13:47:55 -04:00
elseif ( ! empty ( $_POST [ 'create-new-attachment' ] ) )
$cropped = _copy_image_file ( $attachment_id );
else
$cropped = get_attached_file ( $attachment_id );
2012-05-11 12:15:15 -04:00
if ( ! $cropped || is_wp_error ( $cropped ) )
2011-12-13 18:45:31 -05:00
wp_die ( __ ( 'Image could not be processed. Please go back and try again.' ), __ ( 'Image Processing Error' ) );
2009-12-23 13:39:31 -05:00
2013-10-24 18:59:20 -04:00
/** This filter is documented in wp-admin/custom-header.php */
2013-10-16 19:26:10 -04:00
$cropped = apply_filters ( 'wp_create_file_in_uploads' , $cropped , $attachment_id ); // For replication
2007-05-01 13:46:55 -04:00
2014-03-11 00:13:16 -04:00
$object = $this -> create_attachment_object ( $cropped , $attachment_id );
2012-05-02 17:35:56 -04:00
2012-05-16 13:47:55 -04:00
if ( ! empty ( $_POST [ 'create-new-attachment' ] ) )
2012-05-11 12:15:15 -04:00
unset ( $object [ 'ID' ] );
2007-05-01 13:46:55 -04:00
2008-02-26 16:07:15 -05:00
// Update the attachment
2014-03-11 00:13:16 -04:00
$attachment_id = $this -> insert_attachment ( $object , $cropped );
2007-05-01 13:46:55 -04:00
2015-09-15 10:46:32 -04:00
$url = wp_get_attachment_url ( $attachment_id );
2012-06-09 20:32:19 -04:00
$this -> set_header_image ( compact ( 'url' , 'attachment_id' , 'width' , 'height' ) );
2012-02-02 18:35:37 -05:00
2014-07-17 05:14:16 -04:00
// Cleanup.
2012-05-11 12:15:15 -04:00
$medium = str_replace ( basename ( $original ), 'midsize-' . basename ( $original ), $original );
2013-10-16 19:26:10 -04:00
if ( file_exists ( $medium ) ) {
2015-02-27 11:51:25 -05:00
wp_delete_file ( $medium );
2013-10-16 19:26:10 -04:00
}
if ( empty ( $_POST [ 'create-new-attachment' ] ) && empty ( $_POST [ 'skip-cropping' ] ) ) {
2015-02-27 11:51:25 -05:00
wp_delete_file ( $original );
2013-10-16 19:26:10 -04:00
}
2007-05-01 13:46:55 -04:00
return $this -> finished ();
}
2008-08-16 03:27:34 -04:00
/**
* Display last step of custom header image page .
*
2010-03-30 14:55:35 -04:00
* @ since 2.1 . 0
2008-08-16 03:27:34 -04:00
*/
2014-05-18 17:31:16 -04:00
public function finished () {
2010-05-25 18:05:51 -04:00
$this -> updated = true ;
$this -> step_1 ();
2007-05-01 13:46:55 -04:00
}
2008-08-16 03:27:34 -04:00
/**
* Display the page based on the current step .
*
2010-03-30 14:55:35 -04:00
* @ since 2.1 . 0
2008-08-16 03:27:34 -04:00
*/
2014-05-18 17:31:16 -04:00
public function admin_page () {
2010-05-12 15:19:57 -04:00
if ( ! current_user_can ( 'edit_theme_options' ) )
2016-06-29 11:16:29 -04:00
wp_die ( __ ( 'Sorry, you are not allowed to customize headers.' ));
2008-04-16 16:58:03 -04:00
$step = $this -> step ();
2012-04-04 20:20:28 -04:00
if ( 2 == $step )
2007-05-01 13:46:55 -04:00
$this -> step_2 ();
2008-04-16 16:58:03 -04:00
elseif ( 3 == $step )
2007-05-01 13:46:55 -04:00
$this -> step_3 ();
2012-04-04 20:20:28 -04:00
else
$this -> step_1 ();
}
2012-06-04 10:37:57 -04:00
/**
2012-11-21 12:44:49 -05:00
* Unused since 3.5 . 0.
2012-06-04 10:37:57 -04:00
*
* @ since 3.4 . 0
2015-05-29 16:17:26 -04:00
*
* @ param array $form_fields
2015-06-12 14:35:26 -04:00
* @ return array $form_fields
2012-06-04 10:37:57 -04:00
*/
2014-05-18 17:31:16 -04:00
public function attachment_fields_to_edit ( $form_fields ) {
2012-04-04 20:20:28 -04:00
return $form_fields ;
}
2012-06-04 10:37:57 -04:00
/**
2012-11-21 12:44:49 -05:00
* Unused since 3.5 . 0.
2012-06-04 10:37:57 -04:00
*
* @ since 3.4 . 0
2015-05-29 16:17:26 -04:00
*
* @ param array $tabs
2015-06-12 14:35:26 -04:00
* @ return array $tabs
2012-06-04 10:37:57 -04:00
*/
2014-05-18 17:31:16 -04:00
public function filter_upload_tabs ( $tabs ) {
2012-11-21 12:44:49 -05:00
return $tabs ;
2007-05-01 13:46:55 -04:00
}
2012-06-09 20:32:19 -04:00
/**
* Choose a header image , selected from existing uploaded and default headers ,
* or provide an array of uploaded header data ( either new , or from media library ) .
*
2016-01-09 20:26:25 -05:00
* @ since 3.4 . 0
*
2012-06-09 20:32:19 -04:00
* @ param mixed $choice Which header image to select . Allows for values of 'random-default-image' ,
* for randomly cycling among the default images ; 'random-uploaded-image' , for randomly cycling
* among the uploaded images ; the key of a default image registered for that theme ; and
2016-02-16 17:12:27 -05:00
* the key of an image uploaded for that theme ( the attachment ID of the image ) .
2012-06-09 20:32:19 -04:00
* Or an array of arguments : attachment_id , url , width , height . All are required .
*/
final public function set_header_image ( $choice ) {
if ( is_array ( $choice ) || is_object ( $choice ) ) {
$choice = ( array ) $choice ;
if ( ! isset ( $choice [ 'attachment_id' ] ) || ! isset ( $choice [ 'url' ] ) )
return ;
$choice [ 'url' ] = esc_url_raw ( $choice [ 'url' ] );
$header_image_data = ( object ) array (
'attachment_id' => $choice [ 'attachment_id' ],
'url' => $choice [ 'url' ],
'thumbnail_url' => $choice [ 'url' ],
'height' => $choice [ 'height' ],
'width' => $choice [ 'width' ],
);
2013-03-01 11:28:40 -05:00
update_post_meta ( $choice [ 'attachment_id' ], '_wp_attachment_is_custom_header' , get_stylesheet () );
2012-06-09 20:32:19 -04:00
set_theme_mod ( 'header_image' , $choice [ 'url' ] );
set_theme_mod ( 'header_image_data' , $header_image_data );
return ;
}
if ( in_array ( $choice , array ( 'remove-header' , 'random-default-image' , 'random-uploaded-image' ) ) ) {
set_theme_mod ( 'header_image' , $choice );
remove_theme_mod ( 'header_image_data' );
return ;
}
$uploaded = get_uploaded_header_images ();
if ( $uploaded && isset ( $uploaded [ $choice ] ) ) {
$header_image_data = $uploaded [ $choice ];
} else {
$this -> process_default_headers ();
if ( isset ( $this -> default_headers [ $choice ] ) )
$header_image_data = $this -> default_headers [ $choice ];
else
return ;
}
set_theme_mod ( 'header_image' , esc_url_raw ( $header_image_data [ 'url' ] ) );
set_theme_mod ( 'header_image_data' , $header_image_data );
}
/**
* Remove a header image .
*
* @ since 3.4 . 0
*/
final public function remove_header_image () {
2015-05-29 16:17:26 -04:00
$this -> set_header_image ( 'remove-header' );
2012-06-09 20:32:19 -04:00
}
/**
* Reset a header image to the default image for the theme .
*
* This method does not do anything if the theme does not have a default header image .
*
* @ since 3.4 . 0
*/
final public function reset_header_image () {
$this -> process_default_headers ();
$default = get_theme_support ( 'custom-header' , 'default-image' );
2015-05-29 16:17:26 -04:00
if ( ! $default ) {
$this -> remove_header_image ();
return ;
}
2012-06-09 20:32:19 -04:00
$default = sprintf ( $default , get_template_directory_uri (), get_stylesheet_directory_uri () );
2013-01-22 22:00:20 -05:00
$default_data = array ();
2012-06-09 20:32:19 -04:00
foreach ( $this -> default_headers as $header => $details ) {
if ( $details [ 'url' ] == $default ) {
$default_data = $details ;
break ;
}
}
set_theme_mod ( 'header_image' , $default );
set_theme_mod ( 'header_image_data' , ( object ) $default_data );
}
2014-03-11 00:13:16 -04:00
/**
* Calculate width and height based on what the currently selected theme supports .
*
2015-05-29 16:17:26 -04:00
* @ param array $dimensions
2014-03-11 00:13:16 -04:00
* @ 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' ) ;
2014-10-25 11:56:19 -04:00
$dst = array ( 'dst_height' => null , 'dst_width' => null );
2014-03-11 00:13:16 -04:00
// 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' .
*
2015-05-29 16:17:26 -04:00
* @ param string $cropped Cropped image URL .
* @ param int $parent_attachment_id Attachment ID of parent image .
2014-03-11 00:13:16 -04:00
*
* @ return array Attachment object .
*/
final public function create_attachment_object ( $cropped , $parent_attachment_id ) {
$parent = get_post ( $parent_attachment_id );
2015-09-14 22:50:25 -04:00
$parent_url = wp_get_attachment_url ( $parent -> ID );
2014-03-11 00:13:16 -04:00
$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_mime_type' => $image_type ,
'guid' => $url ,
'context' => 'custom-header'
);
return $object ;
}
/**
2014-05-13 00:13:15 -04:00
* Insert an attachment and its metadata .
2014-03-11 00:13:16 -04:00
*
2015-05-29 16:17:26 -04:00
* @ param array $object Attachment object .
2014-03-11 00:13:16 -04:00
* @ 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 );
/**
2016-05-22 14:01:30 -04:00
* Filters the header image attachment metadata .
2014-03-11 00:13:16 -04:00
*
2014-05-13 00:13:15 -04:00
* @ since 3.9 . 0
*
* @ see wp_generate_attachment_metadata ()
*
* @ param array $metadata Attachment metadata .
2014-03-11 00:13:16 -04:00
*/
$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 .
*/
2014-05-18 17:31:16 -04:00
public function ajax_header_crop () {
2014-03-11 00:13:16 -04:00
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.' ) ) );
}
2014-04-25 02:46:19 -04:00
/** This filter is documented in wp-admin/custom-header.php */
2014-03-11 00:13:16 -04:00
$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 ;
2015-09-15 10:46:32 -04:00
$object [ 'url' ] = wp_get_attachment_url ( $new_attachment_id );;
2014-03-11 00:13:16 -04:00
$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 .
*/
2014-05-18 17:31:16 -04:00
public function ajax_header_add () {
2014-03-11 00:13:16 -04:00
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 .
*/
2014-05-18 17:31:16 -04:00
public function ajax_header_remove () {
2014-03-11 00:13:16 -04:00
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 ();
}
2015-05-29 16:17:26 -04:00
/**
*
* @ param WP_Customize_Manager $wp_customize
*/
2014-05-18 17:31:16 -04:00
public function customize_set_last_used ( $wp_customize ) {
2014-03-11 00:13:16 -04:00
$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 () );
}
2014-03-29 06:53:15 -04:00
2015-05-29 16:17:26 -04:00
/**
*
* @ return array
*/
2014-03-29 06:53:15 -04:00
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.
2015-05-29 16:17:26 -04:00
return array_merge ( $header_images , $this -> default_headers );
2014-03-29 06:53:15 -04:00
}
2015-05-29 16:17:26 -04:00
/**
*
* @ return array
*/
2014-03-29 06:53:15 -04:00
public function get_uploaded_header_images () {
$header_images = get_uploaded_header_images ();
$timestamp_key = '_wp_attachment_custom_header_last_used_' . get_stylesheet ();
2014-04-04 11:49:15 -04:00
$alt_text_key = '_wp_attachment_image_alt' ;
2014-03-29 06:53:15 -04:00
foreach ( $header_images as & $header_image ) {
2014-04-04 11:49:15 -04:00
$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 ] : '' ;
2014-03-29 06:53:15 -04:00
}
return $header_images ;
}
2007-05-01 13:46:55 -04:00
}