WordPress如何添加自定义小工具

想在自己WordPress网站侧栏上加个展示每日一句话的功能模块,发现网站本身主题的widget小工具都没有合适的,就自己在网上搜了些知识要点,自己编写了个每日一言widget小工具,下边贴下我的笔记。
WordPress如何添加自定义小工具

WordPress如何添加自定义小工具

第一步咱先来瞧一瞧widget小工具的代码结构:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
//继承了 WP_Widget 这个类来创建新的小工具(Widget)
class Test_Widget extends WP_Widget {
function Test_Widget() {
// 主要内容方法
}
function form($instance) {
// 给小工具(widget) 添加表单内容
}
function update($new_instance, $old_instance) {
// 进行更新保存
}
function widget($args, $instance) {
// 输出显示在页面上
}
}
register_widget('Test_Widget');

我们可以利用上面的代码结构来写一个测试示例。代码如下所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
<?php
class Test_Widget extends WP_Widget {
  function Test_Widget ()
  {
    $widget_ops = array('description' => '一个简单的小测试');
    $control_ops = array('width' => 400, 'height' => 300);
    parent::WP_Widget(false,$name='一个简单的Widget',$widget_ops,$control_ops);  
                //parent::直接使用父类中的方法
                //$name 这个小工具的名称,
                //$widget_ops 可以给小工具进行描述等等。
                //$control_ops 可以对小工具进行简单的样式定义等等。
  }
  function form($instance) { // 给小工具(widget) 添加表单内容
    $title = esc_attr($instance['title']);
  ?>
  <p>
     <label for="<?php echo $this->get_field_id('title'); ?>">
        <?php esc_attr_e('Title:'); ?>
            <input class="widefat" id="<?php echo $this->get_field_id('title'); ?>" name="<?php echo $this->get_field_name('title'); ?>" type="text" value="<?php echo $title; ?>" />
     </label>
</p>
  <?php
    }
  function update($new_instance, $old_instance) { // 更新保存
  $instance = $old_instance;
  $instance[ 'title' ] = strip_tags( $new_instance[ 'title' ] );
      return $instance;
  }
  function widget($args, $instance) { // 输出显示在页面上
  extract( $args );
        $title = apply_filters('widget_title', empty($instance['title']) ? __('小测试') : $instance['title']);
        ?>
              <?php echo $before_widget; ?>
                  <?php if ( $title )
                        echo $before_title . $title . $after_title; ?>
              <?php echo $after_widget; ?>

        <?php
  }
}
register_widget('Test_Widget');
?>

模板主题目录下新建一个test-widget.php文件,把上边小工具代码放入test-widget.php,之后在functions.php调用test-widget.php就可以了。调用代码如下所示:

1
require_once( dirname(__FILE__) . '/test-widget.php' );