之前介绍了如何让 WordPress 主题支持小工具的方法，默认的情况，只有不几个小工具，而且在国内这些小工具好多都不太常用。
如果你想给你的主题添加一个自定义小工具，或者你要开发一个添加小工具的插件，那就需要查看本文了。
创建小工具
创建一个小工具，需要使用 register_widget() 函数挂载一个继承于 WP_Widget 类的类，下边是一个简单的例子，创建了一个随机文章小工具。
注意，register_widget() 函数需要在 widgets_init 钩子上调用。
class widget_tags extends WP_Widget{ //添加小工具 function __construct(){ $this->WP_Widget( 'random_posts', __( '随机文章', 'Bing' ), array( 'description' => __( '显示几篇随机文章', 'Bing' ) ) ); } //小工具内容 function widget( $args, $instance ){ //导入当前侧边栏设置 extract( $args, EXTR_SKIP ); //输出小工具前代码 echo $before_widget; //输出小工具标题 echo $before_title . '随机文章' . $after_title; //随机文章 query_posts( 'orderby=rand&showposts=10' ); if( have_posts() ): echo '<ul>'; while( have_posts() ): the_post(); printf( '<li><a href="%s" title="%s">%s</a></li>', get_permalink(), get_the_title(), get_the_title() ); endwhile; echo '</ul>'; endif; //输出小工具后代码 echo $after_widget; } } function Bing_add_widget_tags(){ register_widget( 'widget_tags' ); } add_action( 'widgets_init', 'Bing_add_widget_tags' );
这样，后台就会出现了一个随机文章小工具，拖动到侧边栏上，会在前台显示十篇随机文章。
小工具设置
但我们会发现这个小工具并没有设置选项，那如何给这个小工具添加设置选项呢？设置选项涉及类的两个函数，update()（更新小工具设置时的处理函数）和 form()（设置表单）。
下边的代码添加了一个标题设置和显示文章数量的设置：
class widget_tags extends WP_Widget{ //添加小工具 function __construct(){ $this->WP_Widget( 'random_posts', __( '随机文章', 'Bing' ), array( 'description' => __( '显示几篇随机文章', 'Bing' ) ) ); } //小工具内容 function widget( $args, $instance ){ //导入当前侧边栏设置 extract( $args, EXTR_SKIP ); //输出小工具前代码 echo $before_widget; //输出小工具标题 echo $before_title . '随机文章' . $after_title; //随机文章 query_posts( 'orderby=rand&showposts=10' ); if( have_posts() ): echo '<ul>'; while( have_posts() ): the_post(); printf( '<li><a href="%s" title="%s">%s</a></li>', get_permalink(), get_the_title(), get_the_title() ); endwhile; echo '</ul>'; endif; //输出小工具后代码 echo $after_widget; } //更新选项 function update( $instance, $old_instance ){ $instance['title'] = strip_tags( $instance['title'] ); $instance['number'] = (int) strip_tags( $instance['number'] ); return $instance; } //选项表单 function form( $instance ){ //添加默认设置 $instance = wp_parse_args( $instance, array( 'title' => __( '随机文章', 'Bing' ), 'number' => 10 ) ); //设置表单 ?> <p> <label for="<?php echo $this->get_field_id( 'title' ); ?>"><?php _e( '标题', 'Bing' ); ?>：</label> <input class="widefat" id="<?php echo $this->get_field_id( 'title' ); ?>" name="<?php echo $this->get_field_name( 'title' ); ?>" type="text" value="<?php echo $instance['title']; ?>" /> </p> <p> <label for="<?php echo $this->get_field_id( 'number' ); ?>"><?php _e( '文章数量', 'Bing' ); ?>：</label> <input class="widefat" id="<?php echo $this->get_field_id( 'number' ); ?>" name="<?php echo $this->get_field_name( 'number' ); ?>" type="number" value="<?php echo $instance['number']; ?>" /> </p> <?php } } function Bing_add_widget_tags(){ register_widget( 'widget_tags' ); } add_action( 'widgets_init', 'Bing_add_widget_tags' );
这样再展开小工具，就能看到设置了：
然后，在生成小工具内容的时候使用选项，就能达到用户自定义的效果。
class widget_tags extends WP_Widget{ //添加小工具 function __construct(){ $this->WP_Widget( 'random_posts', __( '随机文章', 'Bing' ), array( 'description' => __( '显示几篇随机文章', 'Bing' ) ) ); } //小工具内容 function widget( $args, $instance ){ //导入当前侧边栏设置 extract( $args, EXTR_SKIP ); //添加小工具标题过滤器 $title = apply_filters( 'widget_name', $instance['title'] ); //输出小工具前代码 echo $before_widget; //输出小工具标题 echo $before_title . $title . $after_title; //随机文章 query_posts( 'orderby=rand&showposts=' . $instance['number'] ); if( have_posts() ): echo '<ul>'; while( have_posts() ): the_post(); printf( '<li><a href="%s" title="%s">%s</a></li>', get_permalink(), get_the_title(), get_the_title() ); endwhile; echo '</ul>'; endif; //输出小工具后代码 echo $after_widget; } //更新选项 function update( $instance, $old_instance ){ $instance['title'] = strip_tags( $instance['title'] ); $instance['number'] = (int) strip_tags( $instance['number'] ); return $instance; } //选项表单 function form( $instance ){ //添加默认设置 $instance = wp_parse_args( $instance, array( 'title' => __( '随机文章', 'Bing' ), 'number' => 10 ) ); //设置表单 ?> <p> <label for="<?php echo $this->get_field_id( 'title' ); ?>"><?php _e( '标题', 'Bing' ); ?>：</label> <input class="widefat" id="<?php echo $this->get_field_id( 'title' ); ?>" name="<?php echo $this->get_field_name( 'title' ); ?>" type="text" value="<?php echo $instance['title']; ?>" /> </p> <p> <label for="<?php echo $this->get_field_id( 'number' ); ?>"><?php _e( '文章数量', 'Bing' ); ?>：</label> <input class="widefat" id="<?php echo $this->get_field_id( 'number' ); ?>" name="<?php echo $this->get_field_name( 'number' ); ?>" type="number" value="<?php echo $instance['number']; ?>" /> </p> <?php } } function Bing_add_widget_tags(){ register_widget( 'widget_tags' ); } add_action( 'widgets_init', 'Bing_add_widget_tags' );
