首页>文档>WordPress模板标签>get_sidebar() – 加载侧边栏

get_sidebar() – 加载侧边栏

模板标签

get_sidebar( string $name = null, array $args = array() )

加载侧边栏

说明

包括主题的侧边栏模板,或者如果指定了名称,则将包含专门的侧边栏。

对于参数,如果文件名为“ sidebar-special.php”,则指定“ special”。

参数

$name

字符串 (可选) 专用边栏的名称。

默认值:null

$args

array (可选) 传递到侧边栏模板的其他参数。

默认值:array()

返回

(void | false)成功时无效,如果模板不存在,则为false。

来源

文件:wp-includes / general-template.php

function get_sidebar( $name = null, $args = array() ) {
    /**
     * Fires before the sidebar template file is loaded.
     *
     * @since 2.2.0
     * @since 2.8.0 The `$name` parameter was added.
     * @since 5.5.0 The `$args` parameter was added.
     *
     * @param string|null $name Name of the specific sidebar file to use. Null for the default sidebar.
     * @param array       $args Additional arguments passed to the sidebar template.
     */
    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;
    }
}

官方原文档

https://developer.wordpress.org/reference/functions/get_sidebar/

个人中心
今日签到
有新私信 私信列表
搜索