add_my_home_menu(); // Not needed outside of wp-admin. if ( ! $this->is_api_request ) { $this->add_browse_sites_link(); $this->add_site_card_menu(); $this->add_new_site_link(); } ksort( $GLOBALS['menu'] ); } /** * Forces Posts menu to WPAdmin for Atomic sites only. * Overloads `add_posts_menu` in parent class. * * @param bool $wp_admin Optional. Whether links should point to Calypso or wp-admin. Default false (Calypso). */ public function add_posts_menu( $wp_admin = false ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable return false; // return explicit `false` to force WPAdmin links. } /** * Forces Pages menu to WPAdmin for Atomic sites only. * Overloads `add_page_menu` in parent class. * * @param bool $wp_admin Optional. Whether links should point to Calypso or wp-admin. Default false (Calypso). */ public function add_page_menu( $wp_admin = false ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable return false; // return explicit `false` to force WPAdmin links. } /** * Adds Plugins menu. * * @param bool $wp_admin Optional. Whether links should point to Calypso or wp-admin. Default false (Calypso). */ public function add_plugins_menu( $wp_admin = false ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable // Plugins on Atomic sites are always managed on WP Admin. parent::add_plugins_menu( true ); } /** * Adds the site switcher link if user has more than one site. */ public function add_browse_sites_link() { $site_count = get_user_option( 'wpcom_site_count' ); if ( ! $site_count || $site_count < 2 ) { return; } // Add the menu item. add_menu_page( __( 'site-switcher', 'jetpack' ), __( 'Browse sites', 'jetpack' ), 'read', 'https://wordpress.com/home', null, 'dashicons-arrow-left-alt2', 0 ); add_filter( 'add_menu_classes', array( $this, 'set_browse_sites_link_class' ) ); } /** * Adds a custom element class for Site Switcher menu item. * * @param array $menu Associative array of administration menu items. * * @return array */ public function set_browse_sites_link_class( array $menu ) { foreach ( $menu as $key => $menu_item ) { if ( 'site-switcher' !== $menu_item[3] ) { continue; } $menu[ $key ][4] = add_cssclass( 'site-switcher', $menu_item[4] ); break; } return $menu; } /** * Adds a link to the menu to create a new site. */ public function add_new_site_link() { $site_count = get_user_option( 'wpcom_site_count' ); if ( $site_count && $site_count > 1 ) { return; } $this->add_admin_menu_separator(); add_menu_page( __( 'Add new site', 'jetpack' ), __( 'Add new site', 'jetpack' ), 'read', 'https://wordpress.com/start?ref=calypso-sidebar', null, 'dashicons-plus-alt' ); } /** * Adds site card component. */ public function add_site_card_menu() { $default = 'data:image/svg+xml,' . rawurlencode( 'Globe' ); $icon = get_site_icon_url( 32, $default ); $blog_name = get_option( 'blogname' ) !== '' ? get_option( 'blogname' ) : $this->domain; $badge = ''; if ( function_exists( 'site_is_private' ) && site_is_private() ) { $badge .= sprintf( '%s', site_is_coming_soon() ? esc_html__( 'Coming Soon', 'jetpack' ) : esc_html__( 'Private', 'jetpack' ) ); } $site_card = '
%1$s
%2$s
%3$s
'; $site_card = sprintf( $site_card, $blog_name, $this->domain, $badge ); add_menu_page( 'site-card', $site_card, 'read', get_home_url(), null, $icon, 1 ); add_filter( 'add_menu_classes', array( $this, 'set_site_card_menu_class' ) ); } /** * Adds a custom element class and id for Site Card's menu item. * * @param array $menu Associative array of administration menu items. * * @return array */ public function set_site_card_menu_class( array $menu ) { foreach ( $menu as $key => $menu_item ) { if ( 'site-card' !== $menu_item[3] ) { continue; } $classes = ' toplevel_page_site-card'; // webclip.png is the default on WoA sites. Anything other than that means we have a custom site icon. if ( has_site_icon() && 'https://s0.wp.com/i/webclip.png' !== get_site_icon_url( 512 ) ) { $classes .= ' has-site-icon'; } $menu[ $key ][4] = $menu_item[4] . $classes; $menu[ $key ][5] = 'toplevel_page_site_card'; break; } return $menu; } /** * Adds Upgrades menu. */ public function add_upgrades_menu() { parent::add_upgrades_menu(); add_submenu_page( 'paid-upgrades.php', __( 'Domains', 'jetpack' ), __( 'Domains', 'jetpack' ), 'manage_options', 'https://wordpress.com/domains/manage/' . $this->domain, null, 10 ); } /** * Adds Tools menu. * * @param bool $wp_admin_import Optional. Whether Import link should point to Calypso or wp-admin. Default false (Calypso). * @param bool $wp_admin_export Optional. Whether Export link should point to Calypso or wp-admin. Default false (Calypso). */ public function add_tools_menu( $wp_admin_import = false, $wp_admin_export = false ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable // Export on Atomic sites is always handled on WP Admin. parent::add_tools_menu( $wp_admin_import, true ); } /** * Adds Settings menu. * * @param bool $wp_admin Optional. Whether links should point to Calypso or wp-admin. Default false (Calypso). */ public function add_options_menu( $wp_admin = false ) { parent::add_options_menu( $wp_admin ); add_submenu_page( 'options-general.php', esc_attr__( 'Hosting Configuration', 'jetpack' ), __( 'Hosting Configuration', 'jetpack' ), 'manage_options', 'https://wordpress.com/hosting-config/' . $this->domain, null, 6 ); // No need to add a menu linking to WP Admin if there is already one. if ( ! $wp_admin ) { add_submenu_page( 'options-general.php', esc_attr__( 'Advanced General', 'jetpack' ), __( 'Advanced General', 'jetpack' ), 'manage_options', 'options-general.php' ); add_submenu_page( 'options-general.php', esc_attr__( 'Advanced Writing', 'jetpack' ), __( 'Advanced Writing', 'jetpack' ), 'manage_options', 'options-writing.php' ); } } /** * Adds Appearance menu. * * @param bool $wp_admin_themes Optional. Whether Themes link should point to Calypso or wp-admin. Default false (Calypso). * @param bool $wp_admin_customize Optional. Whether Customize link should point to Calypso or wp-admin. Default false (Calypso). */ public function add_appearance_menu( $wp_admin_themes = false, $wp_admin_customize = false ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable // Customize on Atomic sites is always done on WP Admin. parent::add_appearance_menu( $wp_admin_themes, true ); add_submenu_page( 'themes.php', esc_attr__( 'Add New Theme', 'jetpack' ), __( 'Add New Theme', 'jetpack' ), 'install_themes', 'theme-install.php', null, 1 ); } /** * Adds Users menu. * * @param bool $wp_admin Optional. Whether links should point to Calypso or wp-admin. Default false (Calypso). */ public function add_users_menu( $wp_admin = false ) { parent::add_users_menu( $wp_admin ); add_submenu_page( 'users.php', esc_attr__( 'Advanced Users Management', 'jetpack' ), __( 'Advanced Users Management', 'jetpack' ), 'list_users', 'users.php', null, 2 ); } /** * Also remove the Gutenberg plugin menu. * * @param bool $wp_admin Optional. Whether links should point to Calypso or wp-admin. Default false (Calypso). */ public function add_gutenberg_menus( $wp_admin = false ) { // Always remove the Gutenberg menu. remove_menu_page( 'gutenberg' ); parent::add_gutenberg_menus( $wp_admin ); } }