当前浏览:首页 / WordPress函数 / register_default_headers()

register_default_headers( array $headers )

注册要由自定义页眉管理UI显示的默认页眉选择

default

headermore...

registermore...


参数

$headers

(array) (必填) 以字符串ID为键的页眉数组,这些ID键包含:'url', 'thumbnail_url', 和 'description'


说明

  • 参数 $headers 是必须的,以便并入已注册的页眉。
  • 要使用自定义页眉,需要此函数。在使用页眉图像之前,必须先注册它。

源码

查看源码 官方文档


更新日志

版本描述
3.0.0开始引入

使用示例

  • 示例1

    实例

    编辑文件functions.php,并添加以下代码,在需要的地方替换图像和描述
    %s 将替换为主题路径,因此请将图像放置在主题目录中。

    register_default_headers( array(
    	'wheel' => array(
    		'url'           => '%s/images/headers/wheel.jpg',
    		'thumbnail_url' => '%s/images/headers/wheel-thumbnail.jpg',
    		'description'   => __( 'Wheel', 'twentyeleven' )
    	),
    	'shore' => array(
    		'url'           => '%s/images/headers/shore.jpg',
    		'thumbnail_url' => '%s/images/headers/shore-thumbnail.jpg',
    		'description'   => __( 'Shore', 'twentyeleven' )
    	),
    	'trolley' => array(
    		'url'           => '%s/images/headers/trolley.jpg',
    		'thumbnail_url' => '%s/images/headers/trolley-thumbnail.jpg',
    		'description'   => __( 'Trolley', 'twentyeleven' )
    	)
    ) );
    

    注意:上面的代码是从TwentyEleven主题文件中提取的。

    要引用子主题(即样式表目录)中的图像,请使用%2$s而不是%s。

    register_default_headers( array(
    	'child' => array(
    		'url'           => '%2$s/images/headers/child.jpg',
    		'thumbnail_url' => '%2$s/images/headers/child-thumbnail.jpg',
    		'description'   => __( 'Child', 'twentyeleven' )
    	)
    	)
    ) );