Jetpack_Admin_Menu::add_users_menu() - Code Metrics - Inspection of "Merge branch 'master' into kraftbj-patch-2" - Automattic/jetpack - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — kraftbj-patch-2 ( f1a4bb...ba1272 )

unknown

created 2021-03-01 20:05 UTC

Jetpack_Admin_Menu::add_users_menu() A

↳ Parent: Jetpack_Admin_Menu

Complexity

Conditions	1
Paths	1

Size

Total Lines

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
cc	1
nc	1
nop	1
dl	0
loc	6
rs	10
c	0
b	0
f	0

<?php
/**
 * Jetpack Admin Menu file.
 *
 * @package Jetpack
 */

namespace Automattic\Jetpack\Dashboard_Customizations;

require_once __DIR__ . '/class-admin-menu.php';

/**
 * Class Jetpack_Admin_Menu.
 */
class Jetpack_Admin_Menu extends Admin_Menu {

	/**
	 * Create the desired menu output.
	 */
	public function reregister_menu_items() {
		global $menu, $submenu;

		if ( $this->is_api_request || ( defined( 'REST_REQUEST' ) && REST_REQUEST ) ) {
			// Reset menus for API requests (i.e. Calypso) so there are no third-party plugin items.
			$menu    = array(); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
			$submenu = array(); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
		}

		parent::reregister_menu_items();

		$this->add_feedback_menu();
		$this->add_wp_admin_menu();

		ksort( $GLOBALS['menu'] );
	}

	/**
	 * Adds Jetpack menu.
	 */
	public function add_jetpack_menu() {
		parent::add_jetpack_menu();

		$parent_slug = 'https://wordpress.com/activity-log/' . $this->domain;

		// Place "Scan" submenu after Backup.
		$position = 0;
		global $submenu;
		foreach ( $submenu[ $parent_slug ] as $submenu_item ) {
			$position++;
			if ( __( 'Backup', 'jetpack' ) === $submenu_item[3] ) {
				break;
			}
		}
		add_submenu_page( $parent_slug, esc_attr__( 'Scan', 'jetpack' ), __( 'Scan', 'jetpack' ), 'manage_options', 'https://wordpress.com/scan/' . $this->domain, null, $position );
	}

	/**
	 * 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
		$admin_slug = 'tools.php';
		$menu_slug  = 'https://wordpress.com/marketing/tools/' . $this->domain;

		remove_menu_page( $admin_slug );
		$this->remove_submenus( $admin_slug );

		add_menu_page( esc_attr__( 'Tools', 'jetpack' ), __( 'Tools', 'jetpack' ), 'publish_posts', $menu_slug, null, 'dashicons-admin-tools', 75 );
		add_submenu_page( $menu_slug, esc_attr__( 'Marketing', 'jetpack' ), __( 'Marketing', 'jetpack' ), 'publish_posts', $menu_slug );
		add_submenu_page( $menu_slug, esc_attr__( 'Earn', 'jetpack' ), __( 'Earn', 'jetpack' ), 'manage_options', 'https://wordpress.com/earn/' . $this->domain );

		// Import/Export on Jetpack sites is always handled on WP Admin.
		add_submenu_page( $menu_slug, esc_attr__( 'Import', 'jetpack' ), __( 'Import', 'jetpack' ), 'import', 'import.php' );
		add_submenu_page( $menu_slug, esc_attr__( 'Export', 'jetpack' ), __( 'Export', 'jetpack' ), 'export', 'export.php' );

	}

	/**
	 * Adds WP Admin menu.
	 */
	public function add_wp_admin_menu() {
		global $menu;
		$menu_slug = 'index.php';

		remove_menu_page( $menu_slug );
		$this->remove_submenus( $menu_slug );

		// Attempt to get last position.
		ksort( $menu );
		end( $menu );
		$position = key( $menu );

		$this->add_admin_menu_separator( ++$position );

		add_menu_page( __( 'WP Admin', 'jetpack' ), __( 'WP Admin', 'jetpack' ), 'read', $menu_slug, null, 'dashicons-wordpress-alt', $position );
	}

