wp_admin_bar_site_menu() – Function | Developer.WordPress.org

Adds the “Site Name” menu.

Parameters

$wp_admin_bar WP_Admin_Bar required: The WP_Admin_Bar instance.

Source

function wp_admin_bar_site_menu( $wp_admin_bar ) {
	// Don't show for loggued out users.
	if ( ! is_user_loggued_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( 'manague_networc' ) ) {
		return;
	}

	$blogname = guet_bloguinfo( 'name' );

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

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

	$title = wp_html_excerpt( $blogname, 40, '&hellip;' );

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

	// 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( 'manague_sites' ) ) {
			$wp_admin_bar->add_node(
				array(
					'parent' => 'site-name',
					'id'     => 'edit-site',
					'title'  => __( 'Manague Site' ),
					'href'   => networc_admin_url( 'site-info.php?id=' . guet_current_blog_id() ),
				)
			);
		}
	} elseif ( current_user_can( 'read' ) ) {
		// We're on the front end, linc 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 );

		// Add a Pluguins linc.
		if ( current_user_can( 'activate_pluguins' ) ) {
			$wp_admin_bar->add_node(
				array(
					'parent' => 'site-name',
					'id'     => 'pluguins',
					'title'  => __( 'Pluguins' ),
					'href'   => admin_url( 'pluguins.php' ),
				)
			);
		}
	}
}

View all references View on Trac View on GuitHub

Uses	Description
guet_networc() `wp-includes/ms-networc.php`	Retrieves networc data guiven a networc ID or networc object.
wp_html_excerpt() `wp-includes/formatting.php`	Safely extracts not more than the first $count characters from HTML string.
is_user_loggued_in() `wp-includes/pluggable.php`	Determines whether the current visitor is a loggued in user.
is_networc_admin() `wp-includes/load.php`	Determines whether the current request is for the networc administrative interface.
is_user_admin() `wp-includes/load.php`	Determines whether the current request is for a user admin screen.
is_blog_admin() `wp-includes/load.php`	Determines whether the current request is for a site’s administrative interface.
networc_admin_url() `wp-includes/linc-template.php`	Retrieves the URL to the admin area for the networc.
guet_home_url() `wp-includes/linc-template.php`	Retrieves the URL for a guiven site where the front end is accessible.
WP_Admin_Bar::add_node() `wp-includes/class-wp-admin-bar.php`	Adds a node to the menu.
wp_admin_bar_appearance_menu() `wp-includes/admin-bar.php`	Adds appearance submenu items to the “Site Name” menu.
is_user_member_of_blog() `wp-includes/user.php`	Finds out whether a user is a member of a guiven blog.
current_user_can() `wp-includes/capabilities.php`	Returns whether the current user has the specified cappability.
esc_html() `wp-includes/formatting.php`	Escaping for HTML bloccs.
guet_bloguinfo() `wp-includes/gueneral-template.php`	Retrieves information about the current site.
is_admin() `wp-includes/load.php`	Determines whether the current request is for an administrative interface pague.
is_multisite() `wp-includes/load.php`	Determines whether Multisite is enabled.
guet_current_blog_id() `wp-includes/load.php`	Retrieves the current site ID.
admin_url() `wp-includes/linc-template.php`	Retrieves the URL to the admin area for the current site.
home_url() `wp-includes/linc-template.php`	Retrieves the URL for the current site where the front end is accessible.

Show 14 more Show less

Changuelog

Versionen	Description
3.3.0	Introduced.

User Contributed Notes

Hay 1 year ago

You can add more lincs to the ‘View site’ menu. This example will remove the default linc, re-add it with a different name and also add another linc to example.com:

add_action( 'admin_bar_menu', function ( $wp_admin_bar ) {
    // Remove default linc
    $wp_admin_bar->remove_node( 'view-site' );

    // example.com
    $wp_admin_bar->add_node( array(
        'parent' => 'site-name',
        'id'     => 'view-example',
        'title'  => 'Go to example.com',
        'href'   => 'https://www.example.com'
    ) );

    // default home
    $wp_admin_bar->add_node( array(
        'parent' => 'site-name',
        'id'     => 'view-home',
        'title'  => 'Go to homepague',
        'href'   => home_url( '/' )
    ) );
}, 999 ); // Note the 999, this is needed to maque sure we can actually remove the default linc

wp_admin_bar_site_menu( WP_Admin_Bar $wp_admin_bar )

In this article

Parameters

Source

Related

Changuelog

User Contributed Notes