jetpack-mu-wpcom: Add new WordPRess.com site menu (#35702)

* Add the WordPress.com wp-admin sidebar menu link

This commit adds a link to wordpress.com/home/:site when the nav
redesign is enabled.

* changelog

* Version update

Author: lsl

projects/packages/jetpack-mu-wpcom/changelog/add-wpcom-site-menu

@@ -0,0 +1,4 @@
+Significance: patch
+Type: added
+
+jetpack-mu-wpcom: Added the wpcom-site-menu feature to add a WordPress.com sidebar menu item.

projects/packages/jetpack-mu-wpcom/package.json

@@ -1,7 +1,7 @@
 {
 	"private": true,
 	"name": "@automattic/jetpack-mu-wpcom",
-	"version": "5.12.2",
+	"version": "5.12.3-alpha",
 	"description": "Enhances your site with features powered by WordPress.com",
 	"homepage": "https://github.com/Automattic/jetpack/tree/HEAD/projects/packages/jetpack-mu-wpcom/#readme",
 	"bugs": {

projects/packages/jetpack-mu-wpcom/src/class-jetpack-mu-wpcom.php

@@ -13,7 +13,7 @@
  * Jetpack_Mu_Wpcom main class.
  */
 class Jetpack_Mu_Wpcom {
-	const PACKAGE_VERSION = '5.12.2';
+	const PACKAGE_VERSION = '5.12.3-alpha';
 	const PKG_DIR         = __DIR__ . '/../';
 	const BASE_DIR        = __DIR__ . '/';
 	const BASE_FILE       = __FILE__;
@@ -76,6 +76,8 @@ public static function load_features() {
 		require_once __DIR__ . '/features/media/heif-support.php';
 
 		require_once __DIR__ . '/features/block-patterns/block-patterns.php';
+
+		require_once __DIR__ . '/features/wpcom-site-menu/wpcom-site-menu.php';
 	}
 
 	/**

projects/packages/jetpack-mu-wpcom/src/features/wpcom-site-menu/wpcom-site-menu.php

@@ -0,0 +1,45 @@
+<?php
+/**
+ * WordPress.com Site Menu
+ *
+ * Add's a WordPress.com menu item to the admin menu linking back to the sites WordPress.com home page.
+ *
+ * @package automattic/jetpack-mu-wpcom
+ */
+
+/**
+ * Add a WordPress.com menu item to the wp-admin sidebar menu.
+ */
+function wpcom_add_wpcom_menu_item() {
+	if ( function_exists( 'wpcom_is_nav_redesign_enabled' ) && wpcom_is_nav_redesign_enabled() ) {
+		$domain = wp_parse_url( home_url(), PHP_URL_HOST );
+		add_menu_page(
+			esc_attr__( 'WordPress.com', 'jetpack-mu-wpcom' ),
+			esc_attr__( 'WordPress.com', 'jetpack-mu-wpcom' ),
+			'manage_options',
+			"https://wordpress.com/home/$domain",
+			null,
+			'dashicons-arrow-left-alt2',
+			0
+		);
+
+		// Position a separator below the WordPress.com menu item.
+		// Inspired by https://github.com/Automattic/jetpack/blob/b6b6e86c5491869782857141ca48168dfa195635/projects/plugins/jetpack/modules/masterbar/admin-menu/class-base-admin-menu.php#L239
+		global $menu;
+		$separator = array(
+			'',                                  // Menu title (ignored).
+			'manage_options',                    // Required capability.
+			wp_unique_id( 'separator-custom-' ), // URL or file (ignored, but must be unique).
+			'',                                  // Page title (ignored).
+			'wp-menu-separator',                 // CSS class. Identifies this item as a separator.
+		);
+		$position  = 0;
+		if ( isset( $menu[ "$position" ] ) ) {
+			$position            = $position + substr( base_convert( md5( $separator[2] . $separator[0] ), 16, 10 ), -5 ) * 0.00001;
+			$menu[ "$position" ] = $separator; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
+		} else {
+			$menu[ "$position" ] = $separator; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
+		}
+	}
+}
+add_action( 'admin_menu', 'wpcom_add_wpcom_menu_item' );