WordPress函数:get_sidebar 加载侧边栏模板文件

江河/ 2023年04月22日/ WordPress/ 浏览 2214

函数原型:


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


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


参数说明:


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


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


函数源码:


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

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

	$templates[] = 'sidebar.php';

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


包含钩子:


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


使用举例:


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


发表评论

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

客服 工单