WordPress 3.4新的Custom Backgrounds和Custom Headers方法

[tr][td]今天收到WordPress官方邮件通知，WordPress 3.4会用新的方法实现Custom Backgrounds（自定义背景）和Custom Headers（自定义头部－一般是图片），老方法可以继续使用但不提倡。

Custom Backgrounds

原来的方法：

add_custom_background();

新的方法：

add_theme_support('custom-background');

新方法加了数组参数，定义更容易：add_theme_support('custom-background', $args )，$args 默认参数如下：

$defaults = array(
 'default-image' => '', //默认背景图片
 'default-color' => '', //默认背景颜色
 'wp-head-callback' => '_custom_background_cb', //回调函数
 'admin-head-callback' => '',
 'admin-preview-callback' => ''
)

现在定义默认背景图片和颜色变得非常简单：

add_theme_support( 'custom-background', array(
 // Background color default
 'default-color' => '000',
 // Background image default
 'default-image' => get_template_directory_uri() . '/images/background.jpg'
) );

Custom Headers

老方法：

// Define default header image constant
define( 'HEADER_IMAGE', get_template_directory_uri() . '/images/headers/default.jpg' );
// Define header image width constant
define( 'HEADER_IMAGE_WIDTH', 1000 );
// Define header image height constant
define( 'HEADER_IMAGE_HEIGHT', 198 );
// Define header text constant
define( 'NO_HEADER_TEXT', false );
// Define header text color constant
define( 'HEADER_TEXTCOLOR', '000' );
// Turn on random header image rotation by default.
// Requires HEADER_IMAGE to be null
add_theme_support( 'custom-header', array( 'random-default' => true ) );

// Add Theme support
add_custom_image_header( $wphead_cb, $adminhead_cb, $adminpreview_cb );

新方法：

add_theme_support( 'custom-header', array(
 // Header image default
 'default-image' => get_template_directory_uri() . '/images/headers/default.jpg',
 // Header text display default
 'header-text' => false,
 // Header text color default
 'default-text-color' => '000',
 // Header image width (in pixels)
 'width' => 1000,
 // Header image height (in pixels)
 'height' => 198,
 // Header image random rotation default
 'random-default' => false,
 // Template header style callback
 'wp-head-callback' => $wphead_cb,
 // Admin header style callback
 'admin-head-callback' => $adminhead_cb,
 // Admin preview style callback
 'admin-preview-callback' => $adminpreview_cb
) );

现在参数定义更简单，对比一下新旧参数：

HEADER_IMAGE => 'default-image'
HEADER_IMAGE_WIDTH => 'width'
HEADER_IMAGE_HEIGHT => 'height'
NO_HEADER_TEXT => 'header-text'
HEADER_TEXTCOLOR => 'default-text-color'

下面是完整的参数参考：

$defaults = array(
 'default-image' => '',
 'random-default' => false,
 'width' => 0,
 'height' => 0,
 'flex-height' => false,
 'flex-width' => false,
 'default-text-color' => '',
 'header-text' => true,
 'uploads' => true,
 'wp-head-callback' => '',
 'admin-head-callback' => '',
 'admin-preview-callback' => '',
);

看来下次升级主题时就要更新这个了。

</strong>

[/td][/tr]