Maison  >  Article  >  développement back-end  >  WordPress中用于创建以及获取侧边栏的PHP函数讲解

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

WBOY
WBOYoriginal
2016-07-29 09:08:22944parcourir

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' => '<h3>',
      'after_title' => '</h3>',
    ));
    

    其它

    该函数位于: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教程有兴趣的朋友有所帮助。

    Déclaration:
    Le contenu de cet article est volontairement contribué par les internautes et les droits d'auteur appartiennent à l'auteur original. Ce site n'assume aucune responsabilité légale correspondante. Si vous trouvez un contenu suspecté de plagiat ou de contrefaçon, veuillez contacter admin@php.cn