|
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 } |