WordPress函数：get_sidebar（获取侧边栏）

本文目录
[隐藏]

• 1描述
• 2用法
• 3参数
• 4例子
  • 4.1404页面
  • 4.2左边栏和右边栏
  • 4.3多个边栏
• 5资源文件
• 6相关函数

描述

引入当前主题的模板文件 sidebar.php 。如果使用特定的名字 ($name) ，那么就会引用包含这个特定名字的模板文件 sidebar-{name}.php 。

如果主题没有 sidebar.php 文件，就会引入默认的 wp-includes/theme-compat/sidebar.php 。

用法

1

<?php get_sidebar( $name ); ?>

<?php get_sidebar( $name ); ?>

参数

$name

(string) (可选) 调用 sidebar-name.php.

默认: None

例子

404页面

下面的代码是一个简单模板文件，专门用来显示 “HTTP 404: Not Found” 错误的 （这个文件应该包含在你的主题中，名为 404.php）

1
2
3
4

<?php get_header(); ?>
<h2>Error 404 - Not Found</h2>
<?php get_sidebar(); ?>
<?php get_footer(); ?>

<?php get_header(); ?> <h2>Error 404 – Not Found</h2> <?php get_sidebar(); ?> <?php get_footer(); ?>

左边栏和右边栏

一个主题包含2个边栏。

1
2
3
4

<?php get_header(); ?>
<?php get_sidebar('left'); ?>
<?php get_sidebar('right'); ?>
<?php get_footer(); ?>

<?php get_header(); ?> <?php get_sidebar(‘left’); ?> <?php get_sidebar(‘right’); ?> <?php get_footer(); ?>

右边栏和左边栏的名字应该分别命名为 sidebar-right.php 和 sidebar-left.php。

多个边栏

不同页面使用不同边栏

1
2
3
4
5
6
7
8
9

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

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

首页和404页面专用的边栏的名字应该分别为 sidebar-home.php 和 sidebar-404.php。

资源文件

get_sidebar() 包含在 wp-includes/general-template.php.

相关函数