'woocommerce-dashboard', // Expected to be overridden if dashboard is enabled. 'parent' => 'woocommerce', 'title' => null, 'path' => self::APP_ENTRY_POINT, ) ); // TODO: move this somewhere else? $admin_page_base = wp_parse_url( admin_url( 'admin.php' ), PHP_URL_PATH ); $posttype_list_base = wp_parse_url( admin_url( 'edit.php' ), PHP_URL_PATH ); // WooCommerce. wc_admin_connect_page( array( 'id' => 'woocommerce', 'screen_id' => 'woocommerce_page_wc-admin', 'title' => __( 'WooCommerce', 'woocommerce-admin' ), 'full_path' => add_query_arg( 'page', self::APP_ENTRY_POINT, $admin_page_base ), ) ); // WooCommerce > Settings > General (default tab). wc_admin_connect_page( array( 'id' => 'woocommerce-settings', 'parent' => 'woocommerce', 'screen_id' => 'woocommerce_page_wc-settings-general', 'title' => array( __( 'Settings', 'woocommerce-admin' ), __( 'General', 'woocommerce-admin' ), ), 'full_path' => add_query_arg( 'page', 'wc-settings', $admin_page_base ), ) ); // WooCommerce > Settings > Products > General (default tab). wc_admin_connect_page( array( 'id' => 'woocommerce-settings-products', 'parent' => 'woocommerce-settings', 'screen_id' => 'woocommerce_page_wc-settings-products', 'title' => array( __( 'Products', 'woocommerce-admin' ), __( 'General', 'woocommerce-admin' ), ), 'full_path' => add_query_arg( array( 'page' => 'wc-settings', 'tab' => 'products', ), $admin_page_base ), ) ); // WooCommerce > Settings > Products > Inventory. wc_admin_connect_page( array( 'id' => 'woocommerce-settings-products-inventory', 'parent' => 'woocommerce-settings-products', 'screen_id' => 'woocommerce_page_wc-settings-products-inventory', 'title' => __( 'Inventory', 'woocommerce-admin' ), ) ); // WooCommerce > Settings > Products > Downloadable products. wc_admin_connect_page( array( 'id' => 'woocommerce-settings-products-downloadable', 'parent' => 'woocommerce-settings-products', 'screen_id' => 'woocommerce_page_wc-settings-products-downloadable', 'title' => __( 'Downloadable products', 'woocommerce-admin' ), ) ); // WooCommerce > Settings > Shipping > Shipping zones (default tab). wc_admin_connect_page( array( 'id' => 'woocommerce-settings-shipping', 'parent' => 'woocommerce-settings', 'screen_id' => 'woocommerce_page_wc-settings-shipping', 'title' => array( __( 'Shipping', 'woocommerce-admin' ), __( 'Shipping zones', 'woocommerce-admin' ), ), 'full_path' => add_query_arg( array( 'page' => 'wc-settings', 'tab' => 'shipping', ), $admin_page_base ), ) ); // WooCommerce > Settings > Shipping > Shipping zones > Edit zone. wc_admin_connect_page( array( 'id' => 'woocommerce-settings-edit-shipping-zone', 'parent' => 'woocommerce-settings', 'screen_id' => 'woocommerce_page_wc-settings-shipping-edit_zone', 'title' => array( __( 'Shipping zones', 'woocommerce-admin' ), __( 'Edit zone', 'woocommerce-admin' ), ), 'full_path' => add_query_arg( array( 'page' => 'wc-settings', 'tab' => 'shipping', ), $admin_page_base ), ) ); // WooCommerce > Settings > Shipping > Shipping options. wc_admin_connect_page( array( 'id' => 'woocommerce-settings-shipping-options', 'parent' => 'woocommerce-settings-shipping', 'screen_id' => 'woocommerce_page_wc-settings-shipping-options', 'title' => __( 'Shipping options', 'woocommerce-admin' ), ) ); // WooCommerce > Settings > Shipping > Shipping classes. wc_admin_connect_page( array( 'id' => 'woocommerce-settings-shipping-classes', 'parent' => 'woocommerce-settings-shipping', 'screen_id' => 'woocommerce_page_wc-settings-shipping-classes', 'title' => __( 'Shipping classes', 'woocommerce-admin' ), ) ); // WooCommerce > Settings > Payments. wc_admin_connect_page( array( 'id' => 'woocommerce-settings-payments', 'parent' => 'woocommerce-settings', 'screen_id' => 'woocommerce_page_wc-settings-checkout', 'title' => __( 'Payments', 'woocommerce-admin' ), 'full_path' => add_query_arg( array( 'page' => 'wc-settings', 'tab' => 'checkout', ), $admin_page_base ), ) ); // WooCommerce > Settings > Payments > Direct bank transfer. wc_admin_connect_page( array( 'id' => 'woocommerce-settings-payments-bacs', 'parent' => 'woocommerce-settings-payments', 'screen_id' => 'woocommerce_page_wc-settings-checkout-bacs', 'title' => __( 'Direct bank transfer', 'woocommerce-admin' ), ) ); // WooCommerce > Settings > Payments > Check payments. wc_admin_connect_page( array( 'id' => 'woocommerce-settings-payments-cheque', 'parent' => 'woocommerce-settings-payments', 'screen_id' => 'woocommerce_page_wc-settings-checkout-cheque', 'title' => __( 'Check payments', 'woocommerce-admin' ), ) ); // WooCommerce > Settings > Payments > Cash on delivery. wc_admin_connect_page( array( 'id' => 'woocommerce-settings-payments-cod', 'parent' => 'woocommerce-settings-payments', 'screen_id' => 'woocommerce_page_wc-settings-checkout-cod', 'title' => __( 'Cash on delivery', 'woocommerce-admin' ), ) ); // WooCommerce > Settings > Payments > PayPal. wc_admin_connect_page( array( 'id' => 'woocommerce-settings-payments-paypal', 'parent' => 'woocommerce-settings-payments', 'screen_id' => 'woocommerce_page_wc-settings-checkout-paypal', 'title' => __( 'PayPal', 'woocommerce-admin' ), ) ); // WooCommerce > Settings > Accounts & Privacy. wc_admin_connect_page( array( 'id' => 'woocommerce-settings-accounts-privacy', 'parent' => 'woocommerce-settings', 'screen_id' => 'woocommerce_page_wc-settings-account', 'title' => __( 'Accounts & Privacy', 'woocommerce-admin' ), ) ); // WooCommerce > Settings > Emails. wc_admin_connect_page( array( 'id' => 'woocommerce-settings-email', 'parent' => 'woocommerce-settings', 'screen_id' => 'woocommerce_page_wc-settings-email', 'title' => __( 'Emails', 'woocommerce-admin' ), 'full_path' => add_query_arg( array( 'page' => 'wc-settings', 'tab' => 'email', ), $admin_page_base ), ) ); // WooCommerce > Settings > Emails > Edit email (all email editing). $emails = array( 'wc_email_new_order', 'wc_email_cancelled_order', 'wc_email_failed_order', 'wc_email_customer_on_hold_order', 'wc_email_customer_processing_order', 'wc_email_customer_completed_order', 'wc_email_customer_refunded_order', 'wc_email_customer_invoice', 'wc_email_customer_note', 'wc_email_customer_reset_password', 'wc_email_customer_new_account', ); foreach ( $emails as $email ) { wc_admin_connect_page( array( 'id' => 'woocommerce-settings-email-' . $email, 'parent' => 'woocommerce-settings-email', 'screen_id' => 'woocommerce_page_wc-settings-email-' . $email, 'title' => __( 'Edit email', 'woocommerce-admin' ), ) ); } // WooCommerce > Settings > Advanced > Page setup (default tab). wc_admin_connect_page( array( 'id' => 'woocommerce-settings-advanced', 'parent' => 'woocommerce-settings', 'screen_id' => 'woocommerce_page_wc-settings-advanced', 'title' => array( __( 'Advanced', 'woocommerce-admin' ), __( 'Page setup', 'woocommerce-admin' ), ), 'full_path' => add_query_arg( array( 'page' => 'wc-settings', 'tab' => 'advanced', ), $admin_page_base ), ) ); // WooCommerce > Settings > Advanced > REST API. wc_admin_connect_page( array( 'id' => 'woocommerce-settings-advanced-rest-api', 'parent' => 'woocommerce-settings-advanced', 'screen_id' => 'woocommerce_page_wc-settings-advanced-keys', 'title' => __( 'REST API', 'woocommerce-admin' ), ) ); // WooCommerce > Settings > Advanced > Webhooks. wc_admin_connect_page( array( 'id' => 'woocommerce-settings-advanced-webhooks', 'parent' => 'woocommerce-settings-advanced', 'screen_id' => 'woocommerce_page_wc-settings-advanced-webhooks', 'title' => __( 'Webhooks', 'woocommerce-admin' ), ) ); // WooCommerce > Settings > Advanced > Legacy API. wc_admin_connect_page( array( 'id' => 'woocommerce-settings-advanced-legacy-api', 'parent' => 'woocommerce-settings-advanced', 'screen_id' => 'woocommerce_page_wc-settings-advanced-legacy_api', 'title' => __( 'Legacy API', 'woocommerce-admin' ), ) ); // WooCommerce > Settings > Advanced > WooCommerce.com. wc_admin_connect_page( array( 'id' => 'woocommerce-settings-advanced-woocommerce-com', 'parent' => 'woocommerce-settings-advanced', 'screen_id' => 'woocommerce_page_wc-settings-advanced-woocommerce_com', 'title' => __( 'WooCommerce.com', 'woocommerce-admin' ), ) ); // WooCommerce > Orders. wc_admin_connect_page( array( 'id' => 'woocommerce-orders', 'parent' => 'woocommerce', 'screen_id' => 'edit-shop_order', 'title' => __( 'Orders', 'woocommerce-admin' ), 'full_path' => add_query_arg( 'post_type', 'shop_order', $posttype_list_base ), ) ); // WooCommerce > Orders > Add New. wc_admin_connect_page( array( 'id' => 'woocommerce-add-order', 'parent' => 'woocommerce-orders', 'screen_id' => 'shop_order-add', 'title' => __( 'Add New', 'woocommerce-admin' ), ) ); // WooCommerce > Orders > Edit Order. wc_admin_connect_page( array( 'id' => 'woocommerce-edit-order', 'parent' => 'woocommerce-orders', 'screen_id' => 'shop_order', 'title' => __( 'Edit Order', 'woocommerce-admin' ), ) ); // WooCommerce > Coupons. wc_admin_connect_page( array( 'id' => 'woocommerce-coupons', 'parent' => 'woocommerce', 'screen_id' => 'edit-shop_coupon', 'title' => __( 'Coupons', 'woocommerce-admin' ), 'full_path' => add_query_arg( 'post_type', 'shop_coupon', $posttype_list_base ), ) ); // WooCommerce > Coupons > Add New. wc_admin_connect_page( array( 'id' => 'woocommerce-add-coupon', 'parent' => 'woocommerce-coupons', 'screen_id' => 'shop_coupon-add', 'title' => __( 'Add New', 'woocommerce-admin' ), ) ); // WooCommerce > Coupons > Edit Coupon. wc_admin_connect_page( array( 'id' => 'woocommerce-edit-coupon', 'parent' => 'woocommerce-coupons', 'screen_id' => 'shop_coupon', 'title' => __( 'Edit Coupon', 'woocommerce-admin' ), ) ); // WooCommerce > Reports > Orders (default tab). wc_admin_connect_page( array( 'id' => 'woocommerce-reports', 'parent' => 'woocommerce', 'screen_id' => 'woocommerce_page_wc-reports-orders', 'title' => array( __( 'Reports', 'woocommerce-admin' ), __( 'Orders', 'woocommerce-admin' ), ), 'full_path' => add_query_arg( 'page', 'wc-reports', $admin_page_base ), ) ); // WooCommerce > Reports > Customers. wc_admin_connect_page( array( 'id' => 'woocommerce-reports-customers', 'parent' => 'woocommerce-reports', 'screen_id' => 'woocommerce_page_wc-reports-customers', 'title' => __( 'Customers', 'woocommerce-admin' ), ) ); // WooCommerce > Reports > Stock. wc_admin_connect_page( array( 'id' => 'woocommerce-reports-stock', 'parent' => 'woocommerce-reports', 'screen_id' => 'woocommerce_page_wc-reports-stock', 'title' => __( 'Stock', 'woocommerce-admin' ), ) ); // WooCommerce > Reports > Taxes. wc_admin_connect_page( array( 'id' => 'woocommerce-reports-taxes', 'parent' => 'woocommerce-reports', 'screen_id' => 'woocommerce_page_wc-reports-taxes', 'title' => __( 'Taxes', 'woocommerce-admin' ), ) ); // WooCommerce > Status > System status (default tab). wc_admin_connect_page( array( 'id' => 'woocommerce-status', 'parent' => 'woocommerce', 'screen_id' => 'woocommerce_page_wc-status-status', 'title' => array( __( 'Status', 'woocommerce-admin' ), __( 'System status', 'woocommerce-admin' ), ), 'full_path' => add_query_arg( 'page', 'wc-status', $admin_page_base ), ) ); // WooCommerce > Status > Tools. wc_admin_connect_page( array( 'id' => 'woocommerce-status-tools', 'parent' => 'woocommerce-status', 'screen_id' => 'woocommerce_page_wc-status-tools', 'title' => __( 'Tools', 'woocommerce-admin' ), ) ); // WooCommerce > Status > Logs. wc_admin_connect_page( array( 'id' => 'woocommerce-status-logs', 'parent' => 'woocommerce-status', 'screen_id' => 'woocommerce_page_wc-status-tools', 'title' => __( 'Tools', 'woocommerce-admin' ), ) ); // WooCommerce > Status > Scheduled Actions. wc_admin_connect_page( array( 'id' => 'woocommerce-status-action-scheduler', 'parent' => 'woocommerce-status', 'screen_id' => 'woocommerce_page_wc-status-action-scheduler', 'title' => __( 'Scheduled Actions', 'woocommerce-admin' ), ) ); // WooCommerce > Extensions > Browse Extensions (default tab). wc_admin_connect_page( array( 'id' => 'woocommerce-addons', 'parent' => 'woocommerce', 'screen_id' => 'woocommerce_page_wc-addons-browse-extensions', 'title' => array( __( 'Extensions', 'woocommerce-admin' ), __( 'Browse Extensions', 'woocommerce-admin' ), ), 'full_path' => add_query_arg( 'page', 'wc-addons', $admin_page_base ), ) ); // WooCommerce > Extensions > WooCommerce.com Subscriptions. wc_admin_connect_page( array( 'id' => 'woocommerce-addons-subscriptions', 'parent' => 'woocommerce-addons', 'screen_id' => 'woocommerce_page_wc-addons-browse-extensions-helper', 'title' => __( 'WooCommerce.com Subscriptions', 'woocommerce-admin' ), ) ); // WooCommerce > Products. wc_admin_connect_page( array( 'id' => 'woocommerce-products', 'parent' => 'woocommerce', 'screen_id' => 'edit-product', 'title' => __( 'Products', 'woocommerce-admin' ), 'full_path' => add_query_arg( 'post_type', 'product', $posttype_list_base ), ) ); // WooCommerce > Products > Add New. wc_admin_connect_page( array( 'id' => 'woocommerce-add-product', 'parent' => 'woocommerce-products', 'screen_id' => 'product-add', 'title' => __( 'Add New', 'woocommerce-admin' ), ) ); // WooCommerce > Products > Edit Order. wc_admin_connect_page( array( 'id' => 'woocommerce-edit-product', 'parent' => 'woocommerce-products', 'screen_id' => 'product', 'title' => __( 'Edit Product', 'woocommerce-admin' ), ) ); // WooCommerce > Products > Import Products. wc_admin_connect_page( array( 'id' => 'woocommerce-import-products', 'parent' => 'woocommerce-products', 'screen_id' => 'product_page_product_importer', 'title' => __( 'Import Products', 'woocommerce-admin' ), ) ); // WooCommerce > Products > Export Products. wc_admin_connect_page( array( 'id' => 'woocommerce-export-products', 'parent' => 'woocommerce-products', 'screen_id' => 'product_page_product_exporter', 'title' => __( 'Export Products', 'woocommerce-admin' ), ) ); // WooCommerce > Products > Product categories. wc_admin_connect_page( array( 'id' => 'woocommerce-product-categories', 'parent' => 'woocommerce-products', 'screen_id' => 'edit-product_cat', 'title' => __( 'Product categories', 'woocommerce-admin' ), ) ); // WooCommerce > Products > Edit category. wc_admin_connect_page( array( 'id' => 'woocommerce-product-edit-category', 'parent' => 'woocommerce-products', 'screen_id' => 'product_cat', 'title' => __( 'Edit category', 'woocommerce-admin' ), ) ); // WooCommerce > Products > Product tags. wc_admin_connect_page( array( 'id' => 'woocommerce-product-tags', 'parent' => 'woocommerce-products', 'screen_id' => 'edit-product_tag', 'title' => __( 'Product tags', 'woocommerce-admin' ), ) ); // WooCommerce > Products > Edit tag. wc_admin_connect_page( array( 'id' => 'woocommerce-product-edit-tag', 'parent' => 'woocommerce-products', 'screen_id' => 'product_tag', 'title' => __( 'Edit tag', 'woocommerce-admin' ), ) ); // WooCommerce > Products > Attributes. wc_admin_connect_page( array( 'id' => 'woocommerce-product-attributes', 'parent' => 'woocommerce-products', 'screen_id' => 'product_page_product_attributes', 'title' => __( 'Attributes', 'woocommerce-admin' ), ) ); // WooCommerce > Products > Edit attribute. wc_admin_connect_page( array( 'id' => 'woocommerce-product-edit-attribute', 'parent' => 'woocommerce-products', 'screen_id' => 'product_page_product_attribute-edit', 'title' => __( 'Edit attribute', 'woocommerce-admin' ), ) ); } /** * Remove the menu item for the app entry point page. */ public static function remove_app_entry_page_menu_item() { global $submenu; // User does not have capabilites to see the submenu. if ( ! current_user_can( 'manage_woocommerce' ) || empty( $submenu['woocommerce'] ) ) { return; } $wc_admin_key = null; foreach ( $submenu['woocommerce'] as $submenu_key => $submenu_item ) { // Our app entry page menu item has no title. if ( is_null( $submenu_item[0] ) && self::APP_ENTRY_POINT === $submenu_item[2] ) { $wc_admin_key = $submenu_key; break; } } if ( ! $wc_admin_key ) { return; } unset( $submenu['woocommerce'][ $wc_admin_key ] ); } /** * Registers all the neccessary scripts and styles to show the admin experience. */ public static function register_scripts() { if ( ! function_exists( 'wp_set_script_translations' ) ) { return; } wp_register_script( 'wc-csv', self::get_url( 'csv-export/index.js' ), array(), self::get_file_version( 'csv-export/index.js' ), true ); wp_register_script( 'wc-currency', self::get_url( 'currency/index.js' ), array( 'wc-number' ), self::get_file_version( 'currency/index.js' ), true ); wp_set_script_translations( 'wc-currency', 'woocommerce-admin' ); wp_register_script( 'wc-navigation', self::get_url( 'navigation/index.js' ), array(), self::get_file_version( 'navigation/index.js' ), true ); wp_register_script( 'wc-number', self::get_url( 'number/index.js' ), array(), self::get_file_version( 'number/index.js' ), true ); wp_register_script( 'wc-date', self::get_url( 'date/index.js' ), array( 'wp-date', 'wp-i18n' ), self::get_file_version( 'date/index.js' ), true ); wp_set_script_translations( 'wc-date', 'woocommerce-admin' ); wp_register_script( 'wc-components', self::get_url( 'components/index.js' ), array( 'wp-components', 'wp-data', 'wp-element', 'wp-hooks', 'wp-i18n', 'wp-keycodes', 'wc-csv', 'wc-currency', 'wc-date', 'wc-navigation', 'wc-number', ), self::get_file_version( 'components/index.js' ), true ); wp_set_script_translations( 'wc-components', 'woocommerce-admin' ); wp_register_style( 'wc-components', self::get_url( 'components/style.css' ), array( 'wp-edit-blocks' ), self::get_file_version( 'components/style.css' ) ); wp_style_add_data( 'wc-components', 'rtl', 'replace' ); wp_register_style( 'wc-components-ie', self::get_url( 'components/ie.css' ), array( 'wp-edit-blocks' ), self::get_file_version( 'components/ie.css' ) ); wp_style_add_data( 'wc-components-ie', 'rtl', 'replace' ); $entry = 'app'; if ( self::is_embed_page() ) { $entry = 'embedded'; } wp_register_script( WC_ADMIN_APP, self::get_url( "{$entry}/index.js" ), array( 'wc-components', 'wc-navigation', 'wp-date', 'wp-html-entities', 'wp-keycodes', 'wp-i18n' ), self::get_file_version( "{$entry}/index.js" ), true ); wp_set_script_translations( WC_ADMIN_APP, 'woocommerce-admin' ); wp_register_style( WC_ADMIN_APP, self::get_url( "{$entry}/style.css" ), array( 'wc-components' ), self::get_file_version( "{$entry}/style.css" ) ); wp_style_add_data( WC_ADMIN_APP, 'rtl', 'replace' ); } /** * Loads the required scripts on the correct pages. */ public static function load_scripts() { if ( ! self::is_admin_page() && ! self::is_embed_page() ) { return; } wp_enqueue_script( WC_ADMIN_APP ); wp_enqueue_style( WC_ADMIN_APP ); // Use server-side detection to prevent unneccessary stylesheet loading in other browsers. $user_agent = isset( $_SERVER['HTTP_USER_AGENT'] ) ? $_SERVER['HTTP_USER_AGENT'] : ''; // WPCS: sanitization ok. preg_match( '/MSIE (.*?);/', $user_agent, $matches ); if ( count( $matches ) < 2 ) { preg_match( '/Trident\/\d{1,2}.\d{1,2}; rv:([0-9]*)/', $user_agent, $matches ); } if ( count( $matches ) > 1 ) { wp_enqueue_style( 'wc-components-ie' ); } } /** * Returns true if we are on a JS powered admin page. */ public static function is_admin_page() { return wc_admin_is_registered_page(); } /** * Returns true if we are on a "classic" (non JS app) powered admin page. * * @todo See usage in `admin.php`. This needs refactored and implemented properly in core. */ public static function is_embed_page() { return wc_admin_is_connected_page(); } /** * Returns breadcrumbs for the current page. */ private static function get_embed_breadcrumbs() { return wc_admin_get_breadcrumbs(); } /** * Outputs breadcrumbs via PHP for the initial load of an embedded page. * * @param array $section Section to create breadcrumb from. */ private static function output_breadcrumbs( $section ) { ?>