wp_admin_bar_site_menu( WP_Admin_Bar $wp_admin_bar )

Parameters

$wp_admin_barWP_Admin_Bar

The WP_Admin_Bar instance.

Hooks fired · 1

One hook fires while wp_admin_bar_site_menu() runs, in this order:

1. 1
   apply_filters( wp_admin_bar_show_site_icons )filterline 394 (+32 into the body)

   Filters whether to show the site icons in toolbar.

Uses · 23

• is_user_logged_in()Determines whether the current visitor is a logged in user.
• is_user_member_of_blog()Finds out whether a user is a member of a given blog.
• current_user_can()Returns whether the current user has the specified capability.
• get_bloginfo()Retrieves information about the current site.
• get_home_url()Retrieves the URL for a given site where the front end is accessible.
• is_network_admin()Determines whether the current request is for the network administrative interface.
• __()Retrieves the translation of $text.
• esc_html()Escaping for HTML blocks.
• get_network()Retrieves network data given a network ID or network object.
• is_user_admin()Determines whether the current request is for a user admin screen.
• wp_html_excerpt()Safely extracts not more than the first $count characters from HTML string.
• apply_filters()Calls the callback functions that have been added to a filter hook.

Source

View on Trac ↗View on GitHub ↗

362function wp_admin_bar_site_menu( $wp_admin_bar ) {363	// Don't show for logged out users.364	if ( ! is_user_logged_in() ) {365		return;366	}367 368	// Show only when the user is a member of this site, or they're a super admin.369	if ( ! is_user_member_of_blog() && ! current_user_can( 'manage_network' ) ) {370		return;371	}372 373	$blogname = get_bloginfo( 'name' );374 375	if ( ! $blogname ) {376		$blogname = preg_replace( '#^(https?://)?(www\.)?#', '', get_home_url() );377	}378 379	if ( is_network_admin() ) {380		/* translators: %s: Site title. */381		$blogname = sprintf( __( 'Network Admin: %s' ), esc_html( get_network()->site_name ) );382	} elseif ( is_user_admin() ) {383		/* translators: %s: Site title. */384		$blogname = sprintf( __( 'User Dashboard: %s' ), esc_html( get_network()->site_name ) );385	}386 387	$title = wp_html_excerpt( $blogname, 40, '&hellip;' );388	$meta  = array(389		'menu_title' => $title,390	);391 392	if ( ! is_network_admin() && ! is_user_admin() ) {393		/** This filter is documented in wp-includes/admin-bar.php */394		$show_site_icons = apply_filters( 'wp_admin_bar_show_site_icons', true );395 396		if ( true === $show_site_icons && has_site_icon() ) {397			$site_icon_url    = get_site_icon_url( 32 );398			$site_icon_url_2x = get_site_icon_url( 64 );399			$srcset           = ( $site_icon_url_2x && $site_icon_url !== $site_icon_url_2x ) ? sprintf( ' srcset="%s 2x"', esc_url( $site_icon_url_2x ) ) : '';400			$site_icon        = sprintf(401				'<img class="site-icon" src="%s"%s alt="" width="20" height="20" />',402				esc_url( $site_icon_url ),403				$srcset404			);405 406			$title         = $site_icon . $title;407			$meta['class'] = 'has-site-icon';408		}409	}410 411	$wp_admin_bar->add_node(412		array(413			'id'    => 'site-name',414			'title' => $title,415			'href'  => ( is_admin() || ! current_user_can( 'read' ) ) ? home_url( '/' ) : admin_url(),416			'meta'  => $meta,417		)418	);419 420	// Create submenu items.421 422	if ( is_admin() ) {423		// Add an option to visit the site.424		$wp_admin_bar->add_node(425			array(426				'parent' => 'site-name',427				'id'     => 'view-site',428				'title'  => __( 'Visit Site' ),429				'href'   => home_url( '/' ),430			)431		);432 433		if ( is_blog_admin() && is_multisite() && current_user_can( 'manage_sites' ) ) {434			$wp_admin_bar->add_node(435				array(436					'parent' => 'site-name',437					'id'     => 'edit-site',438					'title'  => __( 'Manage Site' ),439					'href'   => network_admin_url( 'site-info.php?id=' . get_current_blog_id() ),440				)441			);

History

Introduced in 3.3.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/admin-bar.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.