home *** CD-ROM | disk | FTP | other *** search
/ HTML Examples / WP.iso / wordpress / wp-includes / widgets / class-wp-widget-links.php < prev    next >
Encoding:
PHP Script  |  2017-10-02  |  6.7 KB  |  163 lines
  1. <?php
  2. /**
  3.  * Widget API: WP_Widget_Links class
  4.  *
  5.  * @package WordPress
  6.  * @subpackage Widgets
  7.  * @since 4.4.0
  8.  */
  9.  
  10. /**
  11.  * Core class used to implement a Links widget.
  12.  *
  13.  * @since 2.8.0
  14.  *
  15.  * @see WP_Widget
  16.  */
  17. class WP_Widget_Links extends WP_Widget {
  18.  
  19.     /**
  20.      * Sets up a new Links widget instance.
  21.      *
  22.      * @since 2.8.0
  23.      */
  24.     public function __construct() {
  25.         $widget_ops = array(
  26.             'description' => __( 'Your blogroll' ),
  27.             'customize_selective_refresh' => true,
  28.         );
  29.         parent::__construct( 'links', __( 'Links' ), $widget_ops );
  30.     }
  31.  
  32.     /**
  33.      * Outputs the content for the current Links widget instance.
  34.      *
  35.      * @since 2.8.0
  36.      *
  37.      * @param array $args     Display arguments including 'before_title', 'after_title',
  38.      *                        'before_widget', and 'after_widget'.
  39.      * @param array $instance Settings for the current Links widget instance.
  40.      */
  41.     public function widget( $args, $instance ) {
  42.         $show_description = isset($instance['description']) ? $instance['description'] : false;
  43.         $show_name = isset($instance['name']) ? $instance['name'] : false;
  44.         $show_rating = isset($instance['rating']) ? $instance['rating'] : false;
  45.         $show_images = isset($instance['images']) ? $instance['images'] : true;
  46.         $category = isset($instance['category']) ? $instance['category'] : false;
  47.         $orderby = isset( $instance['orderby'] ) ? $instance['orderby'] : 'name';
  48.         $order = $orderby == 'rating' ? 'DESC' : 'ASC';
  49.         $limit = isset( $instance['limit'] ) ? $instance['limit'] : -1;
  50.  
  51.         $before_widget = preg_replace( '/id="[^"]*"/', 'id="%id"', $args['before_widget'] );
  52.  
  53.         $widget_links_args = array(
  54.             'title_before'     => $args['before_title'],
  55.             'title_after'      => $args['after_title'],
  56.             'category_before'  => $before_widget,
  57.             'category_after'   => $args['after_widget'],
  58.             'show_images'      => $show_images,
  59.             'show_description' => $show_description,
  60.             'show_name'        => $show_name,
  61.             'show_rating'      => $show_rating,
  62.             'category'         => $category,
  63.             'class'            => 'linkcat widget',
  64.             'orderby'          => $orderby,
  65.             'order'            => $order,
  66.             'limit'            => $limit,
  67.         );
  68.  
  69.         /**
  70.          * Filters the arguments for the Links widget.
  71.          *
  72.          * @since 2.6.0
  73.          * @since 4.4.0 Added the `$instance` parameter.
  74.          *
  75.          * @see wp_list_bookmarks()
  76.          *
  77.          * @param array $widget_links_args An array of arguments to retrieve the links list.
  78.          * @param array $instance          The settings for the particular instance of the widget.
  79.          */
  80.         wp_list_bookmarks( apply_filters( 'widget_links_args', $widget_links_args, $instance ) );
  81.     }
  82.  
  83.     /**
  84.      * Handles updating settings for the current Links widget instance.
  85.      *
  86.      * @since 2.8.0
  87.      *
  88.      * @param array $new_instance New settings for this instance as input by the user via
  89.      *                            WP_Widget::form().
  90.      * @param array $old_instance Old settings for this instance.
  91.      * @return array Updated settings to save.
  92.      */
  93.     public function update( $new_instance, $old_instance ) {
  94.         $new_instance = (array) $new_instance;
  95.         $instance = array( 'images' => 0, 'name' => 0, 'description' => 0, 'rating' => 0 );
  96.         foreach ( $instance as $field => $val ) {
  97.             if ( isset($new_instance[$field]) )
  98.                 $instance[$field] = 1;
  99.         }
  100.  
  101.         $instance['orderby'] = 'name';
  102.         if ( in_array( $new_instance['orderby'], array( 'name', 'rating', 'id', 'rand' ) ) )
  103.             $instance['orderby'] = $new_instance['orderby'];
  104.  
  105.         $instance['category'] = intval( $new_instance['category'] );
  106.         $instance['limit'] = ! empty( $new_instance['limit'] ) ? intval( $new_instance['limit'] ) : -1;
  107.  
  108.         return $instance;
  109.     }
  110.  
  111.     /**
  112.      * Outputs the settings form for the Links widget.
  113.      *
  114.      * @since 2.8.0
  115.      *
  116.      * @param array $instance Current settings.
  117.      */
  118.     public function form( $instance ) {
  119.  
  120.         //Defaults
  121.         $instance = wp_parse_args( (array) $instance, array( 'images' => true, 'name' => true, 'description' => false, 'rating' => false, 'category' => false, 'orderby' => 'name', 'limit' => -1 ) );
  122.         $link_cats = get_terms( 'link_category' );
  123.         if ( ! $limit = intval( $instance['limit'] ) )
  124.             $limit = -1;
  125.             ?>
  126.         <p>
  127.         <label for="<?php echo $this->get_field_id('category'); ?>"><?php _e( 'Select Link Category:' ); ?></label>
  128.         <select class="widefat" id="<?php echo $this->get_field_id('category'); ?>" name="<?php echo $this->get_field_name('category'); ?>">
  129.         <option value=""><?php _ex('All Links', 'links widget'); ?></option>
  130.         <?php
  131.         foreach ( $link_cats as $link_cat ) {
  132.             echo '<option value="' . intval( $link_cat->term_id ) . '"'
  133.                 . selected( $instance['category'], $link_cat->term_id, false )
  134.                 . '>' . $link_cat->name . "</option>\n";
  135.         }
  136.         ?>
  137.         </select>
  138.         <label for="<?php echo $this->get_field_id('orderby'); ?>"><?php _e( 'Sort by:' ); ?></label>
  139.         <select name="<?php echo $this->get_field_name('orderby'); ?>" id="<?php echo $this->get_field_id('orderby'); ?>" class="widefat">
  140.             <option value="name"<?php selected( $instance['orderby'], 'name' ); ?>><?php _e( 'Link title' ); ?></option>
  141.             <option value="rating"<?php selected( $instance['orderby'], 'rating' ); ?>><?php _e( 'Link rating' ); ?></option>
  142.             <option value="id"<?php selected( $instance['orderby'], 'id' ); ?>><?php _e( 'Link ID' ); ?></option>
  143.             <option value="rand"<?php selected( $instance['orderby'], 'rand' ); ?>><?php _ex( 'Random', 'Links widget' ); ?></option>
  144.         </select>
  145.         </p>
  146.         <p>
  147.         <input class="checkbox" type="checkbox"<?php checked($instance['images'], true) ?> id="<?php echo $this->get_field_id('images'); ?>" name="<?php echo $this->get_field_name('images'); ?>" />
  148.         <label for="<?php echo $this->get_field_id('images'); ?>"><?php _e('Show Link Image'); ?></label><br />
  149.         <input class="checkbox" type="checkbox"<?php checked($instance['name'], true) ?> id="<?php echo $this->get_field_id('name'); ?>" name="<?php echo $this->get_field_name('name'); ?>" />
  150.         <label for="<?php echo $this->get_field_id('name'); ?>"><?php _e('Show Link Name'); ?></label><br />
  151.         <input class="checkbox" type="checkbox"<?php checked($instance['description'], true) ?> id="<?php echo $this->get_field_id('description'); ?>" name="<?php echo $this->get_field_name('description'); ?>" />
  152.         <label for="<?php echo $this->get_field_id('description'); ?>"><?php _e('Show Link Description'); ?></label><br />
  153.         <input class="checkbox" type="checkbox"<?php checked($instance['rating'], true) ?> id="<?php echo $this->get_field_id('rating'); ?>" name="<?php echo $this->get_field_name('rating'); ?>" />
  154.         <label for="<?php echo $this->get_field_id('rating'); ?>"><?php _e('Show Link Rating'); ?></label>
  155.         </p>
  156.         <p>
  157.         <label for="<?php echo $this->get_field_id('limit'); ?>"><?php _e( 'Number of links to show:' ); ?></label>
  158.         <input id="<?php echo $this->get_field_id('limit'); ?>" name="<?php echo $this->get_field_name('limit'); ?>" type="text" value="<?php echo $limit == -1 ? '' : intval( $limit ); ?>" size="3" />
  159.         </p>
  160.         <?php
  161.     }
  162. }
  163.