WordPress主题制作中自定义头部的相关PHP函数解析

 更新时间:2016年01月08日 16:08:03   作者:稍息少年  
这篇文章主要介绍了WordPress主题制作中自定义头部的相关PHP函数解析,包括header_image()函数和get_custom_header()函数的用法讲解,需要的朋友可以参考下

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="" 
/>

相关文章

  • 加强版phplib的DB类

    加强版phplib的DB类

    为了便于自己的开发,又不想使用ADODB、PEAR::DB这样的庞然大物, 就用在PHPLib DB类的基础上、参考PEAR::DB类,封装的DB类,简单好使,非常方便。 MySQL有效
    2008-03-03
  • 逆序二维数组插入一元素的php代码

    逆序二维数组插入一元素的php代码

    逆序二维数组插入一元素的php代码,需要的朋友可以参考下
    2012-06-06
  • PHP number_format函数原理及实例解析

    PHP number_format函数原理及实例解析

    这篇文章主要介绍了PHP number_format函数原理及实例解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-07-07
  • PHP通过get方法获得form表单数据方法总结

    PHP通过get方法获得form表单数据方法总结

    这篇文章我们给大家介绍了PHP如何通过get的方式来得到获取form表单数据的方法,有需要的朋友们参考下。
    2018-09-09
  • php对csv文件的读取,写入,输出下载操作详解

    php对csv文件的读取,写入,输出下载操作详解

    以下是php对csv文件的读取,写入,输出下载操作进行了详细的分析介绍,需要的朋友可以过来参考下
    2013-08-08
  • PHP实现查询手机归属地的方法详解

    PHP实现查询手机归属地的方法详解

    最近通过在网上面的学习,完成了 PHP 实现手机归属地查询的功能。所以下面这篇文章主要给大家介绍了利用PHP实现查询手机归属地的方法,文中给出了详细的代码示例,需要的朋友可以参考借鉴,下面来一起看看吧。
    2017-04-04
  • PHP实现的一致性Hash算法详解【分布式算法】

    PHP实现的一致性Hash算法详解【分布式算法】

    这篇文章主要介绍了PHP实现的一致性Hash算法,结合实例形式详细分析了php一致性Hash算法的概念、原理及相关实现与使用技巧,需要的朋友可以参考下
    2018-03-03
  • PhpStrom使用Xdebug技巧图文教程

    PhpStrom使用Xdebug技巧图文教程

    这篇文章主要为大家介绍了PhpStrom使用Xdebug技巧图文教程详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-08-08
  • 浅析51个PHP处理字符串的函数

    浅析51个PHP处理字符串的函数

    以下是对51个PHP处理字符串的函数进行了详细的分析介绍,包括,计算字符串长度、分割字符串、查找字符串等等各个方面。需要的朋友可以过来参考下
    2013-08-08
  • Linux编译升级php的详细方法

    Linux编译升级php的详细方法

    Linux编译升级php的详细方法,有配置php.ini、配置php-fpm.conf的代码。
    2013-11-11

最新评论