the_widget() 是一个模板标签，用来显示任何一个小工具。它可以在模板的任何地方使用。

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

参数
widget：（字符串）小工具的 PHP 类名。

• WP_Widget_Archives —— Archives
• WP_Widget_Calendar —— Calendar
• WP_Widget_Categories —— Categories
• WP_Widget_Links —— Links
• WP_Widget_Meta —— Meta
• WP_Widget_Pages —— Pages
• WP_Widget_Recent_Comments —— Recent Comments
• WP_Widget_Recent_Posts —— Recent Posts
• WP_Widget_RSS —— RSS
• WP_Widget_Search —— Search (a search from)
• WP_Widget_Tag_Cloud —— Tag Cloud
• WP_Widget_Text —— Text
• WP_Nav_Menu_Widget

instance：（数组或query-string-style）小工具的实例设置。具体请看下面的小工具示例。

args：（数组或query-string-style）小工具的侧边栏参数。

• before_widget（字符串）小工具前的文本或HTML代码默认值：<div class="widget {小工具的类名}">
• after_widget（字符串）小工具后的文本或HTML代码默认值：</div>
• before_title（字符串）小工具标题前的文本或HTML代码默认值：<h2 class="小工具标题">
• after_title（字符串）小工具标题后的文本或HTML代码默认值：</h2>

存档小工具：显示每月存档列表

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

小工具类名：widget_archive
instance：

• title 存档列表的标题。默认值：文章归档
• coun 显示每个存档的文章数。wp_get_archives的show_post_count参数默认值：0 （隐藏）可选：1 （显示）
• dropdow 以下拉菜单显示存档列默认值：0（不使用下拉列表）可选：1 （使用下拉列表）

默认用法：<?php the_widget('WP_Widget_Archives'); ?>
显示下拉列表：<?php the_widget('WP_Widget_Archives', 'dropdown=1'); ?>

日历小工具：显示一个文章日历存档

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

小工具类名：widget_calendar
instance：

• title 日历的标题。默认为空。

默认用法：<?php the_widget('WP_Widget_Calendar'); ?>

分类小工具：显示分类列表

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

小工具类名：widget_categories
instance：

• title 分类列表的标题。默认值：分类目录
• count 显示每个分类的文章数。wp_dropdown_categories或wp_list_categories的show_count参数。默认值：0（隐藏）可选：1（显示）
• hierarchical 以层级关系显示分类列表。默认值：0（不显示层级）可选：1（显示层级）
• dropdown 以下拉列表显示分类列表。默认值：0（不使用下拉列表）可选：1（使用下拉列表）

默认用法：<?php the_widget('WP_Widget_Categories'); ?>

下拉显示带文章篇数的分类列表：<?php the_widget('WP_Widget_Categories', 'dropdown=1&count=1'); ?>

链接小工具：按分类显示链接

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

小工具类名：widget_links
instance：

• title 链接小工具的标题
• category 链接的分类ID，多个ID使用英文逗号隔开。wp_list_bookmarks的category参数。默认值：false（显示所有链接分类）
• description 显示链接的描述。show_description参数。默认值：0 –false（隐藏）可选：1 – true（显示）
• rating 显示链接评级。show_rating参数。默认值：0 –false（隐藏）可选：1 – true（显示）
• images 显示链接的图片。show_images参数。默认值：1 – true （显示）可选：0 –false（隐藏）
• name 如果显示链接图片，输出图片的alt值。show_name参数。默认：默认值：0 –false（隐藏）可选：1 – true（显示）

默认用法：<?php the_widget('WP_Widget_Links'); ?>

显示分类ID为 2 或 3 的链接：<?php the_widget('WP_Widget_Links', 'category=2,3'); ?>

PS.在 WordPress 3.5 以后默认去掉了链接管理功能，所以该小工具也默认不显示。如需开启，请自定义主题函数如下：
add_filter( 'pre_option_link_manager_enabled', '__return_true' );

Meta小工具：显示网站的Meta信息（登录、登出，管理，Feed 和WordPress链接）

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

小工具类名：widget_meta
instance：

• title Meta小工具的标题。默认值：功能

默认用法：<?php the_widget('WP_Widget_Meta'); ?>

页面小工具：显示页面列表

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

小工具类名：widget_pages
instance：

• title 页面列表的标题。默认值：页面
• sortby 排列方式。wp_list_pages的sort_column参数。默认值：menu_order
• exclude 页面ID，多个ID使用英文逗号隔开。从列表中排除某些ID的页面。默认值：null（显示所有页面）

默认用法：<?php the_widget('WP_Widget_Pages'); ?>

使用

Contents

最近评论小工具：显示最近的评论

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

小工具类名：widget_recent_comments
instance：

• title 评论列表的标题。默认值：近期评论
• number 评论的显示数量（最多15条）。默认：5

默认用法：<?php the_widget('WP_Widget_Recent_Comments'); ?>

最新文章小工具：显示最近发布的文章

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

小工具类名：widget_recent_entries
instance：

• title 文章列表的标题。默认值：近期文章
• number 要显示的文章数量（最多15）。默认：5

默认用法：<?php the_widget('WP_Widget_Recent_Posts'); ?>

RSS小工具：显示来自任何RSS或Atom订阅的文章

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

小工具类名：widget_rss
instance：

• title 文章列表的标题。默认值：订阅源的标题
• url 包含RSS或Atom订阅的URL。
• items 要显示的RSS 或 Atom 项目的数量。
• show_summary 显示文章摘要。
• show_author 显示作者。
• show_date 显示日期。

默认用法：<?php the_widget('WP_Widget_RSS'); ?>

搜索小工具：显示一个搜索表单

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

小工具类名：widget_search
instance：

• title 搜索表单的标题。默认为空

默认用法：<?php the_widget('WP_Widget_Search'); ?>

标签云小工具

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

小工具类名：widget_tag_cloud
instance：

• title 标签云小工具的标题。默认值：标签云
• taxonomy 要显示的分类法。默认值：post_tag（文章标签）

默认用法：<?php the_widget( 'WP_Widget_Tag_Cloud'); ?>

文本小工具

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

小工具类名：widget_text
instance：

• title 文本小工具的标题。默认为空
• text 要显示的内容
• filter

默认用法：<?php the_widget('WP_Widget_Text'); ?>

菜单小工具：显示自定义菜单

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

小工具类名：widget_nav_menu
默认用法：<?php the_widget('WP_Widget_Nav_Menu'); ?>