mirror of
https://github.com/WordPress/WordPress.git
synced 2024-11-14 14:45:45 +01:00
f3f84d2f21
* Introduces `customize-selective-refresh-widgets` theme support feature and adds to themes. * Introduces `customize_selective_refresh` arg for `WP_Widget::$widget_options` and adds to all core widgets. * Remove `selective_refresh` from being a component that can be removed via `customize_loaded_components` filter. * Add `WP_Customize_Widgets::get_selective_refreshable_widgets()` and `WP_Customize_Widgets::is_widget_selective_refreshable()`. * Fix default `selector` for `Partial` instances. * Implement and improve Masronry sidebar refresh logic in Twenty Thirteen and Twenty Fourteen, including preservation of initial widget position after refresh. * Re-initialize ME.js when refreshing `Twenty_Fourteen_Ephemera_Widget`. See #27355. Fixes #35855. Built from https://develop.svn.wordpress.org/trunk@37040 git-svn-id: http://core.svn.wordpress.org/trunk@37007 1a063a9b-81f0-0310-95a4-ce76da25c4cd
167 lines
6.8 KiB
PHP
167 lines
6.8 KiB
PHP
<?php
|
|
/**
|
|
* Widget API: WP_Widget_Links class
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Widgets
|
|
* @since 4.4.0
|
|
*/
|
|
|
|
/**
|
|
* Core class used to implement a Links widget.
|
|
*
|
|
* @since 2.8.0
|
|
*
|
|
* @see WP_Widget
|
|
*/
|
|
class WP_Widget_Links extends WP_Widget {
|
|
|
|
/**
|
|
* Sets up a new Links widget instance.
|
|
*
|
|
* @since 2.8.0
|
|
* @access public
|
|
*/
|
|
public function __construct() {
|
|
$widget_ops = array(
|
|
'description' => __( 'Your blogroll' ),
|
|
'customize_selective_refresh' => true,
|
|
);
|
|
parent::__construct( 'links', __( 'Links' ), $widget_ops );
|
|
}
|
|
|
|
/**
|
|
* Outputs the content for the current Links widget instance.
|
|
*
|
|
* @since 2.8.0
|
|
* @access public
|
|
*
|
|
* @param array $args Display arguments including 'before_title', 'after_title',
|
|
* 'before_widget', and 'after_widget'.
|
|
* @param array $instance Settings for the current Links widget 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;
|
|
$show_images = isset($instance['images']) ? $instance['images'] : true;
|
|
$category = isset($instance['category']) ? $instance['category'] : false;
|
|
$orderby = isset( $instance['orderby'] ) ? $instance['orderby'] : 'name';
|
|
$order = $orderby == 'rating' ? 'DESC' : 'ASC';
|
|
$limit = isset( $instance['limit'] ) ? $instance['limit'] : -1;
|
|
|
|
$before_widget = preg_replace( '/id="[^"]*"/', 'id="%id"', $args['before_widget'] );
|
|
|
|
$widget_links_args = array(
|
|
'title_before' => $args['before_title'],
|
|
'title_after' => $args['after_title'],
|
|
'category_before' => $before_widget,
|
|
'category_after' => $args['after_widget'],
|
|
'show_images' => $show_images,
|
|
'show_description' => $show_description,
|
|
'show_name' => $show_name,
|
|
'show_rating' => $show_rating,
|
|
'category' => $category,
|
|
'class' => 'linkcat widget',
|
|
'orderby' => $orderby,
|
|
'order' => $order,
|
|
'limit' => $limit,
|
|
);
|
|
|
|
/**
|
|
* Filter the arguments for the Links widget.
|
|
*
|
|
* @since 2.6.0
|
|
* @since 4.4.0 The `$instance` parameter was added.
|
|
*
|
|
* @see wp_list_bookmarks()
|
|
*
|
|
* @param array $widget_links_args An array of arguments to retrieve the links list.
|
|
* @param array $instance The settings for the particular instance of the widget.
|
|
*/
|
|
wp_list_bookmarks( apply_filters( 'widget_links_args', $widget_links_args, $instance ) );
|
|
}
|
|
|
|
/**
|
|
* Handles updating settings for the current Links widget instance.
|
|
*
|
|
* @since 2.8.0
|
|
* @access public
|
|
*
|
|
* @param array $new_instance New settings for this instance as input by the user via
|
|
* WP_Widget::form().
|
|
* @param array $old_instance Old settings for this instance.
|
|
* @return array Updated settings to save.
|
|
*/
|
|
public function update( $new_instance, $old_instance ) {
|
|
$new_instance = (array) $new_instance;
|
|
$instance = array( 'images' => 0, 'name' => 0, 'description' => 0, 'rating' => 0 );
|
|
foreach ( $instance as $field => $val ) {
|
|
if ( isset($new_instance[$field]) )
|
|
$instance[$field] = 1;
|
|
}
|
|
|
|
$instance['orderby'] = 'name';
|
|
if ( in_array( $new_instance['orderby'], array( 'name', 'rating', 'id', 'rand' ) ) )
|
|
$instance['orderby'] = $new_instance['orderby'];
|
|
|
|
$instance['category'] = intval( $new_instance['category'] );
|
|
$instance['limit'] = ! empty( $new_instance['limit'] ) ? intval( $new_instance['limit'] ) : -1;
|
|
|
|
return $instance;
|
|
}
|
|
|
|
/**
|
|
* Outputs the settings form for the Links widget.
|
|
*
|
|
* @since 2.8.0
|
|
* @access public
|
|
*
|
|
* @param array $instance Current settings.
|
|
*/
|
|
public function form( $instance ) {
|
|
|
|
//Defaults
|
|
$instance = wp_parse_args( (array) $instance, array( 'images' => true, 'name' => true, 'description' => false, 'rating' => false, 'category' => false, 'orderby' => 'name', 'limit' => -1 ) );
|
|
$link_cats = get_terms( 'link_category' );
|
|
if ( ! $limit = intval( $instance['limit'] ) )
|
|
$limit = -1;
|
|
?>
|
|
<p>
|
|
<label for="<?php echo $this->get_field_id('category'); ?>"><?php _e( 'Select Link Category:' ); ?></label>
|
|
<select class="widefat" id="<?php echo $this->get_field_id('category'); ?>" name="<?php echo $this->get_field_name('category'); ?>">
|
|
<option value=""><?php _ex('All Links', 'links widget'); ?></option>
|
|
<?php
|
|
foreach ( $link_cats as $link_cat ) {
|
|
echo '<option value="' . intval( $link_cat->term_id ) . '"'
|
|
. selected( $instance['category'], $link_cat->term_id, false )
|
|
. '>' . $link_cat->name . "</option>\n";
|
|
}
|
|
?>
|
|
</select>
|
|
<label for="<?php echo $this->get_field_id('orderby'); ?>"><?php _e( 'Sort by:' ); ?></label>
|
|
<select name="<?php echo $this->get_field_name('orderby'); ?>" id="<?php echo $this->get_field_id('orderby'); ?>" class="widefat">
|
|
<option value="name"<?php selected( $instance['orderby'], 'name' ); ?>><?php _e( 'Link title' ); ?></option>
|
|
<option value="rating"<?php selected( $instance['orderby'], 'rating' ); ?>><?php _e( 'Link rating' ); ?></option>
|
|
<option value="id"<?php selected( $instance['orderby'], 'id' ); ?>><?php _e( 'Link ID' ); ?></option>
|
|
<option value="rand"<?php selected( $instance['orderby'], 'rand' ); ?>><?php _ex( 'Random', 'Links widget' ); ?></option>
|
|
</select>
|
|
</p>
|
|
<p>
|
|
<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'); ?>" />
|
|
<label for="<?php echo $this->get_field_id('images'); ?>"><?php _e('Show Link Image'); ?></label><br />
|
|
<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'); ?>" />
|
|
<label for="<?php echo $this->get_field_id('name'); ?>"><?php _e('Show Link Name'); ?></label><br />
|
|
<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'); ?>" />
|
|
<label for="<?php echo $this->get_field_id('description'); ?>"><?php _e('Show Link Description'); ?></label><br />
|
|
<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'); ?>" />
|
|
<label for="<?php echo $this->get_field_id('rating'); ?>"><?php _e('Show Link Rating'); ?></label>
|
|
</p>
|
|
<p>
|
|
<label for="<?php echo $this->get_field_id('limit'); ?>"><?php _e( 'Number of links to show:' ); ?></label>
|
|
<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" />
|
|
</p>
|
|
<?php
|
|
}
|
|
}
|