WordPress函数add_custom_background()

描述：

自定义背景，需要参数$header_callback callback来显示“wp_head”操作的内容。参数$admin_header_callback callback将被添加到custom_background类中，并添加到“admin_menu”操作中。

用法：

<?php add_custom_background( $header_callback, $admin_header_callback, $admin_image_div_callback ) ?>

参数：

$header_callback

(callback) (可选) 调用‘wp_head’

默认值: ”

$admin_header_callback

(callback) (可选) 在自定义后台管理屏幕上调用。

默认值: ”

$admin_image_div_callback

(callback) (可选) 在自定义后台管理屏幕上输出自定义后台图像div。可选。

默认值: ”

返回值：

(无效）
此函数不返回值。

源文件：

/**
 * Add callbacks for background image display.
 *
 * @since 3.0.0
 * @deprecated 3.4.0
 * @deprecated Use add_theme_support('custom-background, $args)
 * @see add_theme_support()
 *
 * @param callback $wp_head_callback Call on 'wp_head' action.
 * @param callback $admin_head_callback Call on custom background administration screen.
 * @param callback $admin_preview_callback Output a custom background image div on the custom background administration screen. Optional.
 */
function add_custom_background( $wp_head_callback = '', $admin_head_callback = '', $admin_preview_callback = '' ) {
	_deprecated_function( __FUNCTION__, '3.4', '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 );
}