register_widget()函数-WP常用函数

register_widget()函数是用来注册一个新的小工具。

语法结构

<?php register_widget( $widget_class ) ?>

参数

$widget_class指的是注册小工具的类的 extends WP_Widget

实例

<?php class ProductWidget extends WP_Widget {
    public function __construct() {
        $widget_pro = array ( //一个数组提供了Widget的一些基本信息
            'description' => "设置侧边栏产品"
        );
        parent::__construct('pic', "近期产品",$widget_pro);
    }
    // $args中包含了4个值：before_title，after_title，before_widget，after_widget，
       分别是要显示在title和widget前后的html。
    // $instance是当前Widget的一些属性设置
    public function widget( $args, $instance ) {
        $url = $instance[ 'depth' ];
        $link = $instance[ 'link' ];
        $title = $instance['title'];
        extract( $args );
        echo $before_widget;
        ?>
        <div class="pic">
            <a href="<?php echo $link; ?>"><img src="<?php echo $url; ?>" title="<?php echo $title; ?>" alt="<?php echo $title; ?>" style="max-width: 100%;"></a>
        </div>
        <?php
    }

    public function form( $instance ) {
        // Output admin widget options form
        $defaults = array(
            'depth' => '-1'
        );
        $depth = $instance[ 'depth' ];
        $link = $instance[ 'link' ];
        $title = $instance['title'];
        // markup for form
        ?>
        <p>
            <label for="<?php echo $this->get_field_id('title'); ?>">填写图片标题</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 esc_attr($title); ?>" />
        </p>
        <p>
            <label for="<?php echo $this->get_field_id( 'depth' ); ?>">填写图片地址</label>
            <input class="widefat" type="text" id="<?php echo $this->get_field_id( 'depth' ); ?>" name="<?php echo $this->get_field_name( 'depth' ); ?>" value="<?php echo esc_attr( $depth ); ?>">
        </p>
        <p>
            <label for="<?php echo $this->get_field_id( 'link' ); ?>">填写图片链接</label>
            <input class="widefat" type="text" id="<?php echo $this->get_field_id( 'link' ); ?>" name="<?php echo $this->get_field_name( 'link' ); ?>" value="<?php echo esc_attr( $link ); ?>">
        </p>
        <?php
    }
    public function update( $new_instance, $old_instance ) {
        // Save widget options
        $instance = $old_instance;
        $instance[ 'depth' ] = strip_tags( $new_instance[ 'depth' ] );
        $instance[ 'link' ] = strip_tags( $new_instance[ 'link' ] );
        $instance['title'] = strip_tags($new_instance['title']);
        return $instance;
    }
}
function register_widgets() {
    register_widget( 'ProductWidget' );
}
add_action( 'widgets_init', 'register_widgets' );

unregister_widget()函数用来删除默认的小工具

语法结构

<?php unregister_widget( $widget_class ) ?>

$widget_class指的是一些已WordPress定义的类

实例

function remove_default_widgets() {
    unregister_widget('WP_Widget_Pages'); //Pages Widget 页面
    unregister_widget('WP_Widget_Calendar'); //Calendar Widget 日历
    unregister_widget('WP_Widget_Archives'); //Archives Widget 文章归档
    unregister_widget('WP_Widget_Media_Audio '); //Audio Player Media Widget 视频
    unregister_widget('WP_Widget_Media_Image '); //Image Media Widget 画廊
    unregister_widget('WP_Widget_Media_Video'); //Video Media Widget 音频 
    unregister_widget('WP_Widget_Meta'); //Meta Widget 功能
    unregister_widget('WP_Widget_Search'); //Search Widget 搜索
    unregister_widget('WP_Widget_Text'); //Text Widget 文本
    unregister_widget('WP_Widget_Categories'); //Categories Widget 分类目录
    unregister_widget('WP_Widget_Recent_Posts'); //Recent Posts Widget 近期文章
    unregister_widget('WP_Widget_Recent_Comments'); //Recent Comments Widget 近期评论
    unregister_widget('WP_Widget_RSS'); //RSS Widget 
    unregister_widget('WP_Widget_Tag_Cloud'); //Tag Cloud Widget 标签云
    unregister_widget('WP_Nav_Menu_Widget'); //Menus Widget 导航菜单
    unregister_widget('WP_Widget_Custom_HTML') //Custom HTML Widget 自定义HTML
}
add_action('widgets_init', 'remove_default_widgets'); <br>