X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/9e77185fafaf4e60e2b73821e0e4b9b1a11fb85f..dc1231b7312fbdca99e9e887cc2bb35a28f85cdc:/wp-includes/default-widgets.php diff --git a/wp-includes/default-widgets.php b/wp-includes/default-widgets.php index d54dbc73..48a39179 100644 --- a/wp-includes/default-widgets.php +++ b/wp-includes/default-widgets.php @@ -18,6 +18,10 @@ class WP_Widget_Pages extends WP_Widget { parent::__construct('pages', __('Pages'), $widget_ops); } + /** + * @param array $args + * @param array $instance + */ public function widget( $args, $instance ) { /** @@ -67,6 +71,11 @@ class WP_Widget_Pages extends WP_Widget { } } + /** + * @param array $new_instance + * @param array $old_instance + * @return array + */ public function update( $new_instance, $old_instance ) { $instance = $old_instance; $instance['title'] = strip_tags($new_instance['title']); @@ -81,6 +90,9 @@ class WP_Widget_Pages extends WP_Widget { return $instance; } + /** + * @param array $instance + */ public function form( $instance ) { //Defaults $instance = wp_parse_args( (array) $instance, array( 'sortby' => 'post_title', 'title' => '', 'exclude' => '') ); @@ -118,8 +130,11 @@ class WP_Widget_Links extends WP_Widget { parent::__construct('links', __('Links'), $widget_ops); } + /** + * @param array $args + * @param array $instance + */ public function widget( $args, $instance ) { - $show_description = isset($instance['description']) ? $instance['description'] : false; $show_name = isset($instance['name']) ? $instance['name'] : false; $show_rating = isset($instance['rating']) ? $instance['rating'] : false; @@ -151,6 +166,11 @@ class WP_Widget_Links extends WP_Widget { ) ) ); } + /** + * @param array $new_instance + * @param array $old_instance + * @return array + */ public function update( $new_instance, $old_instance ) { $new_instance = (array) $new_instance; $instance = array( 'images' => 0, 'name' => 0, 'description' => 0, 'rating' => 0 ); @@ -169,6 +189,9 @@ class WP_Widget_Links extends WP_Widget { return $instance; } + /** + * @param array $instance + */ public function form( $instance ) { //Defaults @@ -227,8 +250,11 @@ class WP_Widget_Search extends WP_Widget { parent::__construct( 'search', _x( 'Search', 'Search widget' ), $widget_ops ); } + /** + * @param array $args + * @param array $instance + */ public function widget( $args, $instance ) { - /** This filter is documented in wp-includes/default-widgets.php */ $title = apply_filters( 'widget_title', empty( $instance['title'] ) ? '' : $instance['title'], $instance, $this->id_base ); @@ -243,6 +269,9 @@ class WP_Widget_Search extends WP_Widget { echo $args['after_widget']; } + /** + * @param array $instance + */ public function form( $instance ) { $instance = wp_parse_args( (array) $instance, array( 'title' => '') ); $title = $instance['title']; @@ -251,6 +280,11 @@ class WP_Widget_Search extends WP_Widget { '')); @@ -272,6 +306,10 @@ class WP_Widget_Archives extends WP_Widget { parent::__construct('archives', __('Archives'), $widget_ops); } + /** + * @param array $args + * @param array $instance + */ public function widget( $args, $instance ) { $c = ! empty( $instance['count'] ) ? '1' : '0'; $d = ! empty( $instance['dropdown'] ) ? '1' : '0'; @@ -285,10 +323,10 @@ class WP_Widget_Archives extends WP_Widget { } if ( $d ) { + $dropdown_id = "{$this->id_base}-dropdown-{$this->number}"; ?> - 'monthly', 'format' => 'option', 'show_post_count' => $c - ) ) ); -?> + ) ); + + switch ( $dropdown_args['type'] ) { + case 'yearly': + $label = __( 'Select Year' ); + break; + case 'monthly': + $label = __( 'Select Month' ); + break; + case 'daily': + $label = __( 'Select Day' ); + break; + case 'weekly': + $label = __( 'Select Week' ); + break; + default: + $label = __( 'Select Post' ); + break; + } + ?> + + + + '', 'count' => 0, 'dropdown' => '') ); @@ -342,6 +407,9 @@ class WP_Widget_Archives extends WP_Widget { return $instance; } + /** + * @param array $instance + */ public function form( $instance ) { $instance = wp_parse_args( (array) $instance, array( 'title' => '', 'count' => 0, 'dropdown' => '') ); $title = strip_tags($instance['title']); @@ -372,8 +440,11 @@ class WP_Widget_Meta extends WP_Widget { parent::__construct('meta', __('Meta'), $widget_ops); } + /** + * @param array $args + * @param array $instance + */ public function widget( $args, $instance ) { - /** This filter is documented in wp-includes/default-widgets.php */ $title = apply_filters( 'widget_title', empty($instance['title']) ? __( 'Meta' ) : $instance['title'], $instance, $this->id_base ); @@ -408,6 +479,11 @@ class WP_Widget_Meta extends WP_Widget { echo $args['after_widget']; } + /** + * @param array $new_instance + * @param array $old_instance + * @return array + */ public function update( $new_instance, $old_instance ) { $instance = $old_instance; $instance['title'] = strip_tags($new_instance['title']); @@ -415,6 +491,9 @@ class WP_Widget_Meta extends WP_Widget { return $instance; } + /** + * @param array $instance + */ public function form( $instance ) { $instance = wp_parse_args( (array) $instance, array( 'title' => '' ) ); $title = strip_tags($instance['title']); @@ -436,8 +515,11 @@ class WP_Widget_Calendar extends WP_Widget { parent::__construct('calendar', __('Calendar'), $widget_ops); } + /** + * @param array $args + * @param array $instance + */ public function widget( $args, $instance ) { - /** This filter is documented in wp-includes/default-widgets.php */ $title = apply_filters( 'widget_title', empty( $instance['title'] ) ? '' : $instance['title'], $instance, $this->id_base ); @@ -451,6 +533,11 @@ class WP_Widget_Calendar extends WP_Widget { echo $args['after_widget']; } + /** + * @param array $new_instance + * @param array $old_instance + * @return array + */ public function update( $new_instance, $old_instance ) { $instance = $old_instance; $instance['title'] = strip_tags($new_instance['title']); @@ -458,6 +545,9 @@ class WP_Widget_Calendar extends WP_Widget { return $instance; } + /** + * @param array $instance + */ public function form( $instance ) { $instance = wp_parse_args( (array) $instance, array( 'title' => '' ) ); $title = strip_tags($instance['title']); @@ -481,8 +571,11 @@ class WP_Widget_Text extends WP_Widget { parent::__construct('text', __('Text'), $widget_ops, $control_ops); } + /** + * @param array $args + * @param array $instance + */ public function widget( $args, $instance ) { - /** This filter is documented in wp-includes/default-widgets.php */ $title = apply_filters( 'widget_title', empty( $instance['title'] ) ? '' : $instance['title'], $instance, $this->id_base ); @@ -504,6 +597,11 @@ class WP_Widget_Text extends WP_Widget { echo $args['after_widget']; } + /** + * @param array $new_instance + * @param array $old_instance + * @return array + */ public function update( $new_instance, $old_instance ) { $instance = $old_instance; $instance['title'] = strip_tags($new_instance['title']); @@ -511,10 +609,13 @@ class WP_Widget_Text extends WP_Widget { $instance['text'] = $new_instance['text']; else $instance['text'] = stripslashes( wp_filter_post_kses( addslashes($new_instance['text']) ) ); // wp_filter_post_kses() expects slashed - $instance['filter'] = isset($new_instance['filter']); + $instance['filter'] = ! empty( $new_instance['filter'] ); return $instance; } + /** + * @param array $instance + */ public function form( $instance ) { $instance = wp_parse_args( (array) $instance, array( 'title' => '', 'text' => '' ) ); $title = strip_tags($instance['title']); @@ -523,7 +624,8 @@ class WP_Widget_Text extends WP_Widget {

- +

+

/> 

id_base ); @@ -556,10 +665,20 @@ class WP_Widget_Categories extends WP_Widget { echo $args['before_title'] . $title . $args['after_title']; } - $cat_args = array('orderby' => 'name', 'show_count' => $c, 'hierarchical' => $h); + $cat_args = array( + 'orderby' => 'name', + 'show_count' => $c, + 'hierarchical' => $h + ); if ( $d ) { - $cat_args['show_option_none'] = __('Select Category'); + $dropdown_id = ( $first_dropdown ) ? 'cat' : "{$this->id_base}-dropdown-{$this->number}"; + $first_dropdown = false; + + echo ''; + + $cat_args['show_option_none'] = __( 'Select Category' ); + $cat_args['id'] = $dropdown_id; /** * Filter the arguments for the Categories widget drop-down. @@ -575,13 +694,15 @@ class WP_Widget_Categories extends WP_Widget { @@ -608,6 +729,11 @@ class WP_Widget_Categories extends WP_Widget { echo $args['after_widget']; } + /** + * @param array $new_instance + * @param array $old_instance + * @return array + */ public function update( $new_instance, $old_instance ) { $instance = $old_instance; $instance['title'] = strip_tags($new_instance['title']); @@ -618,6 +744,9 @@ class WP_Widget_Categories extends WP_Widget { return $instance; } + /** + * @param array $instance + */ public function form( $instance ) { //Defaults $instance = wp_parse_args( (array) $instance, array( 'title' => '') ); @@ -659,7 +788,11 @@ class WP_Widget_Recent_Posts extends WP_Widget { add_action( 'switch_theme', array($this, 'flush_widget_cache') ); } - public function widget($args, $instance) { + /** + * @param array $args + * @param array $instance + */ + public function widget( $args, $instance ) { $cache = array(); if ( ! $this->is_preview() ) { $cache = wp_cache_get( 'widget_recent_posts', 'widget' ); @@ -737,6 +870,11 @@ class WP_Widget_Recent_Posts extends WP_Widget { } } + /** + * @param array $new_instance + * @param array $old_instance + * @return array + */ public function update( $new_instance, $old_instance ) { $instance = $old_instance; $instance['title'] = strip_tags($new_instance['title']); @@ -751,10 +889,16 @@ class WP_Widget_Recent_Posts extends WP_Widget { return $instance; } + /** + * @access public + */ public function flush_widget_cache() { wp_cache_delete('widget_recent_posts', 'widget'); } + /** + * @param array $instance + */ public function form( $instance ) { $title = isset( $instance['title'] ) ? esc_attr( $instance['title'] ) : ''; $number = isset( $instance['number'] ) ? absint( $instance['number'] ) : 5; @@ -792,8 +936,10 @@ class WP_Widget_Recent_Comments extends WP_Widget { add_action( 'transition_comment_status', array($this, 'flush_widget_cache') ); } + /** + * @access public + */ public function recent_comments_style() { - /** * Filter the Recent Comments default widget styles. * @@ -810,10 +956,20 @@ class WP_Widget_Recent_Comments extends WP_Widget { '; - if ( $comments ) { + if ( is_array( $comments ) && $comments ) { // Prime cache for associated posts. (Prime post term cache if we need it for permalinks.) $post_ids = array_unique( wp_list_pluck( $comments, 'comment_post_ID' ) ); _prime_post_caches( $post_ids, strpos( get_option( 'permalink_structure' ), '%category%' ), false ); @@ -891,6 +1047,11 @@ class WP_Widget_Recent_Comments extends WP_Widget { } } + /** + * @param array $new_instance + * @param array $old_instance + * @return array + */ public function update( $new_instance, $old_instance ) { $instance = $old_instance; $instance['title'] = strip_tags($new_instance['title']); @@ -904,6 +1065,9 @@ class WP_Widget_Recent_Comments extends WP_Widget { return $instance; } + /** + * @param array $instance + */ public function form( $instance ) { $title = isset( $instance['title'] ) ? esc_attr( $instance['title'] ) : ''; $number = isset( $instance['number'] ) ? absint( $instance['number'] ) : 5; @@ -930,8 +1094,11 @@ class WP_Widget_RSS extends WP_Widget { parent::__construct( 'rss', __('RSS'), $widget_ops, $control_ops ); } - public function widget($args, $instance) { - + /** + * @param array $args + * @param array $instance + */ + public function widget( $args, $instance ) { if ( isset($instance['error']) && $instance['error'] ) return; @@ -983,15 +1150,23 @@ class WP_Widget_RSS extends WP_Widget { unset($rss); } - public function update($new_instance, $old_instance) { + /** + * @param array $new_instance + * @param array $old_instance + * @return array + */ + public function update( $new_instance, $old_instance ) { $testurl = ( isset( $new_instance['url'] ) && ( !isset( $old_instance['url'] ) || ( $new_instance['url'] != $old_instance['url'] ) ) ); return wp_widget_rss_process( $new_instance, $testurl ); } - public function form($instance) { - - if ( empty($instance) ) + /** + * @param array $instance + */ + public function form( $instance ) { + if ( empty( $instance ) ) { $instance = array( 'title' => '', 'url' => '', 'items' => 10, 'error' => false, 'show_summary' => 0, 'show_author' => 0, 'show_date' => 0 ); + } $instance['number'] = $this->number; wp_widget_rss_form( $instance ); @@ -1225,6 +1400,10 @@ class WP_Widget_Tag_Cloud extends WP_Widget { parent::__construct('tag_cloud', __('Tag Cloud'), $widget_ops); } + /** + * @param array $args + * @param array $instance + */ public function widget( $args, $instance ) { $current_taxonomy = $this->_get_current_taxonomy($instance); if ( !empty($instance['title']) ) { @@ -1265,12 +1444,21 @@ class WP_Widget_Tag_Cloud extends WP_Widget { echo $args['after_widget']; } + /** + * @param array $new_instance + * @param array $old_instance + * @return array + */ public function update( $new_instance, $old_instance ) { + $instance = array(); $instance['title'] = strip_tags(stripslashes($new_instance['title'])); $instance['taxonomy'] = stripslashes($new_instance['taxonomy']); return $instance; } + /** + * @param array $instance + */ public function form( $instance ) { $current_taxonomy = $this->_get_current_taxonomy($instance); ?> @@ -1288,6 +1476,10 @@ class WP_Widget_Tag_Cloud extends WP_Widget {

'', 'menu' => $nav_menu ) ); + $nav_menu_args = array( + 'fallback_cb' => '', + 'menu' => $nav_menu + ); + + /** + * Filter the arguments for the Custom Menu widget. + * + * @since 4.2.0 + * + * @param array $nav_menu_args { + * An array of arguments passed to wp_nav_menu() to retrieve a custom menu. + * + * @type callback|bool $fallback_cb Callback to fire if the menu doesn't exist. Default empty. + * @type mixed $menu Menu ID, slug, or name. + * } + * @param stdClass $nav_menu Nav menu object for the current menu. + * @param array $args Display arguments for the current widget. + */ + wp_nav_menu( apply_filters( 'widget_nav_menu_args', $nav_menu_args, $nav_menu, $args ) ); echo $args['after_widget']; } + /** + * @param array $new_instance + * @param array $old_instance + * @return array + */ public function update( $new_instance, $old_instance ) { $instance = array(); if ( ! empty( $new_instance['title'] ) ) { @@ -1339,36 +1559,45 @@ class WP_Widget_Tag_Cloud extends WP_Widget { return $instance; } + /** + * @param array $instance + */ public function form( $instance ) { $title = isset( $instance['title'] ) ? $instance['title'] : ''; $nav_menu = isset( $instance['nav_menu'] ) ? $instance['nav_menu'] : ''; // Get menus - $menus = wp_get_nav_menus( array( 'orderby' => 'name' ) ); + $menus = wp_get_nav_menus(); // If no menus exists, direct the user to go and create some. - if ( !$menus ) { - echo '

'. sprintf( __('No menus have been created yet. Create some.'), admin_url('nav-menus.php') ) .'

'; - return; - } ?> -

- - -

-

- - + ?> + Create some.' ), esc_attr( $url ) ); ?>

+