header_image()header_image() 函数是 WordPress 自定顶部图像的标准接口函数，该函数可以自动判断后台设置，并返回字符串形式的用户自定义顶部图像地址。本文主要涉及该函数的详解及使用。

【Display header image path.】 即，显示顶部图像地址。使用

复制代码 代码如下:

<img src="<?php header_image(); ?>" width="<?php echo $header_image_width; ?>" height="<?php echo $header_image_height; ?>" alt="" />

函数声明源代码
function header_textcolor() { echo get_header_textcolor();}function get_header_image() { $url = get_theme_mod( "header_image", get_theme_support( "custom-header", "default-image" ) );  if ( "remove-header" == $url ) return false;  if ( is_random_header_image() ) $url = get_random_header_image();  if ( is_ssl() ) $url = str_replace( "http://", "https://", $url ); else $url = str_replace( "https://", "http://", $url );  return esc_url_raw( $url );}

get_custom_header 自定义顶部get_custom_header 函数是 WordPress 3.4 送给我们的新礼物，该函数的出现是为了更好的集成和封装顶部的使用，本文主要对 get_custom_header 这个函数进行详解、以及如何在 WordPress 3.4 版本的主题中集成顶部功能。

请注意，根据本文折腾你的主题时，请确保你的 WordPress 已经升级到 3.4版本。

get_custom_header 意义详解自定义顶部目前大部分主题主要用到的还只是两个功能 1.自定义顶部图像 2.自定义顶部样式具体的效果你可以看一下 默认主题 twenty eleven ，或者我的另一个博客 悠悠我心本函数是 WP 3.4 版本后才出现的一个内置函数，主要用于将用户设置的顶部的各项参数以对象（object）的形式返回。单单说这么句屁话，也许你还不明白，想要明白的话，请往下看。请注意本函数与get_header()有着本质的区别。

函数使用实例下面的例子来自于 默认主题 twenty eleven 中 header.php 文件PHP 代码：

//判断是否存在该函数，以便兼容老版本if ( function_exists( "get_custom_header" ) ) {//get_custom_header()->width 调用带向 width 属性$header_image_width = get_custom_header()->width;//get_custom_header()->height 调用带向 height 属性$header_image_height = get_custom_header()->height;} else {//兼容老版本的代码$header_image_width = HEADER_IMAGE_WIDTH;$header_image_height = HEADER_IMAGE_HEIGHT;}

综合使用详解以下主要援引官方文档解释 自定义顶部

//打开主题自定义顶部支持add_theme_support( "custom-header" ); $headarg = 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" => "",);//将数组中的设置添加到自定义顶部上add_theme_support( "custom-header", $headarg );

自定义顶部图像

//打开主题自定义顶部支持add_theme_support( "custom-header" ); $headarg = 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" => "",);//将数组中的设置添加到自定义顶部上add_theme_support( "custom-header", $headarg );

自适应顶部图像设置

$args = array( "flex-width"  => true,//自适应高度 "width"     => 980, "flex-width"  => true,//自适应宽度 "height"    => 200, "default-image" => get_template_directory_uri() . "/images/header.jpg",);add_theme_support( "custom-header", $args );

自定义顶部图像的调用

<img   src="<?php header_image(); ?>"   height="<?php echo get_custom_header()->height; ?>"   width="<?php echo get_custom_header()->width; ?>"   alt="" />