WordPress函数:get_header 加载头部模板文件

江河/ 2023年04月21日/ WordPress/ 浏览 1949

函数原型:


get_header( string $name = null, array $args = array() ): void|false


包含主题的标题模板,或者如果指定了名称,则将包含专用标题。对于参数 $name,如果文件名为“header-specific.php”,则应指定 $name 为:“special”。


如果主题不包含header.php文件,那么将包括默认主题wp-includs/theme-compat/header.php的头。


参数说明:


$name,指定 header 模板的名称,如果为空则加载 header.php。如果 $name='special',则加载 header-specific.php 。


$args,传给 header 模板的参数。


函数源码:


function get_header( $name = null, $args = array() ) {
	do_action( 'get_header', $name, $args );

	$templates = array();
	$name      = (string) $name;
	if ( '' !== $name ) {
		$templates[] = "header-{$name}.php";
	}

	$templates[] = 'header.php';

	if ( ! locate_template( $templates, true, true, $args ) ) {
		return false;
	}
}


包含钩子:


do_action( 'get_header', string|null $name, array $args )


使用举例:


<?php
if ( is_home() ) :
	get_header( 'home' );
elseif ( is_404() ) :
	get_header( '404' );
else :
	get_header();
endif;
?>


发表评论

暂无评论,抢个沙发...

客服 工单