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

 更新时间:2015年12月29日 14:35:50   转载 作者:斌果  
这篇文章主要介绍了WordPress中用于创建以及获取侧边栏的PHP函数讲解,分别为register_sidebar()函数和get_sidebar()的使用,需要的朋友可以参考下

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

用法

register_sidebar( $args );

参数

$args

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

默认值:

$args = array(
  'name'     => __( 'Sidebar name', 'theme_text_domain' ),
  'id'      => 'unique-sidebar-id',
  'description'  => '',
  'class'     => '',
  'before_widget' => '<li id="%1" class="widget %2">',
  'after_widget' => '</li>',
  'before_title' => '<h2 class="widgettitle">',
  'after_title'  => '</h2>'
);

数组参数介绍:

  • 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' => '<h3 class="title">',
  'after_title' => '</h3 class="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 文件:

<?php get_sidebar(); ?>

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

<?php get_sidebar( 'left' ); ?>

下边的例子分别引入了左侧边栏(sidebar-left.php)和右侧边栏(sidebar-right.php):

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

内容内容

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

其它

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

相关文章

  • 使用PHPStorm+XDebug搭建单步调试环境

    使用PHPStorm+XDebug搭建单步调试环境

    由于 PhpStorm 不像 Zend 公司为 Zend Studio 那样配套集成了很多开发部件,包括解释器、调试器、虚拟机、服务器、开发框架等等。因此,配置 PhpStorm 开发环境相对较繁琐,有很多需要注意的地方。
    2017-11-11
  • PHP 模拟登陆功能实例详解

    PHP 模拟登陆功能实例详解

    这篇文章主要介绍了PHP 模拟登陆功能,结合实例形式详细分析了php基于curl的模拟表单登陆及session信息存储相关操作技巧,需要的朋友可以参考下
    2019-09-09
  • PHP中使用gettext来支持多语言的方法

    PHP中使用gettext来支持多语言的方法

    开发多语言的Web应用是一件非常困难的事,各个国家的字符集的编码方式、货币符号、日期格式、数字格式、文字表现都各不相同.
    2011-05-05
  • php关联数组快速排序的方法

    php关联数组快速排序的方法

    这篇文章主要介绍了php关联数组快速排序的方法,涉及php数组排序的相关技巧,非常具有实用价值,需要的朋友可以参考下
    2015-04-04
  • 探讨如何把session存入数据库

    探讨如何把session存入数据库

    本篇文章是对如何把session存入数据库的方法进行了详细的分析介绍,需要的朋友参考下
    2013-06-06
  • php对关联数组循环遍历的实现方法

    php对关联数组循环遍历的实现方法

    这篇文章主要介绍了php对关联数组循环遍历的实现方法,涉及php操作数组的技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2015-03-03
  • php 中奖概率算法实现代码

    php 中奖概率算法实现代码

    这篇文章主要介绍了php 中奖概率算法,需要的朋友可以参考下
    2017-01-01
  • php将字符串转换成16进制的方法

    php将字符串转换成16进制的方法

    这篇文章主要介绍了php将字符串转换成16进制的方法,涉及php中bin2hex函数的使用技巧,非常具有实用价值,需要的朋友可以参考下
    2015-03-03
  • php查找指定目录下指定大小文件的方法

    php查找指定目录下指定大小文件的方法

    这篇文章主要介绍了php查找指定目录下指定大小文件的方法,首先遍历目录,再查找文件大小,并附带给出了一个计算字节的函数,是非常实用的技巧,需要的朋友可以参考下
    2014-11-11
  • PHP callback函数使用方法和注意事项

    PHP callback函数使用方法和注意事项

    这篇文章主要介绍了PHP callback函数使用方法和注意事项,本文讲解了callback函数的一些使用技巧和避免事项,并给出了一个使用实例,需要的朋友可以参考下
    2015-01-01

最新评论