2019-04-11 18:31:31 +00:00
< ? php
/**
* Register the scripts , styles , and includes needed for pieces of the WooCommerce Admin experience .
* NOTE : DO NOT edit this file in WooCommerce core , this is generated from woocommerce - admin .
*
* @ package Woocommerce Admin
*/
2019-08-12 18:11:28 +00:00
namespace Automattic\WooCommerce\Admin ;
2019-09-23 21:47:08 +00:00
use \_WP_Dependency ;
2019-04-11 18:31:31 +00:00
/**
2019-08-12 21:52:09 +00:00
* Loader Class .
2019-04-11 18:31:31 +00:00
*/
2019-08-12 21:52:09 +00:00
class Loader {
2019-05-07 19:48:34 +00:00
/**
* App entry point .
*/
const APP_ENTRY_POINT = 'wc-admin' ;
2019-04-11 18:31:31 +00:00
/**
* Class instance .
*
2019-08-12 21:52:09 +00:00
* @ var Loader instance
2019-04-11 18:31:31 +00:00
*/
protected static $instance = null ;
/**
* An array of classes to load from the includes folder .
*
* @ var array
*/
protected static $classes = array ();
/**
* Get class instance .
*/
public static function get_instance () {
if ( ! self :: $instance ) {
self :: $instance = new self ();
}
return self :: $instance ;
}
/**
* Constructor .
* Hooks added here should be removed in `wc_admin_initialize` via the feature plugin .
*/
public function __construct () {
2019-10-01 23:35:37 +00:00
add_action ( 'init' , array ( __CLASS__ , 'define_tables' ) );
2019-08-12 18:11:28 +00:00
add_action ( 'init' , array ( __CLASS__ , 'load_features' ) );
2019-10-02 13:25:31 +00:00
add_action ( 'admin_enqueue_scripts' , array ( __CLASS__ , 'register_scripts' ) );
2019-09-23 21:47:08 +00:00
add_action ( 'admin_enqueue_scripts' , array ( __CLASS__ , 'inject_wc_settings_dependencies' ), 14 );
2019-08-12 18:11:28 +00:00
add_action ( 'admin_enqueue_scripts' , array ( __CLASS__ , 'load_scripts' ), 15 );
2019-10-02 13:25:31 +00:00
// Old settings injection.
2019-09-23 21:47:08 +00:00
add_filter ( 'woocommerce_components_settings' , array ( __CLASS__ , 'add_component_settings' ) );
2019-10-02 13:25:31 +00:00
// New settings injection.
2019-09-23 21:47:08 +00:00
add_filter ( 'woocommerce_shared_settings' , array ( __CLASS__ , 'add_component_settings' ) );
2019-08-12 18:11:28 +00:00
add_filter ( 'admin_body_class' , array ( __CLASS__ , 'add_admin_body_classes' ) );
add_action ( 'admin_menu' , array ( __CLASS__ , 'register_page_handler' ) );
add_filter ( 'admin_title' , array ( __CLASS__ , 'update_admin_title' ) );
add_action ( 'rest_api_init' , array ( __CLASS__ , 'register_user_data' ) );
add_action ( 'in_admin_header' , array ( __CLASS__ , 'embed_page_header' ) );
add_filter ( 'woocommerce_settings_groups' , array ( __CLASS__ , 'add_settings_group' ) );
add_filter ( 'woocommerce_settings-wc_admin' , array ( __CLASS__ , 'add_settings' ) );
add_action ( 'admin_head' , array ( __CLASS__ , 'remove_notices' ) );
2019-10-02 13:25:31 +00:00
add_action ( 'admin_notices' , array ( __CLASS__ , 'inject_before_notices' ), - 9999 );
2019-08-12 18:11:28 +00:00
add_action ( 'admin_notices' , array ( __CLASS__ , 'inject_after_notices' ), PHP_INT_MAX );
2019-04-11 18:31:31 +00:00
// priority is 20 to run after https://github.com/woocommerce/woocommerce/blob/a55ae325306fc2179149ba9b97e66f32f84fdd9c/includes/admin/class-wc-admin-menus.php#L165.
2019-08-12 18:11:28 +00:00
add_action ( 'admin_head' , array ( __CLASS__ , 'remove_app_entry_page_menu_item' ), 20 );
2019-05-16 13:21:11 +00:00
/*
* Remove the emoji script as it always defaults to replacing emojis with Twemoji images .
* Gutenberg has also disabled emojis . More on that here -> https :// github . com / WordPress / gutenberg / pull / 6151
*/
remove_action ( 'admin_print_scripts' , 'print_emoji_detection_script' );
2019-04-11 18:31:31 +00:00
}
2019-10-01 23:35:37 +00:00
/**
* Add custom tables to $wpdb object .
*/
public static function define_tables () {
global $wpdb ;
// List of tables without prefixes.
$tables = array (
'wc_category_lookup' => 'wc_category_lookup' ,
);
foreach ( $tables as $name => $table ) {
$wpdb -> $name = $wpdb -> prefix . $table ;
$wpdb -> tables [] = $table ;
}
}
2019-04-11 18:31:31 +00:00
/**
* Gets an array of enabled WooCommerce Admin features / sections .
*
* @ return bool Enabled Woocommerce Admin features / sections .
*/
public static function get_features () {
return apply_filters ( 'woocommerce_admin_features' , array () );
}
/**
* Returns if a specific wc - admin feature is enabled .
*
* @ param string $feature Feature slug .
* @ return bool Returns true if the feature is enabled .
*/
public static function is_feature_enabled ( $feature ) {
$features = self :: get_features ();
2019-05-28 10:38:01 +00:00
return in_array ( $feature , $features , true );
2019-04-11 18:31:31 +00:00
}
/**
* Gets the URL to an asset file .
*
* @ param string $file name .
* @ return string URL to asset .
*/
public static function get_url ( $file ) {
return plugins_url ( self :: get_path ( $file ) . $file , WC_ADMIN_PLUGIN_FILE );
}
/**
* Gets the file modified time as a cache buster if we ' re in dev mode , or the plugin version otherwise .
*
* @ param string $file Local path to the file .
* @ return string The cache buster value to use for the given file .
*/
public static function get_file_version ( $file ) {
if ( defined ( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ) {
$file = trim ( $file , '/' );
return filemtime ( WC_ADMIN_ABSPATH . self :: get_path ( $file ) );
}
return WC_ADMIN_VERSION_NUMBER ;
}
/**
* Gets the path for the asset depending on file type .
*
* @ param string $file name .
* @ return string Folder path of asset .
*/
private static function get_path ( $file ) {
return '.css' === substr ( $file , - 4 ) ? WC_ADMIN_DIST_CSS_FOLDER : WC_ADMIN_DIST_JS_FOLDER ;
}
/**
* Class loader for enabled WooCommerce Admin features / sections .
*/
public static function load_features () {
$features = self :: get_features ();
foreach ( $features as $feature ) {
2019-08-12 18:50:22 +00:00
$feature = str_replace ( '-' , '' , ucwords ( strtolower ( $feature ), '-' ) );
$feature = 'Automattic\\WooCommerce\\Admin\\Features\\' . $feature ;
2019-07-29 18:04:17 +00:00
if ( class_exists ( $feature ) ) {
2019-10-02 13:25:31 +00:00
new $feature ();
2019-04-11 18:31:31 +00:00
}
}
}
/**
* Registers a basic page handler for the app entry point .
*
* @ todo The entry point for the embed needs moved to this class as well .
*/
public static function register_page_handler () {
2019-05-14 18:31:03 +00:00
$analytics_cap = apply_filters ( 'woocommerce_admin_analytics_menu_capability' , 'view_woocommerce_reports' );
2019-05-07 19:48:34 +00:00
wc_admin_register_page (
array (
2019-05-14 18:31:03 +00:00
'id' => 'woocommerce-dashboard' , // Expected to be overridden if dashboard is enabled.
'parent' => 'woocommerce' ,
'title' => null ,
'path' => self :: APP_ENTRY_POINT ,
'capability' => $analytics_cap ,
2019-05-07 19:48:34 +00:00
)
2019-04-11 18:31:31 +00:00
);
2019-05-08 14:41:35 +00:00
2019-05-10 17:22:52 +00:00
// Connect existing WooCommerce pages.
2019-08-12 18:22:32 +00:00
require_once WC_ADMIN_ABSPATH . 'includes/connect-existing-pages.php' ;
2019-04-11 18:31:31 +00:00
}
/**
2019-05-07 19:48:34 +00:00
* Remove the menu item for the app entry point page .
2019-04-11 18:31:31 +00:00
*/
2019-05-07 19:48:34 +00:00
public static function remove_app_entry_page_menu_item () {
2019-04-11 18:31:31 +00:00
global $submenu ;
// User does not have capabilites to see the submenu.
2019-04-29 09:57:33 +00:00
if ( ! current_user_can ( 'manage_woocommerce' ) || empty ( $submenu [ 'woocommerce' ] ) ) {
2019-04-11 18:31:31 +00:00
return ;
}
$wc_admin_key = null ;
foreach ( $submenu [ 'woocommerce' ] as $submenu_key => $submenu_item ) {
2019-05-07 19:48:34 +00:00
// Our app entry page menu item has no title.
if ( is_null ( $submenu_item [ 0 ] ) && self :: APP_ENTRY_POINT === $submenu_item [ 2 ] ) {
2019-04-11 18:31:31 +00:00
$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 () {
2019-04-26 18:39:37 +00:00
if ( ! function_exists ( 'wp_set_script_translations' ) ) {
return ;
}
2019-04-11 18:31:31 +00:00
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 (
2019-06-20 08:53:02 +00:00
'wp-api-fetch' ,
2019-04-11 18:31:31 +00:00
'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' ),
2019-06-14 17:13:59 +00:00
array ( 'wp-components' ),
2019-04-11 18:31:31 +00:00
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' ),
2019-06-14 17:13:59 +00:00
array ( 'wp-components' ),
2019-04-11 18:31:31 +00:00
self :: get_file_version ( 'components/ie.css' )
);
wp_style_add_data ( 'wc-components-ie' , 'rtl' , 'replace' );
wp_register_script (
WC_ADMIN_APP ,
2019-09-24 15:55:39 +00:00
self :: get_url ( 'app/index.js' ),
2019-04-11 18:31:31 +00:00
array ( 'wc-components' , 'wc-navigation' , 'wp-date' , 'wp-html-entities' , 'wp-keycodes' , 'wp-i18n' ),
2019-09-24 15:55:39 +00:00
self :: get_file_version ( 'app/index.js' ),
2019-04-11 18:31:31 +00:00
true
);
wp_set_script_translations ( WC_ADMIN_APP , 'woocommerce-admin' );
wp_register_style (
WC_ADMIN_APP ,
2019-09-24 15:55:39 +00:00
self :: get_url ( 'app/style.css' ),
2019-04-11 18:31:31 +00:00
array ( 'wc-components' ),
2019-10-02 13:25:31 +00:00
self :: get_file_version ( 'app/style.css' )
2019-04-11 18:31:31 +00:00
);
wp_style_add_data ( WC_ADMIN_APP , 'rtl' , 'replace' );
2019-07-18 10:11:21 +00:00
wp_register_style (
'wc-material-icons' ,
'https://fonts.googleapis.com/icon?family=Material+Icons+Outlined' ,
array (),
self :: get_file_version ( 'https://fonts.googleapis.com/icon?family=Material+Icons' )
);
2019-04-11 18:31:31 +00:00
}
/**
* 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 );
2019-07-18 10:11:21 +00:00
wp_enqueue_style ( 'wc-material-icons' );
2019-04-11 18:31:31 +00:00
// 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 () {
2019-05-07 22:08:18 +00:00
return wc_admin_is_registered_page ();
2019-04-11 18:31:31 +00:00
}
/**
* Returns true if we are on a " classic " ( non JS app ) powered admin page .
*
2019-10-01 23:35:37 +00:00
* TODO : See usage in `admin.php` . This needs refactored and implemented properly in core .
2019-04-11 18:31:31 +00:00
*/
public static function is_embed_page () {
2019-05-08 14:41:35 +00:00
return wc_admin_is_connected_page ();
2019-04-11 18:31:31 +00:00
}
/**
* Returns breadcrumbs for the current page .
*/
private static function get_embed_breadcrumbs () {
2019-05-08 14:41:35 +00:00
return wc_admin_get_breadcrumbs ();
2019-04-11 18:31:31 +00:00
}
/**
* 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 ) {
?>
< span >
< ? php if ( is_array ( $section ) ) : ?>
2019-05-10 15:47:48 +00:00
< a href = " <?php echo esc_url( admin_url( $section[0] ) ); ?> " >< ? php echo esc_html ( $section [ 1 ] ); ?> </a>
2019-04-11 18:31:31 +00:00
< ? php else : ?>
< ? php echo esc_html ( $section ); ?>
< ? php endif ; ?>
</ span >
< ? php
}
/**
* Set up a div for the header embed to render into .
* The initial contents here are meant as a place loader for when the PHP page initialy loads .
*/
public static function embed_page_header () {
if ( ! self :: is_embed_page () ) {
return ;
}
$sections = self :: get_embed_breadcrumbs ();
$sections = is_array ( $sections ) ? $sections : array ( $sections );
?>
2019-05-23 09:29:14 +00:00
< div id = " woocommerce-embedded-root " class = " is-embed-loading " >
2019-04-11 18:31:31 +00:00
< div class = " woocommerce-layout " >
< div class = " woocommerce-layout__header is-embed-loading " >
< h1 class = " woocommerce-layout__header-breadcrumbs " >
2019-05-10 15:47:48 +00:00
< span >
2019-07-01 08:15:46 +00:00
< a href = " <?php echo esc_url( admin_url( 'admin.php?page=wc-admin' ) ); ?> " >< ? php esc_html_e ( 'WooCommerce' , 'woocommerce-admin' ); ?> </a>
2019-05-10 15:47:48 +00:00
</ span >
2019-04-11 18:31:31 +00:00
< ? php foreach ( $sections as $section ) : ?>
< ? php self :: output_breadcrumbs ( $section ); ?>
< ? php endforeach ; ?>
</ h1 >
</ div >
</ div >
</ div >
< ? php
}
/**
* Adds body classes to the main wp - admin wrapper , allowing us to better target elements in specific scenarios .
*
* @ param string $admin_body_class Body class to add .
*/
public static function add_admin_body_classes ( $admin_body_class = '' ) {
if ( ! self :: is_admin_page () && ! self :: is_embed_page () ) {
return $admin_body_class ;
}
$classes = explode ( ' ' , trim ( $admin_body_class ) );
$classes [] = 'woocommerce-page' ;
if ( self :: is_embed_page () ) {
$classes [] = 'woocommerce-embed-page' ;
}
2019-05-28 10:38:01 +00:00
// Some routes or features like onboarding hide the wp-admin navigation and masterbar. Setting `woocommerce_admin_is_loading` to true allows us
// to premeptively hide these elements while the JS app loads. This class is removed when `<Layout />` is rendered.
if ( self :: is_admin_page () && apply_filters ( 'woocommerce_admin_is_loading' , false ) ) {
$classes [] = 'woocommerce-admin-is-loading' ;
}
2019-04-11 18:31:31 +00:00
$features = self :: get_features ();
foreach ( $features as $feature_key ) {
$classes [] = sanitize_html_class ( 'woocommerce-feature-enabled-' . $feature_key );
}
$admin_body_class = implode ( ' ' , array_unique ( $classes ) );
return " $admin_body_class " ;
}
/**
* Removes notices that should not be displayed on WC Admin pages .
*/
public static function remove_notices () {
if ( ! self :: is_admin_page () && ! self :: is_embed_page () ) {
return ;
}
// Hello Dolly.
if ( function_exists ( 'hello_dolly' ) ) {
remove_action ( 'admin_notices' , 'hello_dolly' );
}
}
/**
* Runs before admin notices action and hides them .
*/
public static function inject_before_notices () {
if ( ( ! self :: is_admin_page () && ! self :: is_embed_page () ) ) {
return ;
}
echo '<div class="woocommerce-layout__notice-list-hide" id="wp__notice-list">' ;
echo '<div class="wp-header-end" id="woocommerce-layout__notice-catcher"></div>' ; // https://github.com/WordPress/WordPress/blob/f6a37e7d39e2534d05b9e542045174498edfe536/wp-admin/js/common.js#L737.
}
/**
* Runs after admin notices and closes div .
*/
public static function inject_after_notices () {
if ( ( ! self :: is_admin_page () && ! self :: is_embed_page () ) ) {
return ;
}
echo '</div>' ;
}
/**
* Edits Admin title based on section of wc - admin .
*
* @ param string $admin_title Modifies admin title .
* @ todo Can we do some URL rewriting so we can figure out which page they are on server side ?
*/
public static function update_admin_title ( $admin_title ) {
2019-08-02 14:32:52 +00:00
if (
! did_action ( 'current_screen' ) ||
(
! self :: is_admin_page () &&
! self :: is_embed_page ()
)
) {
2019-04-11 18:31:31 +00:00
return $admin_title ;
}
2019-05-08 14:41:35 +00:00
$sections = self :: get_embed_breadcrumbs ();
$pieces = array ();
2019-04-11 18:31:31 +00:00
2019-05-08 14:41:35 +00:00
foreach ( $sections as $section ) {
$pieces [] = is_array ( $section ) ? $section [ 1 ] : $section ;
2019-04-11 18:31:31 +00:00
}
2019-05-08 14:41:35 +00:00
$pieces = array_reverse ( $pieces );
$title = implode ( ' ‹ ' , $pieces );
2019-04-11 18:31:31 +00:00
/* translators: %1$s: updated title, %2$s: blog info name */
2019-05-08 14:41:35 +00:00
return sprintf ( __ ( '%1$s ‹ %2$s' , 'woocommerce-admin' ), $title , get_bloginfo ( 'name' ) );
2019-04-11 18:31:31 +00:00
}
/**
* Set up a div for the app to render into .
*/
public static function page_wrapper () {
?>
< div class = " wrap " >
< div id = " root " ></ div >
</ div >
< ? php
}
/**
* Hooks extra neccessary data into the component settings array already set in WooCommerce core .
*
* @ param array $settings Array of component settings .
* @ return array Array of component settings .
*/
public static function add_component_settings ( $settings ) {
2019-09-25 17:59:11 +00:00
if ( ! is_admin () ) {
return $settings ;
}
2019-10-02 13:25:31 +00:00
2019-09-23 21:47:08 +00:00
if ( ! function_exists ( 'wc_blocks_container' ) ) {
global $wp_locale ;
// inject data not available via older versions of wc_blocks/woo.
2019-10-02 13:25:31 +00:00
$settings [ 'orderStatuses' ] = self :: get_order_statuses ( wc_get_order_statuses () );
$settings [ 'currency' ] = self :: get_currency_settings ();
$settings [ 'locale' ] = [
'siteLocale' => isset ( $settings [ 'siteLocale' ] )
2019-09-23 21:47:08 +00:00
? $settings [ 'siteLocale' ]
: get_locale (),
2019-10-02 13:25:31 +00:00
'userLocale' => isset ( $settings [ 'l10n' ][ 'userLocale' ] )
2019-09-23 21:47:08 +00:00
? $settings [ 'l10n' ][ 'userLocale' ]
: get_user_locale (),
'weekdaysShort' => isset ( $settings [ 'l10n' ][ 'weekdaysShort' ] )
? $settings [ 'l10n' ][ 'weekdaysShort' ]
2019-10-02 13:25:31 +00:00
: array_values ( $wp_locale -> weekday_abbrev ),
2019-09-23 21:47:08 +00:00
];
}
2019-09-25 17:59:11 +00:00
2019-04-11 18:31:31 +00:00
$preload_data_endpoints = apply_filters ( 'woocommerce_component_settings_preload_endpoints' , array ( '/wc/v3' ) );
if ( ! empty ( $preload_data_endpoints ) ) {
$preload_data = array_reduce (
array_values ( $preload_data_endpoints ),
'rest_preload_api_request'
);
}
$current_user_data = array ();
foreach ( self :: get_user_data_fields () as $user_field ) {
$current_user_data [ $user_field ] = json_decode ( get_user_meta ( get_current_user_id (), 'wc_admin_' . $user_field , true ) );
}
2019-06-27 09:21:43 +00:00
$settings [ 'currentUserData' ] = $current_user_data ;
$settings [ 'reviewsEnabled' ] = get_option ( 'woocommerce_enable_reviews' );
$settings [ 'manageStock' ] = get_option ( 'woocommerce_manage_stock' );
$settings [ 'commentModeration' ] = get_option ( 'comment_moderation' );
$settings [ 'notifyLowStockAmount' ] = get_option ( 'woocommerce_notify_low_stock_amount' );
2019-04-18 08:38:42 +00:00
// @todo On merge, once plugin images are added to core WooCommerce, `wcAdminAssetUrl` can be retired,
// and `wcAssetUrl` can be used in its place throughout the codebase.
2019-08-12 18:11:28 +00:00
$settings [ 'wcAdminAssetUrl' ] = plugins_url ( 'images/' , plugin_dir_path ( dirname ( __DIR__ ) ) . 'woocommerce-admin.php' );
2019-04-11 18:31:31 +00:00
if ( ! empty ( $preload_data_endpoints ) ) {
2019-09-23 21:47:08 +00:00
$settings [ 'dataEndpoints' ] = isset ( $settings [ 'dataEndpoints' ] )
? $settings [ 'dataEndpoints' ]
: [];
2019-04-11 18:31:31 +00:00
foreach ( $preload_data_endpoints as $key => $endpoint ) {
2019-06-13 20:54:10 +00:00
// Handle error case: rest_do_request() doesn't guarantee success.
if ( empty ( $preload_data [ $endpoint ] ) ) {
$settings [ 'dataEndpoints' ][ $key ] = array ();
} else {
$settings [ 'dataEndpoints' ][ $key ] = $preload_data [ $endpoint ][ 'body' ];
}
2019-04-11 18:31:31 +00:00
}
}
$settings = self :: get_custom_settings ( $settings );
if ( self :: is_embed_page () ) {
$settings [ 'embedBreadcrumbs' ] = self :: get_embed_breadcrumbs ();
}
return $settings ;
}
/**
* Format order statuses by removing a leading 'wc-' if present .
*
* @ param array $statuses Order statuses .
* @ return array formatted statuses .
*/
public static function get_order_statuses ( $statuses ) {
$formatted_statuses = array ();
foreach ( $statuses as $key => $value ) {
$formatted_key = preg_replace ( '/^wc-/' , '' , $key );
$formatted_statuses [ $formatted_key ] = $value ;
}
return $formatted_statuses ;
}
/**
* Register the admin settings for use in the WC REST API
*
* @ param array $groups Array of setting groups .
* @ return array
*/
public static function add_settings_group ( $groups ) {
$groups [] = array (
'id' => 'wc_admin' ,
'label' => __ ( 'WooCommerce Admin' , 'woocommerce-admin' ),
'description' => __ ( 'Settings for WooCommerce admin reporting.' , 'woocommerce-admin' ),
);
return $groups ;
}
/**
* Add WC Admin specific settings
*
* @ param array $settings Array of settings in wc admin group .
* @ return array
*/
public static function add_settings ( $settings ) {
$statuses = self :: get_order_statuses ( wc_get_order_statuses () );
$settings [] = array (
'id' => 'woocommerce_excluded_report_order_statuses' ,
'option_key' => 'woocommerce_excluded_report_order_statuses' ,
'label' => __ ( 'Excluded report order statuses' , 'woocommerce-admin' ),
'description' => __ ( 'Statuses that should not be included when calculating report totals.' , 'woocommerce-admin' ),
'default' => array ( 'pending' , 'cancelled' , 'failed' ),
'type' => 'multiselect' ,
'options' => $statuses ,
);
$settings [] = array (
'id' => 'woocommerce_actionable_order_statuses' ,
'option_key' => 'woocommerce_actionable_order_statuses' ,
'label' => __ ( 'Actionable order statuses' , 'woocommerce-admin' ),
'description' => __ ( 'Statuses that require extra action on behalf of the store admin.' , 'woocommerce-admin' ),
'default' => array ( 'processing' , 'on-hold' ),
'type' => 'multiselect' ,
'options' => $statuses ,
);
2019-05-22 21:43:04 +00:00
$settings [] = array (
'id' => 'woocommerce_default_date_range' ,
'option_key' => 'woocommerce_default_date_range' ,
'label' => __ ( 'Default Date Range' , 'woocommerce-admin' ),
'description' => __ ( 'Default Date Range' , 'woocommerce-admin' ),
'default' => 'period=month&compare=previous_year' ,
'type' => 'text' ,
);
2019-04-11 18:31:31 +00:00
return $settings ;
}
/**
* Gets custom settings used for WC Admin .
*
* @ param array $settings Array of settings to merge into .
* @ return array
*/
public static function get_custom_settings ( $settings ) {
2019-08-12 18:11:28 +00:00
$wc_rest_settings_options_controller = new \WC_REST_Setting_Options_Controller ();
2019-04-11 18:31:31 +00:00
$wc_admin_group_settings = $wc_rest_settings_options_controller -> get_group_settings ( 'wc_admin' );
$settings [ 'wcAdminSettings' ] = array ();
foreach ( $wc_admin_group_settings as $setting ) {
2019-07-05 14:12:03 +00:00
if ( ! empty ( $setting [ 'id' ] ) ) {
2019-04-11 18:31:31 +00:00
$settings [ 'wcAdminSettings' ][ $setting [ 'id' ] ] = $setting [ 'value' ];
}
}
return $settings ;
}
/**
* 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 .
* }
*/
public static function get_currency_settings () {
$code = get_woocommerce_currency ();
return apply_filters (
'wc_currency_settings' ,
array (
2019-09-23 21:47:08 +00:00
'code' => $code ,
'precision' => wc_get_price_decimals (),
'symbol' => html_entity_decode ( get_woocommerce_currency_symbol ( $code ) ),
'symbolPosition' => get_option ( 'woocommerce_currency_pos' ),
'decimalSeparator' => wc_get_price_decimal_separator (),
'thousandSeparator' => wc_get_price_thousand_separator (),
'priceFormat' => html_entity_decode ( get_woocommerce_price_format () ),
2019-04-11 18:31:31 +00:00
)
);
}
/**
* Registers WooCommerce specific user data to the WordPress user API .
*/
public static function register_user_data () {
register_rest_field (
'user' ,
'woocommerce_meta' ,
array (
2019-08-12 18:11:28 +00:00
'get_callback' => array ( __CLASS__ , 'get_user_data_values' ),
'update_callback' => array ( __CLASS__ , 'update_user_data_values' ),
2019-04-11 18:31:31 +00:00
'schema' => null ,
)
);
}
/**
2019-08-12 21:52:09 +00:00
* For all the registered user data fields ( Loader :: get_user_data_fields ), fetch the data
2019-04-11 18:31:31 +00:00
* for returning via the REST API .
*
* @ param WP_User $user Current user .
*/
public static function get_user_data_values ( $user ) {
$values = array ();
foreach ( self :: get_user_data_fields () as $field ) {
$values [ $field ] = get_user_meta ( $user [ 'id' ], 'wc_admin_' . $field , true );
}
return $values ;
}
/**
2019-08-12 21:52:09 +00:00
* For all the registered user data fields ( Loader :: get_user_data_fields ), update the data
2019-04-11 18:31:31 +00:00
* for the REST API .
*
* @ param array $values The new values for the meta .
* @ param WP_User $user The current user .
* @ param string $field_id The field id for the user meta .
*/
public static function update_user_data_values ( $values , $user , $field_id ) {
if ( empty ( $values ) || ! is_array ( $values ) || 'woocommerce_meta' !== $field_id ) {
return ;
}
$fields = self :: get_user_data_fields ();
$updates = array ();
foreach ( $values as $field => $value ) {
if ( in_array ( $field , $fields , true ) ) {
$updates [ $field ] = $value ;
update_user_meta ( $user -> ID , 'wc_admin_' . $field , $value );
}
}
return $updates ;
}
/**
* We store some WooCommerce specific user meta attached to users endpoint ,
* so that we can track certain preferences or values such as the inbox activity panel last open time .
* Additional fields can be added in the function below , and then used via wc - admin ' s currentUser data .
*
* @ return array Fields to expose over the WP user endpoint .
*/
public static function get_user_data_fields () {
return apply_filters ( 'wc_admin_get_user_data_fields' , array () );
}
2019-09-23 21:47:08 +00:00
/**
* Injects wp - shared - settings as a dependency if it ' s present .
*/
public static function inject_wc_settings_dependencies () {
if ( wp_script_is ( 'wc-settings' , 'registered' ) ) {
$handles_for_injection = [
'wc-csv' ,
'wc-currency' ,
'wc-navigation' ,
'wc-number' ,
'wc-date' ,
'wc-components' ,
];
2019-10-02 13:25:31 +00:00
foreach ( $handles_for_injection as $handle ) {
2019-09-23 21:47:08 +00:00
$script = wp_scripts () -> query ( $handle , 'registered' );
if ( $script instanceof _WP_Dependency ) {
$script -> deps [] = 'wc-settings' ;
}
}
}
}
2019-04-11 18:31:31 +00:00
}