wp_admin_bar_my_sites_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_my_sites_menu() runs, in this order:

1. 1
   apply_filters( wp_admin_bar_show_site_icons )filterline 698 (+128 into the body)

   Filters whether to show the site icons in toolbar.

Uses · 17

• is_user_logged_in()Determines whether the current visitor is a logged in user.
• is_multisite()Determines whether Multisite is enabled.
• current_user_can()Returns whether the current user has the specified capability.
• get_admin_url()Retrieves the URL to the admin area for a given site.
• admin_url()Retrieves the URL to the admin area for the current site.
• __()Retrieves the translation of $text.
• network_admin_url()Retrieves the URL to the admin area for the network.
• apply_filters()Calls the callback functions that have been added to a filter hook.
• switch_to_blog()Switches the current blog.
• has_site_icon()Determines whether the site has a Site Icon.
• esc_url()Checks and cleans a URL.
• get_site_icon_url()Returns the Site Icon URL.

Source

View on Trac ↗View on GitHub ↗

570function wp_admin_bar_my_sites_menu( $wp_admin_bar ) {571	// Don't show for logged out users or single site mode.572	if ( ! is_user_logged_in() || ! is_multisite() ) {573		return;574	}575 576	// Show only when the user has at least one site, or they're a super admin.577	if ( count( $wp_admin_bar->user->blogs ) < 1 && ! current_user_can( 'manage_network' ) ) {578		return;579	}580 581	if ( $wp_admin_bar->user->active_blog ) {582		$my_sites_url = get_admin_url( $wp_admin_bar->user->active_blog->blog_id, 'my-sites.php' );583	} else {584		$my_sites_url = admin_url( 'my-sites.php' );585	}586 587	$wp_admin_bar->add_node(588		array(589			'id'    => 'my-sites',590			'title' => __( 'My Sites' ),591			'href'  => $my_sites_url,592		)593	);594 595	if ( current_user_can( 'manage_network' ) ) {596		$wp_admin_bar->add_group(597			array(598				'parent' => 'my-sites',599				'id'     => 'my-sites-super-admin',600			)601		);602 603		$wp_admin_bar->add_node(604			array(605				'parent' => 'my-sites-super-admin',606				'id'     => 'network-admin',607				'title'  => __( 'Network Admin' ),608				'href'   => network_admin_url(),609			)610		);611 612		$wp_admin_bar->add_node(613			array(614				'parent' => 'network-admin',615				'id'     => 'network-admin-d',616				'title'  => __( 'Dashboard' ),617				'href'   => network_admin_url(),618			)619		);620 621		if ( current_user_can( 'manage_sites' ) ) {622			$wp_admin_bar->add_node(623				array(624					'parent' => 'network-admin',625					'id'     => 'network-admin-s',626					'title'  => __( 'Sites' ),627					'href'   => network_admin_url( 'sites.php' ),628				)629			);630		}631 632		if ( current_user_can( 'manage_network_users' ) ) {633			$wp_admin_bar->add_node(634				array(635					'parent' => 'network-admin',636					'id'     => 'network-admin-u',637					'title'  => __( 'Users' ),638					'href'   => network_admin_url( 'users.php' ),639				)640			);641		}642 643		if ( current_user_can( 'manage_network_themes' ) ) {644			$wp_admin_bar->add_node(645				array(646					'parent' => 'network-admin',647					'id'     => 'network-admin-t',648					'title'  => __( 'Themes' ),649					'href'   => network_admin_url( 'themes.php' ),

History

Introduced in 3.1.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.