WP_Widget_Meta::widget( array $args, array $instance )

In this article

Outputs the content for the current Meta widget instance.

Parameters

$argsarrayrequired
Display arguments including 'before_title', 'after_title', 'before_widget', and 'after_widget'.
$instancearrayrequired
Settings for the current Meta widget instance.

Source

public function widget( $args, $instance ) {
	$default_title = __( 'Meta' );
	$title         = ! empty( $instance['title'] ) ? $instance['title'] : $default_title;

	/** This filter is documented in wp-includes/widgets/class-wp-widget-pages.php */
	$title = apply_filters( 'widget_title', $title, $instance, $this->id_base );

	echo $args['before_widget'];

	if ( $title ) {
		echo $args['before_title'] . $title . $args['after_title'];
	}

	$format = current_theme_supports( 'html5', 'navigation-widgets' ) ? 'html5' : 'xhtml';

	/** This filter is documented in wp-includes/widgets/class-wp-nav-menu-widget.php */
	$format = apply_filters( 'navigation_widgets_format', $format );

	if ( 'html5' === $format ) {
		// The title may be filtered: Strip out HTML and make sure the aria-label is never empty.
		$title      = trim( strip_tags( $title ) );
		$aria_label = $title ? $title : $default_title;
		echo '<nav aria-label="' . esc_attr( $aria_label ) . '">';
	}
	?>

	<ul>
		<?php wp_register(); ?>
		<li><?php wp_loginout(); ?></li>
		<li><a href="<?php echo esc_url( get_bloginfo( 'rss2_url' ) ); ?>"><?php _e( 'Entries feed' ); ?></a></li>
		<li><a href="<?php echo esc_url( get_bloginfo( 'comments_rss2_url' ) ); ?>"><?php _e( 'Comments feed' ); ?></a></li>

		<?php
		/**
		 * Filters the "WordPress.org" list item HTML in the Meta widget.
		 *
		 * @since 3.6.0
		 * @since 4.9.0 Added the `$instance` parameter.
		 *
		 * @param string $html     Default HTML for the WordPress.org list item.
		 * @param array  $instance Array of settings for the current widget.
		 */
		echo apply_filters(
			'widget_meta_poweredby',
			sprintf(
				'<li><a href="%1$s">%2$s</a></li>',
				esc_url( __( 'https://wordpress.org/' ) ),
				__( 'WordPress.org' )
			),
			$instance
		);

		wp_meta();
		?>

	</ul>

	<?php
	if ( 'html5' === $format ) {
		echo '</nav>';
	}

	echo $args['after_widget'];
}

Hooks

apply_filters( ‘navigation_widgets_format’, string $format )

Filters the HTML format of widgets with navigation links.

apply_filters( ‘widget_meta_poweredby’, string $html, array $instance )

Filters the “WordPress.org” list item HTML in the Meta widget.

apply_filters( ‘widget_title’, string $title, array $instance, mixed $id_base )

Filters the widget title.

Changelog

VersionDescription
2.8.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.