get_sidebar

描述

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

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

用法

    <?php get_sidebar( $name ); ?>

参数

$name

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

        默认: None

例子

404页面

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

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

左边栏和右边栏

一个主题包含2个边栏。

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

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

多个边栏

不同页面使用不同边栏

<?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.