PageRenderTime 23ms CodeModel.GetById 11ms app.highlight 9ms RepoModel.GetById 1ms app.codeStats 0ms

/wp-includes/widgets/class-wp-widget-links.php

https://bitbucket.org/skyarch-iijima/wordpress
PHP | 162 lines | 93 code | 12 blank | 57 comment | 5 complexity | a62c1c6a35b50e475f626fa52dc41821 MD5 | raw file
  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 */
 17class 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}