action}-{$current_screen->action}, or just {$current_screen->action} if no action is found * * @return string Current screen ID. */ function wc_admin_get_current_screen_id() { $current_screen = get_current_screen(); if ( ! $current_screen ) { return false; } $current_screen_id = $current_screen->action ? $current_screen->action . '-' . $current_screen->id : $current_screen->id; if ( ! empty( $_GET['taxonomy'] ) && ! empty( $_GET['post_type'] ) && 'product' === $_GET['post_type'] ) { $current_screen_id = 'product_page_product_attributes'; } return $current_screen_id; } /** * Returns breadcrumbs for the current page. * * @todo When merging to core, we should explore a better API for defining breadcrumbs, instead of just defining an array. */ function wc_admin_get_embed_breadcrumbs() { $current_screen_id = wc_admin_get_current_screen_id(); // If a page has a tab, we can append that to the screen ID and show another pagination level. $pages_with_tabs = array( 'wc-reports' => 'orders', 'wc-settings' => 'general', 'wc-status' => 'status', ); $tab = ''; $get_tab = isset( $_GET['tab'] ) ? sanitize_text_field( wp_unslash( $_GET['tab'] ) ) : ''; if ( isset( $_GET['page'] ) ) { $page = sanitize_text_field( wp_unslash( $_GET['page'] ) ); if ( in_array( $page, array_keys( $pages_with_tabs ) ) ) { $tab = ! empty( $get_tab ) ? $get_tab . '-' : $pages_with_tabs[ $page ] . '-'; } } $breadcrumbs = apply_filters( 'wc_admin_get_breadcrumbs', array( 'edit-shop_order' => __( 'Orders', 'wc-admin' ), 'add-shop_order' => array( array( '/edit.php?post_type=shop_order', __( 'Orders', 'wc-admin' ) ), __( 'Add New', 'wc-admin' ), ), 'shop_order' => array( array( '/edit.php?post_type=shop_order', __( 'Orders', 'wc-admin' ) ), __( 'Edit Order', 'wc-admin' ), ), 'edit-shop_coupon' => __( 'Coupons', 'wc-admin' ), 'add-shop_coupon' => array( array( 'edit.php?post_type=shop_coupon', __( 'Coupons', 'wc-admin' ) ), __( 'Add New', 'wc-admin' ), ), 'shop_coupon' => array( array( 'edit.php?post_type=shop_coupon', __( 'Coupons', 'wc-admin' ) ), __( 'Edit Coupon', 'wc-admin' ), ), 'woocommerce_page_wc-reports' => array( array( 'admin.php?page=wc-reports', __( 'Reports', 'wc-admin' ) ), ), 'orders-woocommerce_page_wc-reports' => array( array( 'admin.php?page=wc-reports', __( 'Reports', 'wc-admin' ) ), __( 'Orders', 'wc-admin' ), ), 'customers-woocommerce_page_wc-reports' => array( array( 'admin.php?page=wc-reports', __( 'Reports', 'wc-admin' ) ), __( 'Customers', 'wc-admin' ), ), 'stock-woocommerce_page_wc-reports' => array( array( 'admin.php?page=wc-reports', __( 'Reports', 'wc-admin' ) ), __( 'Stock', 'wc-admin' ), ), 'taxes-woocommerce_page_wc-reports' => array( array( 'admin.php?page=wc-reports', __( 'Reports', 'wc-admin' ) ), __( 'Taxes', 'wc-admin' ), ), 'woocommerce_page_wc-settings' => array( array( 'admin.php?page=wc-settings', __( 'Settings', 'wc-admin' ) ), ), 'general-woocommerce_page_wc-settings' => array( array( 'admin.php?page=wc-settings', __( 'Settings', 'wc-admin' ) ), __( 'General', 'wc-admin' ), ), 'products-woocommerce_page_wc-settings' => array( array( 'admin.php?page=wc-settings', __( 'Settings', 'wc-admin' ) ), __( 'Products', 'wc-admin' ), ), 'tax-woocommerce_page_wc-settings' => array( array( 'admin.php?page=wc-settings', __( 'Settings', 'wc-admin' ) ), __( 'Tax', 'wc-admin' ), ), 'shipping-woocommerce_page_wc-settings' => array( array( 'admin.php?page=wc-settings', __( 'Settings', 'wc-admin' ) ), __( 'Shipping', 'wc-admin' ), ), 'checkout-woocommerce_page_wc-settings' => array( array( 'admin.php?page=wc-settings', __( 'Settings', 'wc-admin' ) ), __( 'Payments', 'wc-admin' ), ), 'email-woocommerce_page_wc-settings' => array( array( 'admin.php?page=wc-settings', __( 'Settings', 'wc-admin' ) ), __( 'Emails', 'wc-admin' ), ), 'advanced-woocommerce_page_wc-settings' => array( array( 'admin.php?page=wc-settings', __( 'Settings', 'wc-admin' ) ), __( 'Advanced', 'wc-admin' ), ), 'woocommerce_page_wc-status' => array( __( 'Status', 'wc-admin' ), ), 'status-woocommerce_page_wc-status' => array( array( 'admin.php?page=wc-status', __( 'Status', 'wc-admin' ) ), __( 'System Status', 'wc-admin' ), ), 'tools-woocommerce_page_wc-status' => array( array( 'admin.php?page=wc-status', __( 'Status', 'wc-admin' ) ), __( 'Tools', 'wc-admin' ), ), 'logs-woocommerce_page_wc-status' => array( array( 'admin.php?page=wc-status', __( 'Status', 'wc-admin' ) ), __( 'Logs', 'wc-admin' ), ), 'connect-woocommerce_page_wc-status' => array( array( 'admin.php?page=wc-status', __( 'Status', 'wc-admin' ) ), __( 'WooCommerce Services Status', 'wc-admin' ), ), 'woocommerce_page_wc-addons' => __( 'Extensions', 'wc-admin' ), 'edit-product' => __( 'Products', 'wc-admin' ), 'product_page_product_importer' => array( array( 'edit.php?post_type=product', __( 'Products', 'wc-admin' ) ), __( 'Import', 'wc-admin' ), ), 'product_page_product_exporter' => array( array( 'edit.php?post_type=product', __( 'Products', 'wc-admin' ) ), __( 'Export', 'wc-admin' ), ), 'add-product' => array( array( 'edit.php?post_type=product', __( 'Products', 'wc-admin' ) ), __( 'Add New', 'wc-admin' ), ), 'product' => array( array( 'edit.php?post_type=product', __( 'Products', 'wc-admin' ) ), __( 'Edit Product', 'wc-admin' ), ), 'edit-product_cat' => array( array( 'edit.php?post_type=product', __( 'Products', 'wc-admin' ) ), __( 'Categories', 'wc-admin' ), ), 'edit-product_tag' => array( array( 'edit.php?post_type=product', __( 'Products', 'wc-admin' ) ), __( 'Tags', 'wc-admin' ), ), 'product_page_product_attributes' => array( array( 'edit.php?post_type=product', __( 'Products', 'wc-admin' ) ), __( 'Attributes', 'wc-admin' ), ), ) ); if ( ! empty( $breadcrumbs[ $tab . $current_screen_id ] ) ) { return $breadcrumbs[ $tab . $current_screen_id ]; } elseif ( ! empty( $breadcrumbs[ $current_screen_id ] ) ) { return $breadcrumbs[ $current_screen_id ]; } else { return ''; } } /** * `wc_admin_get_embed_enabled_screen_ids`, `wc_admin_get_embed_enabled_plugin_screen_ids`, * `wc_admin_get_embed_enabled_screen_ids` should be considered temporary functions for the feature plugin. * This is separate from WC's screen_id functions so that extensions explictly have to opt-in to the feature plugin. * * @todo When merging to core, we should explore a better API for opting into the new header for extensions. */ function wc_admin_get_embed_enabled_core_screen_ids() { $screens = array( 'edit-shop_order', 'shop_order', 'add-shop_order', 'edit-shop_coupon', 'shop_coupon', 'add-shop_coupon', 'woocommerce_page_wc-reports', 'woocommerce_page_wc-settings', 'woocommerce_page_wc-status', 'woocommerce_page_wc-addons', 'edit-product', 'product_page_product_importer', 'product_page_product_exporter', 'add-product', 'product', 'edit-product_cat', 'edit-product_tag', 'product_page_product_attributes', ); return apply_filters( 'wc_admin_get_embed_enabled_core_screens_ids', $screens ); } /** * If any extensions want to show the new header, they can register their screen ids. * Separate so extensions can register support for the feature plugin separately. */ function wc_admin_get_embed_enabled_plugin_screen_ids() { $screens = array(); return apply_filters( 'wc_admin_get_embed_enabled_plugin_screens_ids', $screens ); } /** * Returns core and plugin screen IDs for a list of screens the new header should be enabled on. */ function wc_admin_get_embed_enabled_screen_ids() { return array_merge( wc_admin_get_embed_enabled_core_screen_ids(), wc_admin_get_embed_enabled_plugin_screen_ids() ); } /** * Return an object defining the currecy options for the site's current currency * * @return array Settings for the current currency { * Array of settings. * * @type string $code Currency code. * @type string $precision Number of decimals. * @type string $symbol Symbol for currency. * } */ function wc_admin_currency_settings() { $code = get_woocommerce_currency(); return apply_filters( 'wc_currency_settings', array( 'code' => $code, 'precision' => wc_get_price_decimals(), 'symbol' => html_entity_decode( get_woocommerce_currency_symbol( $code ) ), 'position' => get_option( 'woocommerce_currency_pos' ), 'decimal_separator' => wc_get_price_decimal_separator(), 'thousand_separator' => wc_get_price_thousand_separator(), 'price_format' => html_entity_decode( get_woocommerce_price_format() ), ) ); } /** * Returns if a specific wc-admin feature is enabled. * * @param string $feature Feature slug. * @return bool Returns true if the feature is enabled. * } */ function wc_admin_is_feature_enabled( $feature ) { if ( ! function_exists( 'wc_admin_get_feature_config' ) ) { return false; } $features = wc_admin_get_feature_config(); return isset( $features[ $feature ] ) && true === $features[ $feature ]; }