Warning: This function has been deprecated. Use add_theme_support() instead.

add_custom_background( callable $wp_head_callback = '', callable $admin_head_callback = '', callable $admin_preview_callback = '' )

Add callbacks for background image display.


Description Description


Parameters Parameters

$wp_head_callback

(callable) (Optional) Call on the 'wp_head' action.

Default value: ''

$admin_head_callback

(callable) (Optional) Call on custom background administration screen.

Default value: ''

$admin_preview_callback

(callable) (Optional) Output a custom background image div on the custom background administration screen. Optional.

Default value: ''


Top ↑

Source Source

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


Top ↑

Changelog Changelog

Changelog
Version Description
3.4.0 Use add_theme_support()
3.0.0 Introduced.


Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.