	/**
	 * 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
		$appearance_cap = current_user_can( 'switch_themes' ) ? 'switch_themes' : 'edit_theme_options';
		$admin_slug     = 'themes.php';
		$menu_slug      = 'https://wordpress.com/themes/' . $this->domain;

		// Remove all submenus except Themes and Customize to mimic the old Calypso navigation.
		remove_menu_page( $admin_slug );
		$this->remove_submenus( $admin_slug );
		add_menu_page( esc_attr__( 'Appearance', 'jetpack' ), __( 'Appearance', 'jetpack' ), $appearance_cap, $menu_slug, null, 'dashicons-admin-appearance', 60 );
		add_submenu_page( $menu_slug, esc_attr__( 'Themes', 'jetpack' ), __( 'Themes', 'jetpack' ), 'switch_themes', $menu_slug );

		// Customize on Jetpack sites is always done on WP Admin (unsupported by Calypso).
		add_submenu_page( $menu_slug, esc_attr__( 'Customize', 'jetpack' ), __( 'Customize', 'jetpack' ), 'customize', 'customize.php' );
	}

	/**
	 * Adds Posts menu.
	 *
	 * @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
		parent::add_posts_menu();

		// Remove all submenus to mimic the old Calypso navigation.
		$this->remove_submenus( 'https://wordpress.com/posts/' . $this->domain );
	}

	/**
	 * Adds Page menu.
	 *
	 * @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
		parent::add_page_menu();

		// Remove all submenus to mimic the old Calypso navigation.
		$this->remove_submenus( 'https://wordpress.com/pages/' . $this->domain );
	}

	/**
	 * Adds a custom post type menu.
	 *
	 * @param string $post_type Custom post type.
	 * @param bool   $wp_admin  Optional. Whether links should point to Calypso or wp-admin. Default false (Calypso).
	 */
	public function add_custom_post_type_menu( $post_type, $wp_admin = false ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
		parent::add_custom_post_type_menu( $post_type );

		// Remove all submenus to mimic the old Calypso navigation.
		$this->remove_submenus( 'https://wordpress.com/types/' . $post_type . '/' . $this->domain );
	}

	/**
	 * 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 ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
		parent::add_users_menu();

		// Remove all submenus to mimic the old Calypso navigation.
		$this->remove_submenus( 'https://wordpress.com/people/team/' . $this->domain );
	}

	/**
	 * Adds Feedback menu.
	 */
	public function add_feedback_menu() {
		$post_type = 'feedback';

		$ptype_obj = get_post_type_object( $post_type );
		if ( empty( $ptype_obj ) ) {
			return;
		}

		$slug       = 'edit.php?post_type=' . $post_type;
		$name       = $ptype_obj->labels->menu_name;
		$capability = $ptype_obj->cap->edit_posts;
		$icon       = $ptype_obj->menu_icon;
		$position   = 45; // Before Jetpack.

		add_menu_page( esc_attr( $name ), $name, $capability, $slug, null, $icon, $position );
	}

	/**
	 * Whether to use wp-admin pages rather than Calypso.
	 *
	 * @return bool
	 */
	public function should_link_to_wp_admin() {
		// Force Calypso links on Jetpack sites since Nav Unification is disabled on WP Admin.
		return false;
	}

	/**
	 * Migrates submenu items from wp-admin menu slugs to Calypso menu slugs.
	 *
	 * @param string $old_slug WP-Admin menu slug.
	 * @param string $new_slug Calypso menu slug. (Calypso URL).
	 */
	public function migrate_submenus( $old_slug, $new_slug ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
		// Do not migrate menu on Jetpack sites, since we don't want WP Admin links.
		// Instead we remove the submenu since they won't be used.
		$this->remove_submenus( $old_slug );
	}

