<?php
/**
 * Cherry X framework loader class.
 *
 * How to use:
 *
 * 1. Copy and include this class into your theme/plugin
 * 2. Add unique prefix for the class name, e.g. - Twentyseventeen_Jet_Engine_CX_Loader
 * 3. Initialize loader on after_setup_theme hook with priority -20, Example:
 *
 * add_action( 'after_setup_theme', 'twentyseventeen_framework_loader', -20 );
 * function twentyseventeen_framework_loader() {
 *     require get_theme_file_path( 'framework/loader.php' );
 *     new Twentyseventeen_Jet_Engine_CX_Loader(
 *         [
 *             get_theme_file_path( 'framework/modules/module-1/module-1.php' ),
 *             get_theme_file_path( 'framework/modules/module-2/module-2.php' ),
 *             get_theme_file_path( 'framework/modules/module-3/module-3.php' ),
 *         ]
 *     );
 * }
 *
 * Notes:
 *
 * 1. This class only select latest version of each module from all Cherry X frameworks loaded in current environment
 * 2. You should manually initialize selected modules later, when them will be needed you, but not eralier than
 * after_setup_theme hook with priority 0.
 */

namespace JET_ABAF\Framework;

defined( 'ABSPATH' ) || exit; // Exit if accessed directly

class Loader {

	/**
	 * Key for object cache where are stored information about all modules in current environment.
	 *
	 * @var string
	 */
	private $key = 'cherry_x_modules';

	/**
	 * Holder for modules list of current loader instance.
	 *
	 * @var array
	 */
	private $modules = [];

	/**
	 * Holder for modules slugs list of current loader instance.
	 *
	 * @var array
	 */
	private $modules_slugs = [];

	/**
	 * Included modules paths and URLs
	 *
	 * @var array
	 */
	private $included_modules = [];

	/**
	 * Loads latest versions of all modules passed into modules array
	 *
	 * @param array $modules List of loaded modules. Format:
	 *                       [
	 *                          get_theme_file_path( 'framework/modules/module-1/module-1.php' ),
	 *                          get_theme_file_path( 'framework/modules/module-2/module-2.php' ),
	 *                          get_theme_file_path( 'framework/modules/module-3/module-3.php' ),
	 *                       ]
	 */
	public function __construct( array $modules = [] ) {

		$this->modules = $modules;

		add_action( 'after_setup_theme', [ $this, 'store_versions' ], - 10 );
		add_action( 'after_setup_theme', [ $this, 'include_modules' ], - 1 );

	}

	/**
	 * Store version.
	 *
	 * Store versions for modules passed in current instance into global modules versions list.
	 *
	 * @since 3.2.0
	 */
	public function store_versions() {
		foreach ( $this->modules as $module ) {
			$this->store_module_version( $module );
		}
	}

	/**
	 * Include module.
	 *
	 * Include latest versions of modules in current loader instance.
	 * All available version previously stored by 'store_versions' methods of each loader instance.
	 *
	 * @since 3.2.0
	 *
	 * @return boolean
	 */
	public function include_modules() {

		$modules_data = wp_cache_get( $this->key );

		foreach ( $this->modules_slugs as $slug ) {
			if ( empty( $modules_data[ $slug ] ) ) {
				continue;
			}

			$path = $this->get_latest_version_path( $modules_data[ $slug ] );

			if ( file_exists( $path ) ) {
				$dir           = pathinfo( $path, PATHINFO_DIRNAME );
				$normalize_dir = wp_normalize_path( $dir );
				$plugin_dir    = wp_normalize_path( WP_PLUGIN_DIR );

				if ( 0 === strpos( $normalize_dir, $plugin_dir ) ) {
					$url = str_replace(
						'\\',
						'/',
						str_replace( $plugin_dir, plugins_url(), $normalize_dir )
					);
				} else {
					$url = str_replace(
						'\\',
						'/',
						str_replace( wp_normalize_path( WP_CONTENT_DIR ), content_url(), $normalize_dir )
					);
				}

				$this->included_modules[ $slug ] = [
					'path' => trailingslashit( $dir ),
					'url'  => apply_filters( 'cx_include_module_url', trailingslashit( $url ), $path ),
				];

				require_once $path;
			}
		}

		return true;

	}

	/**
	 * Get included module data.
	 *
	 * Retrieve path and URL of included module directory.
	 *
	 * @since 3.2.0
	 *
	 * @param string $file Module base file.
	 *
	 * @return false|mixed
	 */
	public function get_included_module_data( $file ) {
		return $this->included_modules[ $file ] ?? false;
	}

	/**
	 * Get latest version path.
	 *
	 * Select latest version path from all available.
	 *
	 * @since 3.2.0
	 *
	 * @param array $module_versions All available versions paths for selected module.
	 *
	 * @return string Module path.
	 */
	private function get_latest_version_path( array $module_versions = [] ) {

		// Immediately return path if array contain sinle element.
		if ( 1 === count( $module_versions ) ) {
			$module_versions = array_values( $module_versions );

			return $module_versions[0];
		}

		// Sort array by version and return highest
		uksort( $module_versions, 'version_compare' );

		return end( $module_versions );

	}

	/**
	 * Store module version.
	 *
	 * Store passed module version and path into global modules data.
	 *
	 * @since 3.2.0
	 *
	 * @param string $module_path Module path.
	 *
	 * @return boolean
	 */
	private function store_module_version( $module_path = null ) {

		$slug         = basename( $module_path );
		$modules_data = wp_cache_get( $this->key );
		$modules_data = ! empty( $modules_data ) ? $modules_data : [];

		if ( empty( $modules_data[ $slug ] ) ) {
			$modules_data[ $slug ] = [];
		}

		$filedata = get_file_data( $module_path, [
			'version' => 'Version',
		] );

		if ( empty( $filedata['version'] ) ) {
			// If version not passed in file header, so module defined not correctly and not be included
			return false;
		}

		$current_version = $filedata['version'];

		if ( empty( $modules_data[ $slug ][ $current_version ] ) ) {
			$modules_data[ $slug ][ $current_version ] = $module_path;
		}

		$this->modules_slugs[] = $slug;

		wp_cache_set( $this->key, $modules_data, '', 1 );

		return true;

	}

}

• [D] db-updater
• [D] jet-dashboard
• [D] macros
• [D] vue-ui
• [F] loader.php
  Delete