描述

此模板标签在侧边栏外显示任意的小部件。它可以在模板的任何地方使用。

用法


 <?php the_widget( $widget, $instance, $args ); ?> 

参数

$widget
(string)(必需)小部件的PHP类名称。WordPress附带的小部件的类是:
WP_Widget_Archives - 档案
WP_Widget_Calendar - 日历
WP_Widget_Categories - 类别
WP_Widget_Links - 链接
WP_Widget_Meta - 元
WP_Widget_Pages - 页
WP_Widget_Recent_Comments - 最近的评论
WP_Widget_Recent_Posts - 最近的帖子
WP_Widget_RSS - RSS
WP_Widget_Search - 搜索(搜索)
WP_Widget_Tag_Cloud - 标签云
WP_Widget_Text - 文本
WP_Nav_Menu_Widget
默认值:无

$instance(array | string)(可选)窗口小部件的实例设置。数组或查询式字符串。看下面的每个小部件的例子。
默认值:array()
$ args
(array | string)(可选)小部件的侧边栏引用。数组或查询式字符串。如果为空,则默认为:
before_widget
(字符串)小部件的文本或HTML。
默认值:div class =“widget {widget's classname}”
after_widget
(字符串)小部件后的文本或HTML。
默认值:
before_title
(字符串)小部件的标题之前的文本或HTML。
默认值:h2 class =“widgettitle”
after_title
(字符串)小部件的标题后的文本或HTML。
默认值:/ h2

默认值:array()

档案小工具

显示每月存档列表。


 <?php the_widget( 'WP_Widget_Archives', $instance, $args ); ?> 

小部件的类名称: widget_archive
例如:
标题
归档列表的标题。默认:__('Archives')
计数
显示每个档案中的帖子数(1)。该show_post_count的参数wp_get_archives。默认值:0(隐藏)
落下
显示为下拉列表(1)。默认值:0(无序列表)

例子

默认用法:


<?php the_widget( 'WP_Widget_Archives' ); ?> 
//显示下拉列表: 
 <?php the_widget( 'WP_Widget_Archives', 'dropdown=1' ); ?> 

日历小工具

显示日历。


<?php the_widget( 'WP_Widget_Calendar', $instance, $args ); ?> 

小部件的类名称: widget_calendar
例如:
标题
日历的标题 默认:

默认用法:


<?php the_widget( 'WP_Widget_Calendar' ); ?> 

类别小部件

显示类别列表


<?php the_widget( 'WP_Widget_Categories', $instance, $args ); ?> 

小部件的类名称: widget_categories
例如:
标题
类别列表的标题。默认:__( 'Categories' )
计数
显示每个类别的帖子数。wp_dropdown_categories或wp_list_categories的show_count参数。默认值:0(隐藏)
分级
将子类别显示为父类别(1)中的嵌套项目。默认值:0(行内)
落下
显示为下拉列表(1)。默认值:0(无序列表)

例子

默认用法:


<?php the_widget('WP_Widget_Categories'); ?> 
//显示包含帖子数量的下拉列表。 
<?php the_widget( 'WP_Widget_Categories', 'dropdown=1&count=1' ); ?> 

链接小部件

显示类别中的链接列表(blogroll)。


 <?php the_widget( 'WP_Widget_Links', $instance, $args ); ?> 

小部件的类名称:
例如:
标题
链接部分的标题。
类别
链接类别ID,以逗号分隔,以显示。wp_list_bookmarks的类别参数。默认值:false(显示所有链接类别)
描述
显示链接的描述(1 - true)。该show_description参数。默认值:false(hide)
评分
显示链接评分(1- true)。该show_rating参数。默认值:false(hide)
图片
显示链接的图像(1 - 真)。该show_images参数。默认值:true(显示)
名称
如果显示链接图像,输出链接名称到alt属性。该SHOW_NAME参数。默认值:false

例子

默认用法:


<?php the_widget( 'WP_Widget_Links' ); ?> 
//类别ID 2或3中的显示列表: 
<?php the_widget( 'WP_Widget_Links', 'category=2,3' ); ?>