File: /home/perditaeyz/www/wp-content/plugins/jetpack/modules/masterbar/admin-menu/class-admin-menu.php
<?php
/**
* Admin Menu file.
*
* @package automattic/jetpack
*/
namespace Automattic\Jetpack\Dashboard_Customizations;
use Automattic\Jetpack\Redirect;
use Automattic\Jetpack\Status;
/**
* Class Admin_Menu.
*/
class Admin_Menu {
/**
* Holds class instances.
*
* @var array
*/
protected static $instances;
/**
* Whether the current request is a REST API request.
*
* @var bool
*/
protected $is_api_request = false;
/**
* Domain of the current site.
*
* @var string
*/
protected $domain;
/**
* Admin_Menu constructor.
*/
protected function __construct() {
add_action( 'admin_menu', array( $this, 'reregister_menu_items' ), 99999 );
add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_scripts' ) );
add_action( 'wp_enqueue_scripts', array( $this, 'dequeue_scripts' ), 20 );
add_action( 'admin_enqueue_scripts', array( $this, 'dequeue_scripts' ), 20 );
add_filter( 'rest_request_before_callbacks', array( $this, 'rest_api_init' ), 11 );
$this->domain = ( new Status() )->get_site_suffix();
}
/**
* Returns class instance.
*
* @return Admin_Menu
*/
public static function get_instance() {
$class = get_called_class();
if ( empty( static::$instances[ $class ] ) ) {
static::$instances[ $class ] = new $class();
}
return static::$instances[ $class ];
}
/**
* Sets up class properties for REST API requests.
*
* @param WP_REST_Response $response Response from the endpoint.
*/
public function rest_api_init( $response ) {
$this->is_api_request = true;
return $response;
}
/**
* Create the desired menu output.
*/
public function reregister_menu_items() {
// Constant is not defined until parse_request.
if ( ! $this->is_api_request ) {
$this->is_api_request = defined( 'REST_REQUEST' ) && REST_REQUEST;
}
/*
* Whether links should point to Calypso or wp-admin.
*
* Options:
* false - Calypso (Default).
* true - wp-admin.
*/
$wp_admin = $this->should_link_to_wp_admin();
// Remove separators.
remove_menu_page( 'separator1' );
$this->add_stats_menu();
$this->add_upgrades_menu();
$this->add_posts_menu( $wp_admin );
$this->add_media_menu( $wp_admin );
$this->add_page_menu( $wp_admin );
$this->add_testimonials_menu( $wp_admin );
$this->add_portfolio_menu( $wp_admin );
$this->add_comments_menu( $wp_admin );
// Whether Themes/Customize links should point to Calypso (false) or wp-admin (true).
$wp_admin_themes = $wp_admin;
$wp_admin_customize = $wp_admin;
$this->add_appearance_menu( $wp_admin_themes, $wp_admin_customize );
$this->add_plugins_menu( $wp_admin );
$this->add_users_menu( $wp_admin );
// Whether Import/Export links should point to Calypso (false) or wp-admin (true).
$wp_admin_import = $wp_admin;
$wp_admin_export = $wp_admin;
$this->add_tools_menu( $wp_admin_import, $wp_admin_export );
$this->add_options_menu( $wp_admin );
$this->add_jetpack_menu();
// Remove Links Manager menu since its usage is discouraged.
// @see https://core.trac.wordpress.org/ticket/21307#comment:73.
remove_menu_page( 'link-manager.php' );
ksort( $GLOBALS['menu'] );
}
/**
* Adds My Home menu.
*/
public function add_my_home_menu() {
$this->update_menu( 'index.php', 'https://wordpress.com/home/' . $this->domain, __( 'My Home', 'jetpack' ), 'manage_options', 'dashicons-admin-home' );
}
/**
* Adds Stats menu.
*/
public function add_stats_menu() {
add_menu_page( __( 'Stats', 'jetpack' ), __( 'Stats', 'jetpack' ), 'view_stats', 'https://wordpress.com/stats/day/' . $this->domain, null, 'dashicons-chart-bar', 3 );
}
/**
* Adds Upgrades menu.
*/
public function add_upgrades_menu() {
global $menu;
$menu_exists = false;
foreach ( $menu as $item ) {
if ( 'paid-upgrades.php' === $item[2] ) {
$menu_exists = true;
break;
}
}
if ( ! $menu_exists ) {
add_menu_page( __( 'Upgrades', 'jetpack' ), __( 'Upgrades', 'jetpack' ), 'manage_options', 'paid-upgrades.php', null, 'dashicons-cart', 4 );
}
add_submenu_page( 'paid-upgrades.php', __( 'Plans', 'jetpack' ), __( 'Plans', 'jetpack' ), 'manage_options', 'https://wordpress.com/plans/' . $this->domain, null, 5 );
add_submenu_page( 'paid-upgrades.php', __( 'Purchases', 'jetpack' ), __( 'Purchases', 'jetpack' ), 'manage_options', 'https://wordpress.com/purchases/subscriptions/' . $this->domain, null, 15 );
if ( ! $menu_exists ) {
// Remove the submenu auto-created by Core.
remove_submenu_page( 'paid-upgrades.php', 'paid-upgrades.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 ) {
if ( $wp_admin ) {
return;
}
$submenus_to_update = array(
'edit.php' => 'https://wordpress.com/posts/' . $this->domain,
'post-new.php' => 'https://wordpress.com/post/' . $this->domain,
);
$this->update_submenus( 'edit.php', $submenus_to_update );
}
/**
* Adds Media menu.
*
* @param bool $wp_admin Optional. Whether links should point to Calypso or wp-admin. Default false (Calypso).
*/
public function add_media_menu( $wp_admin = false ) {
if ( $wp_admin ) {
return;
}
remove_submenu_page( 'upload.php', 'media-new.php' );
$this->update_menu( 'upload.php', 'https://wordpress.com/media/' . $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 ) {
if ( $wp_admin ) {
return;
}
$submenus_to_update = array(
'edit.php?post_type=page' => 'https://wordpress.com/pages/' . $this->domain,
'post-new.php?post_type=page' => 'https://wordpress.com/page/' . $this->domain,
);
$this->update_submenus( 'edit.php?post_type=page', $submenus_to_update );
}
/**
* Adds Testimonials menu.
*
* @param bool $wp_admin Optional. Whether links should point to Calypso or wp-admin. Default false (Calypso).
*/
public function add_testimonials_menu( $wp_admin = false ) {
$this->add_custom_post_type_menu( 'jetpack-testimonial', $wp_admin );
}
/**
* Adds Portfolio menu.
*
* @param bool $wp_admin Optional. Whether links should point to Calypso or wp-admin. Default false (Calypso).
*/
public function add_portfolio_menu( $wp_admin = false ) {
$this->add_custom_post_type_menu( 'jetpack-portfolio', $wp_admin );
}
/**
* 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 ) {
if ( $wp_admin ) {
return;
}
$submenus_to_update = array(
'edit.php?post_type=' . $post_type => 'https://wordpress.com/types/' . $post_type . '/' . $this->domain,
'post-new.php?post_type=' . $post_type => 'https://wordpress.com/edit/' . $post_type . '/' . $this->domain,
);
$this->update_submenus( 'edit.php?post_type=' . $post_type, $submenus_to_update );
}
/**
* Adds Comments menu.
*
* @param bool $wp_admin Optional. Whether links should point to Calypso or wp-admin. Default false (Calypso).
*/
public function add_comments_menu( $wp_admin = false ) {
if ( $wp_admin ) {
return;
}
$this->update_menu( 'edit-comments.php', 'https://wordpress.com/comments/all/' . $this->domain );
}
/**
* 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).
* @return string The Customizer URL.
*/
public function add_appearance_menu( $wp_admin_themes = false, $wp_admin_customize = false ) {
$request_uri = isset( $_SERVER['REQUEST_URI'] ) ? esc_url_raw( wp_unslash( $_SERVER['REQUEST_URI'] ) ) : '';
$default_customize_slug = add_query_arg( 'return', rawurlencode( remove_query_arg( wp_removable_query_args(), $request_uri ) ), 'customize.php' );
$default_customize_header_slug_1 = add_query_arg( array( 'autofocus' => array( 'control' => 'header_image' ) ), $default_customize_slug );
// TODO: Remove WPCom_Theme_Customizer::modify_header_menu_links() and WPcom_Custom_Header::modify_admin_menu_links().
$default_customize_header_slug_2 = admin_url( 'themes.php?page=custom-header' );
$default_customize_background_slug_1 = add_query_arg( array( 'autofocus' => array( 'control' => 'background_image' ) ), $default_customize_slug );
// TODO: Remove Colors_Manager::modify_header_menu_links() and Colors_Manager_Common::modify_header_menu_links().
$default_customize_background_slug_2 = add_query_arg( array( 'autofocus' => array( 'section' => 'colors_manager_tool' ) ), admin_url( 'customize.php' ) );
if ( ! $wp_admin_customize ) {
$customize_url = 'https://wordpress.com/customize/' . $this->domain;
} elseif ( $this->is_api_request ) {
// In case this is an api request we will have to add the 'return' querystring via JS.
$customize_url = 'customize.php';
} else {
$customize_url = $default_customize_slug;
}
$submenus_to_update = array(
$default_customize_slug => $customize_url,
$default_customize_header_slug_1 => add_query_arg( array( 'autofocus' => array( 'control' => 'header_image' ) ), $customize_url ),
$default_customize_header_slug_2 => add_query_arg( array( 'autofocus' => array( 'control' => 'header_image' ) ), $customize_url ),
$default_customize_background_slug_1 => add_query_arg( array( 'autofocus' => array( 'section' => 'colors_manager_tool' ) ), $customize_url ),
$default_customize_background_slug_2 => add_query_arg( array( 'autofocus' => array( 'section' => 'colors_manager_tool' ) ), $customize_url ),
);
if ( ! $wp_admin_themes ) {
$submenus_to_update['themes.php'] = 'https://wordpress.com/themes/' . $this->domain;
}
if ( ! $wp_admin_customize ) {
$submenus_to_update['widgets.php'] = add_query_arg( array( 'autofocus' => array( 'panel' => 'widgets' ) ), $customize_url );
$submenus_to_update['gutenberg-widgets'] = add_query_arg( array( 'autofocus' => array( 'panel' => 'widgets' ) ), $customize_url );
$submenus_to_update['nav-menus.php'] = add_query_arg( array( 'autofocus' => array( 'panel' => 'nav_menus' ) ), $customize_url );
}
$this->update_submenus( 'themes.php', $submenus_to_update );
remove_submenu_page( 'themes.php', 'custom-header' );
remove_submenu_page( 'themes.php', 'custom-background' );
return $customize_url;
}
/**
* 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 ) {
if ( $wp_admin ) {
return;
}
remove_submenu_page( 'plugins.php', 'plugin-install.php' );
remove_submenu_page( 'plugins.php', 'plugin-editor.php' );
$this->update_menu( 'plugins.php', 'https://wordpress.com/plugins/' . $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 ) {
if ( current_user_can( 'list_users' ) ) {
if ( ! $wp_admin ) {
$submenus_to_update = array(
'users.php' => 'https://wordpress.com/people/team/' . $this->domain,
'user-new.php' => 'https://wordpress.com/people/new/' . $this->domain,
'profile.php' => 'https://wordpress.com/me',
);
$this->update_submenus( 'users.php', $submenus_to_update );
}
add_submenu_page( 'users.php', esc_attr__( 'Account Settings', 'jetpack' ), __( 'Account Settings', 'jetpack' ), 'read', 'https://wordpress.com/me/account' );
} else {
if ( ! $wp_admin ) {
$submenus_to_update = array(
'user-new.php' => 'https://wordpress.com/people/new/' . $this->domain,
'profile.php' => 'https://wordpress.com/me',
);
$this->update_submenus( 'profile.php', $submenus_to_update );
}
add_submenu_page( 'profile.php', esc_attr__( 'Account Settings', 'jetpack' ), __( 'Account Settings', 'jetpack' ), 'read', 'https://wordpress.com/me/account' );
}
}
/**
* 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 ) {
$submenus_to_update = array();
if ( ! $wp_admin_import ) {
$submenus_to_update['import.php'] = 'https://wordpress.com/import/' . $this->domain;
}
if ( ! $wp_admin_export ) {
$submenus_to_update['export.php'] = 'https://wordpress.com/export/' . $this->domain;
}
$this->update_submenus( 'tools.php', $submenus_to_update );
remove_submenu_page( 'tools.php', 'tools.php' );
remove_submenu_page( 'tools.php', 'delete-blog' );
add_submenu_page( 'tools.php', esc_attr__( 'Marketing', 'jetpack' ), __( 'Marketing', 'jetpack' ), 'publish_posts', 'https://wordpress.com/marketing/tools/' . $this->domain, null, 0 );
add_submenu_page( 'tools.php', esc_attr__( 'Earn', 'jetpack' ), __( 'Earn', 'jetpack' ), 'manage_options', 'https://wordpress.com/earn/' . $this->domain, null, 1 );
}
/**
* 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 ) {
if ( $wp_admin ) {
return;
}
$this->update_submenus( 'options-general.php', array( 'options-general.php' => 'https://wordpress.com/settings/general/' . $this->domain ) );
remove_submenu_page( 'options-general.php', 'options-discussion.php' );
remove_submenu_page( 'options-general.php', 'options-writing.php' );
}
/**
* Adds Jetpack menu.
*/
public function add_jetpack_menu() {
global $menu;
$position = 50;
while ( isset( $menu[ $position ] ) ) {
$position++;
}
$this->add_admin_menu_separator( $position++, 'manage_options' );
// TODO: Replace with proper SVG data url.
$icon = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='20' height='20' viewBox='0 0 32 32' %3E%3Cpath fill='%23a0a5aa' d='M16,0C7.2,0,0,7.2,0,16s7.2,16,16,16s16-7.2,16-16S24.8,0,16,0z'%3E%3C/path%3E%3Cpolygon fill='%23fff' points='15,19 7,19 15,3 '%3E%3C/polygon%3E%3Cpolygon fill='%23fff' points='17,29 17,13 25,13 '%3E%3C/polygon%3E%3C/svg%3E";
$is_menu_updated = $this->update_menu( 'jetpack', null, null, null, $icon, $position );
if ( ! $is_menu_updated ) {
add_menu_page( esc_attr__( 'Jetpack', 'jetpack' ), __( 'Jetpack', 'jetpack' ), 'manage_options', 'jetpack', null, $icon, $position );
}
add_submenu_page( 'jetpack', esc_attr__( 'Activity Log', 'jetpack' ), __( 'Activity Log', 'jetpack' ), 'manage_options', 'https://wordpress.com/activity-log/' . $this->domain, null, 2 );
add_submenu_page( 'jetpack', esc_attr__( 'Backup', 'jetpack' ), __( 'Backup', 'jetpack' ), 'manage_options', 'https://wordpress.com/backup/' . $this->domain, null, 3 );
/* translators: Jetpack sidebar menu item. */
add_submenu_page( 'jetpack', esc_attr__( 'Search', 'jetpack' ), __( 'Search', 'jetpack' ), 'read', 'https://wordpress.com/jetpack-search/' . $this->domain, null, 4 );
remove_submenu_page( 'jetpack', 'stats' );
remove_submenu_page( 'jetpack', esc_url( Redirect::get_url( 'calypso-backups' ) ) );
remove_submenu_page( 'jetpack', esc_url( Redirect::get_url( 'calypso-scanner' ) ) );
if ( ! $is_menu_updated ) {
// Remove the submenu auto-created by Core.
remove_submenu_page( 'jetpack', 'jetpack' );
}
}
/**
* Updates the menu data of the given menu slug.
*
* @param string $slug Slug of the menu to update.
* @param string $url New menu URL.
* @param string $title New menu title.
* @param string $cap New menu capability.
* @param string $icon New menu icon.
* @param int $position New menu position.
* @return bool Whether the menu has been updated.
*/
public function update_menu( $slug, $url = null, $title = null, $cap = null, $icon = null, $position = null ) {
global $menu, $submenu;
$menu_item = null;
$menu_position = null;
foreach ( $menu as $i => $item ) {
if ( $slug === $item[2] ) {
$menu_item = $item;
$menu_position = $i;
break;
}
}
if ( ! $menu_item ) {
return false;
}
if ( $title ) {
$menu_item[0] = $title;
$menu_item[3] = esc_attr( $title );
}
if ( $cap ) {
$menu_item[1] = $cap;
}
// Change parent slug only if there are no submenus (the slug of the 1st submenu will be used if there are submenus).
if ( $url ) {
remove_submenu_page( $slug, $slug );
if ( empty( $submenu[ $slug ] ) ) {
$menu_item[2] = $url;
}
}
if ( $icon ) {
$menu_item[4] = 'menu-top';
$menu_item[6] = $icon;
}
if ( $position ) {
// phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
unset( $menu[ $menu_position ] );
$menu_position = $position;
}
// phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
$menu[ $menu_position ] = $menu_item;
// Only add submenu when there are other submenu items.
if ( $url && ! empty( $submenu[ $slug ] ) ) {
add_submenu_page( $slug, $menu_item[3], $menu_item[0], $menu_item[1], $url, null, 0 );
}
return true;
}
/**
* Updates the submenus of the given menu slug.
*
* @param string $slug Menu slug.
* @param array $submenus_to_update Array of new submenu slugs.
*/
public function update_submenus( $slug, $submenus_to_update ) {
global $submenu;
if ( ! isset( $submenu[ $slug ] ) ) {
return;
}
foreach ( $submenu[ $slug ] as $i => $submenu_item ) {
if ( array_key_exists( $submenu_item[2], $submenus_to_update ) ) {
$submenu_item[2] = $submenus_to_update[ $submenu_item[2] ];
// phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
$submenu[ $slug ][ $i ] = $submenu_item;
}
}
}
/**
* Remove submenu items from given menu slug.
*
* @param string $slug Menu slug.
*/
public function remove_submenus( $slug ) {
global $submenu;
if ( isset( $submenu[ $slug ] ) ) {
// phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
$submenu[ $slug ] = array();
}
}
/**
* Adds a menu separator.
*
* @param int $position The position in the menu order this item should appear.
* @param string $cap Optional. The capability required for this menu to be displayed to the user.
* Default: 'read'.
*/
public function add_admin_menu_separator( $position, $cap = 'read' ) {
global $menu;
// phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
$menu[ $position ] = array(
'', // Menu title (ignored).
$cap, // 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.
);
ksort( $menu );
}
/**
* Enqueues scripts and styles.
*/
public function enqueue_scripts() {
$style_dependencies = array();
$rtl = is_rtl() ? '-rtl' : '';
if ( defined( 'IS_WPCOM' ) && IS_WPCOM ) {
$style_dependencies = array( 'wpcom-admin-bar', 'wpcom-masterbar-css' );
} else {
$style_dependencies = array( 'a8c-wpcom-masterbar' . $rtl, 'a8c-wpcom-masterbar-overrides' . $rtl );
}
wp_enqueue_style(
'jetpack-admin-menu',
plugins_url( 'admin-menu.css', __FILE__ ),
$style_dependencies,
JETPACK__VERSION
);
wp_enqueue_script(
'jetpack-admin-menu',
plugins_url( 'admin-menu.js', __FILE__ ),
array(),
JETPACK__VERSION,
true
);
}
/**
* Dequeues unnecessary scripts.
*/
public function dequeue_scripts() {
wp_dequeue_script( 'a8c_wpcom_masterbar_overrides' ); // Initially loaded in modules/masterbar/masterbar/class-masterbar.php.
}
/**
* Whether to use wp-admin pages rather than Calypso.
*
* @return bool
*/
public function should_link_to_wp_admin() {
return get_user_option( 'jetpack_admin_menu_link_destination' );
}
}