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