Automattic\WooCommerce\Blocks\Assets
AssetDataRegistry{} WC 2.5.0
Class instance for registering data used on the current view session by assets.
Holds data registered for output on the current view session when wc-settings is enqueued( directly or via dependency )
Хуки из класса
Возвращает
null
. Ничего.
Использование
$AssetDataRegistry = new AssetDataRegistry(); // use class methods
Методы
- __construct( Api $asset_api )
- add( $key, $data )
- add_data( $key, $data )
- debug()
- enqueue_asset_data()
- execute_lazy_data()
- exists( $key )
- get()
- get_core_data()
- get_order_statuses( $statuses )
- init()
- initialize_core_data()
- register_data_script()
Список изменений
С версии 2.5.0 | Введена. |
Код AssetDataRegistry{} AssetDataRegistry{} WC 5.2.2
<?php
class AssetDataRegistry {
/**
* Contains registered data.
*
* @var array
*/
private $data = [];
/**
* Lazy data is an array of closures that will be invoked just before
* asset data is generated for the enqueued script.
*
* @var array
*/
private $lazy_data = [];
/**
* Asset handle for registered data.
*
* @var string
*/
private $handle = 'wc-settings';
/**
* Asset API interface for various asset registration.
*
* @var API
*/
private $api;
/**
* Constructor
*
* @param Api $asset_api Asset API interface for various asset registration.
*/
public function __construct( Api $asset_api ) {
$this->api = $asset_api;
$this->init();
}
/**
* Hook into WP asset registration for enqueueing asset data.
*/
protected function init() {
add_action( 'init', array( $this, 'register_data_script' ) );
add_action( 'wp_print_footer_scripts', array( $this, 'enqueue_asset_data' ), 1 );
add_action( 'admin_print_footer_scripts', array( $this, 'enqueue_asset_data' ), 1 );
}
/**
* Exposes core asset data
*
* @return array An array containing core data.
*/
protected function get_core_data() {
global $wp_locale;
$currency = get_woocommerce_currency();
return [
'wpVersion' => get_bloginfo( 'version' ),
'wcVersion' => defined( 'WC_VERSION' ) ? WC_VERSION : '',
'adminUrl' => admin_url(),
'countries' => WC()->countries->get_countries(),
'currency' => [
'code' => $currency,
'precision' => wc_get_price_decimals(),
'symbol' => html_entity_decode( get_woocommerce_currency_symbol( $currency ) ),
'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() ),
],
'locale' => [
'siteLocale' => get_locale(),
'userLocale' => get_user_locale(),
'weekdaysShort' => array_values( $wp_locale->weekday_abbrev ),
],
'orderStatuses' => $this->get_order_statuses( wc_get_order_statuses() ),
'siteTitle' => get_bloginfo( 'name ' ),
'wcAssetUrl' => plugins_url( 'assets/', WC_PLUGIN_FILE ),
];
}
/**
* Returns block-related data for enqueued wc-settings script.
* Format order statuses by removing a leading 'wc-' if present.
*
* @param array $statuses Order statuses.
* @return array formatted statuses.
*/
protected 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;
}
/**
* Used for on demand initialization of asset data and registering it with
* the internal data registry.
*
* Note: core data will overwrite any externally registered data via the api.
*/
protected function initialize_core_data() {
/**
* Low level hook for registration of new data late in the cycle.
*
* Developers, do not use this hook as it is likely to be removed.
* Instead, use the data api:
* Automattic\WooCommerce\Blocks\Package::container()
* ->get( Automattic\WooCommerce\Blocks\Assets\AssetDataRegistry::class )
* ->add( $key, $value )
*/
$settings = apply_filters(
'woocommerce_shared_settings',
$this->data
);
// note this WILL wipe any data already registered to these keys because
// they are protected.
$this->data = array_replace_recursive( $settings, $this->get_core_data() );
}
/**
* Loops through each registered lazy data callback and adds the returned
* value to the data array.
*
* This method is executed right before preparing the data for printing to
* the rendered screen.
*
* @return void
*/
protected function execute_lazy_data() {
foreach ( $this->lazy_data as $key => $callback ) {
$this->data[ $key ] = $callback();
}
}
/**
* Exposes private registered data to child classes.
*
* @return array The registered data on the private data property
*/
protected function get() {
return $this->data;
}
/**
* Allows checking whether a key exists.
*
* @param string $key The key to check if exists.
* @return bool Whether the key exists in the current data registry.
*/
public function exists( $key ) {
return array_key_exists( $key, $this->data );
}
/**
* Interface for adding data to the registry.
*
* @param string $key The key used to reference the data being registered.
* You can only register data that is not already in the
* registry identified by the given key.
* @param mixed $data If not a function, registered to the registry as is.
* If a function, then the callback is invoked right
* before output to the screen.
*
* @throws InvalidArgumentException Only throws when site is in debug mode.
* Always logs the error.
*/
public function add( $key, $data ) {
try {
$this->add_data( $key, $data );
} catch ( Exception $e ) {
if ( $this->debug() ) {
// bubble up.
throw $e;
}
wc_caught_exception( $e, __METHOD__, [ $key, $data ] );
}
}
/**
* Callback for registering the data script via WordPress API.
*
* @return void
*/
public function register_data_script() {
$this->api->register_script(
$this->handle,
'build/wc-settings.js',
[],
false
);
}
/**
* Callback for enqueuing asset data via the WP api.
*
* Note: while this is hooked into print/admin_print_scripts, it still only
* happens if the script attached to `wc-settings` handle is enqueued. This
* is done to allow for any potentially expensive data generation to only
* happen for routes that need it.
*/
public function enqueue_asset_data() {
if ( wp_script_is( $this->handle, 'enqueued' ) ) {
$this->initialize_core_data();
$this->execute_lazy_data();
$data = rawurlencode( wp_json_encode( $this->data ) );
wp_add_inline_script(
$this->handle,
"var wcSettings = wcSettings || JSON.parse( decodeURIComponent( '"
. esc_js( $data )
. "' ) );",
'before'
);
}
}
/**
* See self::add() for docs.
*
* @param string $key Key for the data.
* @param mixed $data Value for the data.
*
* @throws InvalidArgumentException If key is not a string or already
* exists in internal data cache.
*/
protected function add_data( $key, $data ) {
if ( ! is_string( $key ) ) {
if ( $this->debug() ) {
throw new InvalidArgumentException(
'Key for the data being registered must be a string'
);
}
}
if ( isset( $this->data[ $key ] ) ) {
if ( $this->debug() ) {
throw new InvalidArgumentException(
'Overriding existing data with an already registered key is not allowed'
);
}
return;
}
if ( \is_callable( $data ) ) {
$this->lazy_data[ $key ] = $data;
return;
}
$this->data[ $key ] = $data;
}
/**
* Exposes whether the current site is in debug mode or not.
*
* @return boolean True means the site is in debug mode.
*/
protected function debug() {
return defined( 'WP_DEBUG' ) && WP_DEBUG;
}
}