WordPress中用于创建以及获取侧边栏的PHP函数讲解

php  /  管理员 发布于 7年前   189

register_sidebar()（创建侧边栏）
建立一个侧边栏，用来放置小工具。这个函数使用的时候请放在一个函数里，挂载到 “widgets_init” 钩子。

用法

register_sidebar( $args );

参数

$args

（字符串 | 数组）（可选）要创建的侧边栏的参数。

默认值：

$args = array(  'name'     => __( 'Sidebar name', 'theme_text_domain' ),  'id'      => 'unique-sidebar-id',  'description'  => '',  'class'     => '',  'before_widget' => '
',  'after_widget' => '
',  'before_title' => '
',  'after_title'  => '
');

数组参数介绍：

• name：侧边栏名称
• id：侧边栏 ID，必须为小写，默认为递增的数组 ID
• description：侧边栏描述
• class：给其中的小工具的额外 class
• before_widget：里边的小工具的开头 Html 代码
• after_widget：里边的小工具的末尾的 Html 代码
• before_title：里边的小工具的标题的开头 Html 代码
• after_title：里边的小工具的标题的末尾的 Html 代码

例子

register_sidebar( array(  'name'     => __( '右边的侧边栏' ),  'id'      => 'sidebar-1',  'description' => __( '右侧边栏的小工具。' ),  'before_title' => '
',  'after_title' => '
',));

其它

该函数位于：wp-includes/widgets.php

get_sidebar()（获取侧边栏）
get_sidebar() 用来引入侧边栏模板。如果指定名称则引入当前主题根目录的 sidebar-{name}.php 文件，不指定则引入当前主题根目录的 sidebar.php 文件，如果文件不存在则引入 wp-includes/theme-compat/sidebar.php 文件。

用法

get_sidebar( $name );

参数

$name

（字符串）（可选）引入模板的名称，如果指定则引入当前主题根目录的 sidebar-{$name}.php 文件。

默认值：None

例子

下边的代码将引入当前主题根目录的 sidebar.php 文件：

下边的代码将引入当前主题根目录的 sidebar-left.php 文件：

下边的例子分别引入了左侧边栏（sidebar-left.php）和右侧边栏（sidebar-right.php）：

内容内容

其它

此函数位于：wp-includes/general-template.php

您可能感兴趣的文章:

• 解析WordPress中控制用户登陆和判断用户登陆的PHP函数
• 编写PHP脚本清除WordPress头部冗余代码的方法讲解
• WordPress主题制作中自定义头部的相关PHP函数解析
• WordPress中调试缩略图的相关PHP函数使用解析
• WordPress开发中自定义菜单的相关PHP函数使用简介
• WordPress中用于获取搜索表单的PHP函数使用解析
• 详解WordPress中创建和添加过滤器的相关PHP函数
• 讲解WordPress中用于获取评论模板和搜索表单的PHP函数
• WordPress中编写自定义存储字段的相关PHP函数解析
• 详解WordPress中用于更新和获取用户选项数据的PHP函数