Codex

Function Reference/add custom background

Languages: English • 日本語 • (Add your language)

This function has been deprecated. That means it has been replaced by a new function or is no longer supported, and may be removed from future versions. All code that uses this function should be converted to use its replacement if one exists. See also wp-includes/deprecated.php. Use any of these functions instead.

Contents

Description

Add callbacks for background image display.

The parameter $header_callback callback will be required to display the content for the 'wp_head' action. The parameter $admin_header_callback callback will be added to Custom_Background class and that will be added to the 'admin_menu' action.

Replace With

After deprecation this function was replaced with the following: add_theme_support( 'custom-background' )

Usage

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

Parameters

$header_callback
(callback) (optional) Call on 'wp_head' action.
Default: ''
$admin_header_callback
(callback) (optional) Call on custom background administration screen.
Default: ''
$admin_image_div_callback
(callback) (optional) Output a custom background image div on the custom background administration screen. Optional.
Default: ''

Return Values

(void) 
This function does not return a value.

Examples

Notes

  • Uses: Custom_Background Sets up for $admin_header_callback for administration panel display.

Change Log

Source File

add_custom_background() is located in wp-includes/theme.php.

Related

Theme Support: add_theme_support(), remove_theme_support(), current_theme_supports()
Features: sidebar, menus, post-formats, post-thumbnails, custom-background, custom-header, automatic-feed-links, content_width, editor-style

Further Reading - External Resources

See also index of Function Reference and index of Template Tags.
Retrieved from "http://codex.wordpress.org/Function_Reference/add_custom_background"

Codex Resources