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


Posted in PHP onDecember 29, 2015

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

PHP 相关文章推荐
收集的DedeCMS一些使用经验
Mar 17 PHP
php的curl实现get和post的代码
Aug 23 PHP
检测png图片是否完整的php代码
Sep 06 PHP
PHP排序之二维数组的按照字母排序实现代码
Aug 13 PHP
PHP和javascript常用正则表达式及用法实例
Jul 01 PHP
ThinkPHP模板之变量输出、自定义函数与判断语句用法
Nov 01 PHP
php中try catch捕获异常实例详解
Nov 21 PHP
深入浅出php socket编程
May 13 PHP
mac系统下为 php 添加 pcntl 扩展
Aug 28 PHP
Yii2创建多界面主题(Theme)的方法
Oct 08 PHP
PHP中上传文件打印错误错误类型分析
Apr 14 PHP
Thinkphp5.0框架视图view的循环标签用法示例
Oct 12 PHP
Yii使用技巧大汇总
Dec 29 #PHP
PHP实现批量上传单个文件
Dec 29 #PHP
使用phpstorm和xdebug实现远程调试的方法
Dec 29 #PHP
PHP远程调试之XDEBUG
Dec 29 #PHP
从性能方面考虑PHP下载远程文件的3种方法
Dec 29 #PHP
Yii快速入门经典教程
Dec 28 #PHP
WordPress主题制作之模板文件的引入方法
Dec 28 #PHP
You might like
php trim 去除空字符的定义与语法介绍
2010/05/31 PHP
PHP对XML内容进行修改和删除实例代码
2016/10/26 PHP
PHP 裁剪图片
2021/03/09 PHP
初识javascript 文档碎片
2010/07/13 Javascript
jquery配合css简单实现返回顶部效果
2013/09/30 Javascript
将input file的选择的文件清空的两种解决方案
2013/10/21 Javascript
JSON格式化输出
2014/11/10 Javascript
jQuery遍历json中多个map的方法
2015/02/12 Javascript
JavaScript实现的一个倒计时的类
2015/03/12 Javascript
jQuery position() 函数详解以及jQuery中position函数的应用
2015/12/14 Javascript
一款简单的jQuery图片标注效果附源码下载
2016/03/22 Javascript
jquery实现无刷新验证码的简单实例
2016/05/19 Javascript
通过网页查看JS源码中汉字显示乱码的解决方法
2016/10/26 Javascript
简单实现jquery焦点图
2016/12/12 Javascript
用vue的双向绑定简单实现一个todo-list的示例代码
2017/08/03 Javascript
Django使用多数据库的方法
2017/09/06 Javascript
JavaScript数组去重的多种方法(四种)
2017/09/19 Javascript
vue获取input输入值的问题解决办法
2017/10/17 Javascript
详解JavaScript实现动态的轮播图效果
2019/04/29 Javascript
微信小程序动画组件使用解析,类似vue,且更强大
2019/08/01 Javascript
JS实现多功能计算器
2020/10/28 Javascript
node.js 基于 STMP 协议和 EWS 协议发送邮件
2021/02/14 Javascript
python 不关闭控制台的实现方法
2011/10/23 Python
python实现读取命令行参数的方法
2015/05/22 Python
实用自动化运维Python脚本分享
2018/06/04 Python
python 输入一个数n,求n个数求乘或求和的实例
2018/11/13 Python
Python爬虫防封ip的一些技巧
2020/08/06 Python
python基于Kivy写一个图形桌面时钟程序
2021/01/28 Python
一款纯css3实现的响应式导航
2014/10/31 HTML / CSS
HTML5 虚拟键盘出现挡住输入框的解决办法
2017/02/14 HTML / CSS
html5手机键盘弹出收起的处理
2020/01/20 HTML / CSS
主管职责范文
2013/11/09 职场文书
档案检查欢迎词
2014/01/13 职场文书
机械制造毕业生求职信
2014/03/03 职场文书
公司转让协议书
2016/03/19 职场文书
Python合并多张图片成PDF
2021/06/09 Python