	/**
	 * 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 Jetpack sites are always managed on Calypso.
		parent::add_plugins_menu( false );
	}
}


1			<?php
2			/**
3			* Jetpack Admin Menu file.
4			*
5			* @package Jetpack
6			*/
7
8			namespace Automattic\Jetpack\Dashboard_Customizations;
9
10			require_once __DIR__ . '/class-admin-menu.php';
11
12			/**
13			* Class Jetpack_Admin_Menu.
14			*/
15			class Jetpack_Admin_Menu extends Admin_Menu {
16
17			/**
18			* Create the desired menu output.
19			*/
20			public function reregister_menu_items() {
21			global $menu, $submenu;
22
23			if ( $this->is_api_request \|\| ( defined( 'REST_REQUEST' ) && REST_REQUEST ) ) {
24			// Reset menus for API requests (i.e. Calypso) so there are no third-party plugin items.
25			$menu = array(); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
26			$submenu = array(); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
27			}
28
29			parent::reregister_menu_items();
30
31			$this->add_feedback_menu();
32			$this->add_wp_admin_menu();
33
34			ksort( $GLOBALS['menu'] );
35			}
36
37			/**
38			* Adds Jetpack menu.
39			*/
40			public function add_jetpack_menu() {
41			parent::add_jetpack_menu();
42
43			$parent_slug = 'https://wordpress.com/activity-log/' . $this->domain;
44
45			// Place "Scan" submenu after Backup.
46			$position = 0;
47			global $submenu;
48			foreach ( $submenu[ $parent_slug ] as $submenu_item ) {
49			$position++;
50			if ( __( 'Backup', 'jetpack' ) === $submenu_item[3] ) {
51			break;
52			}
53			}
54			add_submenu_page( $parent_slug, esc_attr__( 'Scan', 'jetpack' ), __( 'Scan', 'jetpack' ), 'manage_options', 'https://wordpress.com/scan/' . $this->domain, null, $position );
55			}
56
57			/**
58			* Adds Tools menu.
59			*
60			* @param bool $wp_admin_import Optional. Whether Import link should point to Calypso or wp-admin. Default false (Calypso).
61			* @param bool $wp_admin_export Optional. Whether Export link should point to Calypso or wp-admin. Default false (Calypso).
62			*/
63			public function add_tools_menu( $wp_admin_import = false, $wp_admin_export = false ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
64			$admin_slug = 'tools.php';
65			$menu_slug = 'https://wordpress.com/marketing/tools/' . $this->domain;
66
67			remove_menu_page( $admin_slug );
68			$this->remove_submenus( $admin_slug );
69
70			add_menu_page( esc_attr__( 'Tools', 'jetpack' ), __( 'Tools', 'jetpack' ), 'publish_posts', $menu_slug, null, 'dashicons-admin-tools', 75 );
71			add_submenu_page( $menu_slug, esc_attr__( 'Marketing', 'jetpack' ), __( 'Marketing', 'jetpack' ), 'publish_posts', $menu_slug );
72			add_submenu_page( $menu_slug, esc_attr__( 'Earn', 'jetpack' ), __( 'Earn', 'jetpack' ), 'manage_options', 'https://wordpress.com/earn/' . $this->domain );
73
74			// Import/Export on Jetpack sites is always handled on WP Admin.
75			add_submenu_page( $menu_slug, esc_attr__( 'Import', 'jetpack' ), __( 'Import', 'jetpack' ), 'import', 'import.php' );
76			add_submenu_page( $menu_slug, esc_attr__( 'Export', 'jetpack' ), __( 'Export', 'jetpack' ), 'export', 'export.php' );
77
78			}
79
80			/**
81			* Adds WP Admin menu.
82			*/
83			public function add_wp_admin_menu() {
84			global $menu;
85			$menu_slug = 'index.php';
86
87			remove_menu_page( $menu_slug );
88			$this->remove_submenus( $menu_slug );
89
90			// Attempt to get last position.
91			ksort( $menu );
92			end( $menu );
93			$position = key( $menu );
94
95			$this->add_admin_menu_separator( ++$position );
96
97			add_menu_page( __( 'WP Admin', 'jetpack' ), __( 'WP Admin', 'jetpack' ), 'read', $menu_slug, null, 'dashicons-wordpress-alt', $position );
98			}
99
100			/**
101			* Adds Appearance menu.
102			*
103			* @param bool $wp_admin_themes Optional. Whether Themes link should point to Calypso or wp-admin. Default false (Calypso).
104			* @param bool $wp_admin_customize Optional. Whether Customize link should point to Calypso or wp-admin. Default false (Calypso).
105			*/
106			public function add_appearance_menu( $wp_admin_themes = false, $wp_admin_customize = false ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
107			$appearance_cap = current_user_can( 'switch_themes' ) ? 'switch_themes' : 'edit_theme_options';
108			$admin_slug = 'themes.php';
109			$menu_slug = 'https://wordpress.com/themes/' . $this->domain;
110
111			// Remove all submenus except Themes and Customize to mimic the old Calypso navigation.
112			remove_menu_page( $admin_slug );
113			$this->remove_submenus( $admin_slug );
114			add_menu_page( esc_attr__( 'Appearance', 'jetpack' ), __( 'Appearance', 'jetpack' ), $appearance_cap, $menu_slug, null, 'dashicons-admin-appearance', 60 );
115			add_submenu_page( $menu_slug, esc_attr__( 'Themes', 'jetpack' ), __( 'Themes', 'jetpack' ), 'switch_themes', $menu_slug );
116
117			// Customize on Jetpack sites is always done on WP Admin (unsupported by Calypso).
118			add_submenu_page( $menu_slug, esc_attr__( 'Customize', 'jetpack' ), __( 'Customize', 'jetpack' ), 'customize', 'customize.php' );
119			}
120
121			/**
122			* Adds Posts menu.
123			*
124			* @param bool $wp_admin Optional. Whether links should point to Calypso or wp-admin. Default false (Calypso).
125			*/
126			public function add_posts_menu( $wp_admin = false ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
127			parent::add_posts_menu();
128
129			// Remove all submenus to mimic the old Calypso navigation.
130			$this->remove_submenus( 'https://wordpress.com/posts/' . $this->domain );
131			}
132
133			/**
134			* Adds Page menu.
135			*
136			* @param bool $wp_admin Optional. Whether links should point to Calypso or wp-admin. Default false (Calypso).
137			*/
138			public function add_page_menu( $wp_admin = false ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
139			parent::add_page_menu();
140
141			// Remove all submenus to mimic the old Calypso navigation.
142			$this->remove_submenus( 'https://wordpress.com/pages/' . $this->domain );
143			}
144
145			/**
146			* Adds a custom post type menu.
147			*
148			* @param string $post_type Custom post type.
149			* @param bool $wp_admin Optional. Whether links should point to Calypso or wp-admin. Default false (Calypso).
150			*/
151			public function add_custom_post_type_menu( $post_type, $wp_admin = false ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
152			parent::add_custom_post_type_menu( $post_type );
153
154			// Remove all submenus to mimic the old Calypso navigation.
155			$this->remove_submenus( 'https://wordpress.com/types/' . $post_type . '/' . $this->domain );
156			}
157
158			/**
159			* Adds Users menu.
160			*
161			* @param bool $wp_admin Optional. Whether links should point to Calypso or wp-admin. Default false (Calypso).
162			*/
163			public function add_users_menu( $wp_admin = false ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
164			parent::add_users_menu();
165
166			// Remove all submenus to mimic the old Calypso navigation.
167			$this->remove_submenus( 'https://wordpress.com/people/team/' . $this->domain );
168			}
169
170			/**
171			* Adds Feedback menu.
172			*/
173			public function add_feedback_menu() {
174			$post_type = 'feedback';
175
176			$ptype_obj = get_post_type_object( $post_type );
177			if ( empty( $ptype_obj ) ) {
178			return;
179			}
180
181			$slug = 'edit.php?post_type=' . $post_type;
182			$name = $ptype_obj->labels->menu_name;
183			$capability = $ptype_obj->cap->edit_posts;
184			$icon = $ptype_obj->menu_icon;
185			$position = 45; // Before Jetpack.
186
187			add_menu_page( esc_attr( $name ), $name, $capability, $slug, null, $icon, $position );
188			}
189
190			/**
191			* Whether to use wp-admin pages rather than Calypso.
192			*
193			* @return bool
194			*/
195			public function should_link_to_wp_admin() {
196			// Force Calypso links on Jetpack sites since Nav Unification is disabled on WP Admin.
197			return false;
198			}
199
200			/**
201			* Migrates submenu items from wp-admin menu slugs to Calypso menu slugs.
202			*
203			* @param string $old_slug WP-Admin menu slug.
204			* @param string $new_slug Calypso menu slug. (Calypso URL).
205			*/
206			public function migrate_submenus( $old_slug, $new_slug ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
207			// Do not migrate menu on Jetpack sites, since we don't want WP Admin links.
208			// Instead we remove the submenu since they won't be used.
209			$this->remove_submenus( $old_slug );
210			}
211
212			/**
213			* Adds Plugins menu.
214			*
215			* @param bool $wp_admin Optional. Whether links should point to Calypso or wp-admin. Default false (Calypso).
216			*/
217			public function add_plugins_menu( $wp_admin = false ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
218			// Plugins on Jetpack sites are always managed on Calypso.
219			parent::add_plugins_menu( false );
220			}
221			}
222

Automattic / jetpack

Push — kraftbj-patch-2 ( f1a4bb...ba1272 )

Jetpack_Admin_Menu::add_users_menu() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like