122 lines
3.4 KiB
PHP
122 lines
3.4 KiB
PHP
<?php
|
|
/**
|
|
* Loads WooCommece packages from the /packages directory. These are packages developed outside of core.
|
|
*
|
|
* @package Automattic/WooCommerce
|
|
*/
|
|
|
|
namespace Automattic\WooCommerce;
|
|
|
|
defined( 'ABSPATH' ) || exit;
|
|
|
|
/**
|
|
* Packages class.
|
|
*
|
|
* @since 3.7.0
|
|
*/
|
|
class Packages {
|
|
|
|
/**
|
|
* Static-only class.
|
|
*/
|
|
private function __construct() {}
|
|
|
|
/**
|
|
* Array of package names and their main package classes.
|
|
*
|
|
* @var array Key is the package name/directory, value is the main package class which handles init.
|
|
*/
|
|
protected static $packages = array(
|
|
'woocommerce-blocks' => '\\Automattic\\WooCommerce\\Blocks\\Package',
|
|
'woocommerce-rest-api' => '\\Automattic\\WooCommerce\\RestApi\\Package',
|
|
'woocommerce-admin' => '\\Automattic\\WooCommerce\\Admin\\Composer\\Package',
|
|
);
|
|
|
|
/**
|
|
* Init the package loader.
|
|
*
|
|
* @since 3.7.0
|
|
*/
|
|
public static function init() {
|
|
add_action( 'plugins_loaded', array( __CLASS__, 'on_init' ) );
|
|
}
|
|
|
|
/**
|
|
* Callback for WordPress init hook.
|
|
*/
|
|
public static function on_init() {
|
|
self::load_packages();
|
|
}
|
|
|
|
/**
|
|
* Checks a package exists by looking for it's directory.
|
|
*
|
|
* @param string $package Package name.
|
|
* @return boolean
|
|
*/
|
|
public static function package_exists( $package ) {
|
|
return file_exists( dirname( __DIR__ ) . '/packages/' . $package );
|
|
}
|
|
|
|
/**
|
|
* Loads packages after plugins_loaded hook.
|
|
*
|
|
* Each package should include an init file which loads the package so it can be used by core.
|
|
*/
|
|
protected static function load_packages() {
|
|
foreach ( self::$packages as $package_name => $package_class ) {
|
|
if ( ! self::package_exists( $package_name ) ) {
|
|
self::missing_package( $package_name );
|
|
continue;
|
|
}
|
|
call_user_func( array( $package_class, 'init' ) );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* If a package is missing, add an admin notice.
|
|
*
|
|
* @param string $package Package name.
|
|
*/
|
|
protected static function missing_package( $package ) {
|
|
if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
|
|
error_log( // phpcs:ignore
|
|
sprintf(
|
|
/* Translators: %s package name. */
|
|
esc_html__( 'Missing the WooCommerce %s package', 'woocommerce' ),
|
|
'<code>' . esc_html( $package ) . '</code>'
|
|
) . ' - ' . esc_html__( 'Your installation of WooCommerce is incomplete. If you installed WooCommerce from GitHub, please refer to this document to set up your development environment: https://github.com/woocommerce/woocommerce/wiki/How-to-set-up-WooCommerce-development-environment', 'woocommerce' )
|
|
);
|
|
}
|
|
add_action(
|
|
'admin_notices',
|
|
function() use ( $package ) {
|
|
?>
|
|
<div class="notice notice-error">
|
|
<p>
|
|
<strong>
|
|
<?php
|
|
printf(
|
|
/* Translators: %s package name. */
|
|
esc_html__( 'Missing the WooCommerce %s package', 'woocommerce' ),
|
|
'<code>' . esc_html( $package ) . '</code>'
|
|
);
|
|
?>
|
|
</strong>
|
|
<br>
|
|
<?php
|
|
printf(
|
|
/* translators: 1: is a link to a support document. 2: closing link */
|
|
esc_html__( 'Your installation of WooCommerce is incomplete. If you installed WooCommerce from GitHub, %1$splease refer to this document%2$s to set up your development environment.', 'woocommerce' ),
|
|
'<a href="' . esc_url( 'https://github.com/woocommerce/woocommerce/wiki/How-to-set-up-WooCommerce-development-environment' ) . '" target="_blank" rel="noopener noreferrer">',
|
|
'</a>'
|
|
);
|
|
?>
|
|
</p>
|
|
</div>
|
|
<?php
|
|
}
|
|
);
|
|
}
|
|
}
|