WP_Widget_Pages

17class WP_Widget_Pages extends WP_Widget {18 19	/**20	 * Sets up a new Pages widget instance.21	 *22	 * @since 2.8.023	 */24	public function __construct() {25		$widget_ops = array(26			'classname'                   => 'widget_pages',27			'description'                 => __( 'A list of your site&#8217;s Pages.' ),28			'customize_selective_refresh' => true,29			'show_instance_in_rest'       => true,30		);31		parent::__construct( 'pages', __( 'Pages' ), $widget_ops );32	}33 34	/**35	 * Outputs the content for the current Pages widget instance.36	 *37	 * @since 2.8.038	 *39	 * @param array $args     Display arguments including 'before_title', 'after_title',40	 *                        'before_widget', and 'after_widget'.41	 * @param array $instance Settings for the current Pages widget instance.42	 */43	public function widget( $args, $instance ) {44		$default_title = __( 'Pages' );45		$title         = ! empty( $instance['title'] ) ? $instance['title'] : $default_title;46 47		/**48		 * Filters the widget title.49		 *50		 * @since 2.6.051		 *52		 * @param string $title    The widget title. Default 'Pages'.53		 * @param array  $instance Array of settings for the current widget.54		 * @param mixed  $id_base  The widget ID.55		 */56		$title = apply_filters( 'widget_title', $title, $instance, $this->id_base );57 58		$sortby  = empty( $instance['sortby'] ) ? 'menu_order' : $instance['sortby'];59		$exclude = empty( $instance['exclude'] ) ? '' : $instance['exclude'];60 61		if ( 'menu_order' === $sortby ) {62			$sortby = 'menu_order, post_title';63		}64 65		$output = wp_list_pages(66			/**67			 * Filters the arguments for the Pages widget.68			 *69			 * @since 2.8.070			 * @since 4.9.0 Added the `$instance` parameter.71			 *72			 * @see wp_list_pages()73			 *74			 * @param array $args     An array of arguments to retrieve the pages list.75			 * @param array $instance Array of settings for the current widget.76			 */77			apply_filters(78				'widget_pages_args',79				array(80					'title_li'    => '',81					'echo'        => 0,82					'sort_column' => $sortby,83					'exclude'     => $exclude,84				),85				$instance86			)87		);88 89		if ( ! empty( $output ) ) {90			echo $args['before_widget'];91			if ( $title ) {92				echo $args['before_title'] . $title . $args['after_title'];93			}94 95			$format = current_theme_supports( 'html5', 'navigation-widgets' ) ? 'html5' : 'xhtml';96