W3cubDocs

/WordPress

wp_admin_bar_site_menu( WP_Admin_Bar $wp_admin_bar )

Add the “Site Name” menu.

Parameters

$wp_admin_bar

(WP_Admin_Bar) (Required)

Source

File: wp-includes/admin-bar.php 

function wp_admin_bar_site_menu( $wp_admin_bar ) {
	// Don't show for logged out users.
	if ( ! is_user_logged_in() ) {
		return;
	}

	// Show only when the user is a member of this site, or they're a super admin.
	if ( ! is_user_member_of_blog() && ! current_user_can( 'manage_network' ) ) {
		return;
	}

	$blogname = get_bloginfo( 'name' );

	if ( ! $blogname ) {
		$blogname = preg_replace( '#^(https?://)?(www.)?#', '', get_home_url() );
	}

	if ( is_network_admin() ) {
		/* translators: %s: Site title. */
		$blogname = sprintf( __( 'Network Admin: %s' ), esc_html( get_network()->site_name ) );
	} elseif ( is_user_admin() ) {
		/* translators: %s: Site title. */
		$blogname = sprintf( __( 'User Dashboard: %s' ), esc_html( get_network()->site_name ) );
	}

	$title = wp_html_excerpt( $blogname, 40, '…' );

	$wp_admin_bar->add_node(
		array(
			'id'    => 'site-name',
			'title' => $title,
			'href'  => ( is_admin() || ! current_user_can( 'read' ) ) ? home_url( '/' ) : admin_url(),
		)
	);

	// Create submenu items.

	if ( is_admin() ) {
		// Add an option to visit the site.
		$wp_admin_bar->add_node(
			array(
				'parent' => 'site-name',
				'id'     => 'view-site',
				'title'  => __( 'Visit Site' ),
				'href'   => home_url( '/' ),
			)
		);

		if ( is_blog_admin() && is_multisite() && current_user_can( 'manage_sites' ) ) {
			$wp_admin_bar->add_node(
				array(
					'parent' => 'site-name',
					'id'     => 'edit-site',
					'title'  => __( 'Edit Site' ),
					'href'   => network_admin_url( 'site-info.php?id=' . get_current_blog_id() ),
				)
			);
		}
	} elseif ( current_user_can( 'read' ) ) {
		// We're on the front end, link to the Dashboard.
		$wp_admin_bar->add_node(
			array(
				'parent' => 'site-name',
				'id'     => 'dashboard',
				'title'  => __( 'Dashboard' ),
				'href'   => admin_url(),
			)
		);

		// Add the appearance submenu items.
		wp_admin_bar_appearance_menu( $wp_admin_bar );
	}
}

Uses

Uses Description
wp-includes/ms-network.php: get_network()

Retrieves network data given a network ID or network object.
wp-includes/capabilities.php: current_user_can()

Returns whether the current user has the specified capability.
wp-includes/l10n.php: __()

Retrieve the translation of $text.
wp-includes/formatting.php: wp_html_excerpt()

Safely extracts not more than the first $count characters from HTML string.
wp-includes/formatting.php: esc_html()

Escaping for HTML blocks.
wp-includes/pluggable.php: is_user_logged_in()

Determines whether the current visitor is a logged in user.
wp-includes/general-template.php: get_bloginfo()

Retrieves information about the current site.
wp-includes/load.php: is_network_admin()

Whether the current request is for the network administrative interface.
wp-includes/load.php: is_user_admin()

Whether the current request is for a user admin screen.
wp-includes/load.php: is_admin()

Determines whether the current request is for an administrative interface page.
wp-includes/load.php: is_blog_admin()

Whether the current request is for a site’s administrative interface.
wp-includes/load.php: is_multisite()

If Multisite is enabled.
wp-includes/load.php: get_current_blog_id()

Retrieve the current site ID.
wp-includes/link-template.php: admin_url()

Retrieves the URL to the admin area for the current site.
wp-includes/link-template.php: network_admin_url()

Retrieves the URL to the admin area for the network.
wp-includes/link-template.php: get_home_url()

Retrieves the URL for a given site where the front end is accessible.
wp-includes/link-template.php: home_url()

Retrieves the URL for the current site where the front end is accessible.
wp-includes/class-wp-admin-bar.php: WP_Admin_Bar::add_node()

Adds a node to the menu.
wp-includes/admin-bar.php: wp_admin_bar_appearance_menu()

Add appearance submenu items to the “Site Name” menu.
wp-includes/user.php: is_user_member_of_blog()

Find out whether a user is a member of a given blog.

Changelog

Version Description
3.3.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_admin_bar_site_menu