wpseek.com
A WordPress-centric search engine for devs and theme authors



add_custom_background › WordPress Function

Since3.0.0
Deprecated3.4.0
› add_custom_background ( $wp_head_callback = '', $admin_head_callback = '', $admin_preview_callback = '' )
Parameters: (3)
  • (callable) $wp_head_callback Call on the {@see 'wp_head'} action.
    Required: No
    Default: (empty)
  • (callable) $admin_head_callback Call on custom background administration screen.
    Required: No
    Default: (empty)
  • (callable) $admin_preview_callback Output a custom background image div on the custom background administration screen. Optional.
    Required: No
    Default: (empty)
See:
Defined at:
Codex:

Add callbacks for background image display.



Related Functions: _custom_background_cb, remove_custom_background, add_custom_image_header, _custom_header_background_just_in_time, get_background_image

Source 

function add_custom_background( $wp_head_callback = '', $admin_head_callback = '', $admin_preview_callback = '' ) {
	_deprecated_function( __FUNCTION__, '3.4.0', 'add_theme_support( \'custom-background\', $args )' );
	$args = array();
	if ( $wp_head_callback )
		$args['wp-head-callback'] = $wp_head_callback;
	if ( $admin_head_callback )
		$args['admin-head-callback'] = $admin_head_callback;
	if ( $admin_preview_callback )
		$args['admin-preview-callback'] = $admin_preview_callback;
	return add_theme_support( 'custom-background', $args );
}