add_custom_background() │ WP 3.0.0

Deprecated from version 3.4.0. It is no longer supported and can be removed in future releases. Use add_theme_support() instead.

Add callbacks for background image display.

No Hooks.

Return

null. Nothing (null).

Usage

add_custom_background( $wp_head_callback, $admin_head_callback, $admin_preview_callback );

$wp_head_callback(callable): Call on the wp_head action.
Default: ''
$admin_head_callback(callable): Call on custom background administration screen.
Default: ''
$admin_preview_callback(callable): Output a custom background image div on the custom background administration screen. Optional.
Default: ''

Notes

See: add_theme_support()

Changelog

Since 3.0.0	Introduced.
Deprecated since 3.4.0	Use add_theme_support()

`add_custom_background() add custom background` code ^{WP 6.7.1}

wp-includes/deprecated.php

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 );
}