wppaste
WordPress

WP_Widget_Links

Since
2.8.0
Source
wp-includes/widgets/class-wp-widget-links.php:17
Core class used to implement a Links widget.

Compatibility

WordPress
since 2.8.0
  • 6.7.7
  • 6.8.8
  • 6.9.7
  • 7.0.4
  • 7.1.0

Present in every tracked release (6.7.7 to 7.1.0).

Hooks and filters fired · 1

Every hook that fires from inside WP_Widget_Links, in the order it appears in the class, grouped by the method that fires it.

Methods · 4

  • __construct()Sets up a new Links widget instance.
  • widget()Outputs the content for the current Links widget instance.
  • update()Handles updating settings for the current Links widget instance.
  • form()Outputs the settings form for the Links widget.

Source code

class WP_Widget_Links extends WP_Widget { 	/**	 * Sets up a new Links widget instance.	 *	 * @since 2.8.0	 */	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	 *	 * @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 = $instance['description'] ?? false;		$show_name        = $instance['name'] ?? false;		$show_rating      = $instance['rating'] ?? false;		$show_images      = $instance['images'] ?? true;		$category         = $instance['category'] ?? false;		$orderby          = $instance['orderby'] ?? 'name';		$order            = 'rating' === $orderby ? 'DESC' : 'ASC';		$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,		); 		/**		 * Filters the arguments for the Links widget.		 *		 * @since 2.6.0		 * @since 4.4.0 Added the `$instance` parameter.		 *		 * @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	 *	 * @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,

Changelog

Introduced in 2.8.0. Unchanged from 6.7.7 through 7.1.0.

  1. 6.7.7
  2. 6.8.8
  3. 6.9.7
  4. 7.0.4
  5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data
Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/widgets/class-wp-widget-links.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
Corrections
Something wrong on this page? Report it and it gets fixed in the next regeneration.