当前浏览:首页 / WordPress函数 / register_sidebars()

register_sidebars( int $number = 1, array|string $args = array() )

创建多个边栏

registermore...

sidebar 侧边栏


描述

如果你想为一个主题或内部快速创建多个边栏。此功能将允许您执行此操作。如果您没有在$args中传递“name” 和/或 “id”,那么它们将为您构建。

另见


参数

$number

(int) (可选) 要创建的边栏数。

默认值: 1

$args

(array|string) (可选) 用于构建边栏的数组或字符串参数。

  • 'id'
    (string) 每个侧边栏的唯一标识符的基本字符串。如果提供了,并且定义了多个侧边栏,ID将有"-2"的附加值,以此类推。默认为'sidebar-',后面跟的是当前创建侧边栏的编号。
  • 'name'
    (string) 在管理仪表板上显示的侧边栏名称或标题。如果注册了一个以上的侧边栏,在字符串中包含'%d',作为每个侧边栏的唯一指定编号的占位符。第一个侧边栏默认为 "Sidebar",否则为 "Sidebar %d"。

默认值: array()



源码

查看源码 官方文档


更新日志

版本描述
2.2.0开始引入

使用示例

  • 示例1

    示例
    这将注册一个名为sidebar的边栏:

    register_sidebars();
    

    这将创建两个名为“Foobar 1”和“Foobar 2”的边栏:

    register_sidebars( 2, array( 'name' => 'Foobar %d' ) );
    

    这将创建两个标题包装在<h1> 和 </h1>:

    register_sidebars( 2, array(
    	'before_title' => '<h1>',
    	'after_title'  => '</h1>'
    ) );