the_widget

如果你已经了解有一部分 WordPress 函数了，而且对成品主题的修改也勉强能够达到自己的要求，那么祝贺你，你离玩转 wp 又进了一步。也许你像我一样，不断的学习、探讨、实验，不断的觉得 WordPress 是一个神秘的东西，我们总是能在使用的时候发现新的东西，就像 the_widget() 函数。

the_widget() 函数，用于定制、修改 wordpress 中内置的小工具样式，如果你想在你得主题里默认提供一些小工具，而不想要写太多的代码，那么你就要尝试一下 the_widget() 这个神奇的函数。

描述 Description

This template tag the_widget() displays an arbitrary widget as a template tag. It can be used anywhere in templates.

很不幸，这个函数中文手册中没有进行翻译，所以下面请大家欣赏一下鄙人的翻译：
中文： the_widget() 这个模板标签（函数），用于显示一个类似于其他标签一样的、定制（自定义）的小工具。该标签可以用于模板的任何位置。（噶的说，翔子的英文真不咋地）。

使用

the_widget($widget, $instance, $args);

永远都不要埋怨API手册，因为每一个手册都会把既定用户想象成为有一定知识基础的青年。
如果你对$widget, $instance, $args 这三个变量如何设置有疑虑的话，那么网络上有一篇文章肯定能够帮到你，
不得言：《WordPress函数the_widget介绍、使用技巧》
值得一提的是该文作者对本函数的使用方面给予了比较充分的讲解，但需要注意的是，作者对$instance 这个变量翻译的有点差强人意，在这里给更正一下，
$instance参数：是$widget删除指定的函数所支持的参数。
这里应该解释为：是对你将要调用的 widget 自定义参数。具体的我就不说了，请参看上面链接。

实例

以下的代码也许能给你使用该函数些许提示，
该部分代码出自 WordPress 默认主题，Twenty_Eleven 本目录下 404.PHP 文件

//调用10篇最新文章，
the_widget( 'WP_Widget_Recent_Posts', array( 'number' => 10 ), array( 'widget_id' => '404' ) );  
//调用默认样式的云标签
the_widget( 'WP_Widget_Tag_Cloud' )