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 相关文章推荐
php设计模式 Decorator(装饰模式)
Jun 26 PHP
php读取远程gzip压缩网页的方法
Dec 29 PHP
php+html5使用FormData对象提交表单及上传图片的方法
Feb 11 PHP
memcache一致性hash的php实现方法
Mar 05 PHP
PHP调试的强悍利器之PHPDBG
Feb 22 PHP
详解PHP的Yii框架中的Controller控制器
Mar 29 PHP
Yii实现文章列表置顶功能示例
Oct 18 PHP
php实现异步将远程链接上内容(图片或内容)写到本地的方法
Nov 30 PHP
php 7新特性之类型申明详解
Jun 06 PHP
PHP实现压缩图片尺寸并转为jpg格式的方法示例
May 10 PHP
php用xpath解析html的代码实例讲解
Feb 14 PHP
PHP使用观察者模式处理异常信息的方法详解
Sep 24 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引用返回与取消引用的详解
2013/06/08 PHP
php socket客户端及服务器端应用实例
2014/07/04 PHP
php中rename函数用法分析
2014/11/15 PHP
PHP 枚举类型的管理与设计知识点总结
2020/02/13 PHP
img标签中onerror用法
2009/08/13 Javascript
ExtJS Ext.MessageBox.alert()弹出对话框详解
2010/04/02 Javascript
Jquery chosen动态设置值实例介绍
2013/08/08 Javascript
javascript同页面多次调用弹出层具体实例代码
2013/08/16 Javascript
js防止表单重复提交的两种方法
2013/09/30 Javascript
返回上一页并自动刷新的JavaScript代码
2014/02/19 Javascript
jquerymobile局部渲染的各种刷新方法小结
2014/03/05 Javascript
jQuery实现“扫码阅读”功能
2015/01/21 Javascript
使用angular写一个hello world
2015/01/23 Javascript
JS选取DOM元素的简单方法
2016/07/08 Javascript
详解Angular.js的$q.defer()服务异步处理
2016/11/06 Javascript
js滚轮事件兼容性问题需要注意哪些
2016/11/15 Javascript
深入理解Webpack 中路径的配置
2017/06/17 Javascript
react native 文字轮播的实现示例
2018/07/27 Javascript
详解如何在vscode里面调试js和node.js的方法步骤
2018/12/24 Javascript
微信小程序实现文字无限轮播效果
2018/12/28 Javascript
微信小程序模板消息推送的两种实现方式
2019/08/27 Javascript
python根据unicode判断语言类型实例代码
2018/01/17 Python
使用Python实现从各个子文件夹中复制指定文件的方法
2018/10/25 Python
python实现桌面壁纸切换功能
2019/01/21 Python
基于python的socket实现单机五子棋到双人对战
2020/03/24 Python
Python完全识别验证码自动登录实例详解
2019/11/24 Python
利用python中集合的唯一性实现去重
2020/02/11 Python
Html5之webcoekt播放JPEG图片流
2020/09/22 HTML / CSS
探矿工程师自荐信
2014/01/24 职场文书
抵押贷款承诺书
2014/05/30 职场文书
工作失职检讨书
2015/01/26 职场文书
暂住证明怎么写
2015/06/19 职场文书
Html分层的box-shadow效果的示例代码
2021/03/30 HTML / CSS
MySQL一些常用高级SQL语句
2021/07/03 MySQL
PostgreSQL13基于流复制搭建后备服务器的方法
2022/01/18 PostgreSQL
win10忘记pin密码登录不了怎么办?win10忘记pin密码登不进去的解决方法
2022/07/07 数码科技