> WordPress开发手册 > the_widget

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' )

上一篇:
下一篇: