beans_load_api_components

Load Beans API components.

This function loads Beans API components. Components are only loaded once, even if they are called many times. Admin components/functions are automatically wrapped in an is_admin() check.

Return: (bool) Will always return true.

Parameters

Source

function beans_load_api_components( $components ) {

	static $loaded = array();

	$root = BEANS_API_PATH;

	$common = array(
		'html'         => array(
			$root . 'html/functions.php',
			$root . 'html/class.php',
		),
		'actions'      => $root . 'actions/functions.php',
		'filters'      => $root . 'filters/functions.php',
		'wp-customize' => $root . 'wp-customize/functions.php',
		'post-meta'    => $root . 'post-meta/functions.php',
		'term-meta'    => $root . 'term-meta/functions.php',
		'fields'       => $root . 'fields/functions.php',
		'image'        => $root . 'image/functions.php',
		'compiler'     => array(
			$root . 'compiler/functions.php',
			$root . 'compiler/class-compiler.php',
			$root . 'compiler/class-page-compiler.php',
		),
		'uikit'        => array(
			$root . 'uikit/functions.php',
			$root . 'uikit/class.php',
		),
		'layout'       => $root . 'layout/functions.php',
		'template'     => $root . 'template/functions.php',
		'widget'       => $root . 'widget/functions.php',
	);

	// Only load admin fragments if is_admin() is true.
	if ( is_admin() ) {
		$admin = array(
			'options'     => $root . 'options/functions.php',
			'post-meta'   => $root . 'post-meta/functions-admin.php',
			'term-meta'   => $root . 'term-meta/functions-admin.php',
			'compiler'    => $root . 'compiler/class-options.php',
			'image'       => $root . 'image/class-options.php',
			'_admin_menu' => $root . 'admin-menu.php', // Internal use.
		);
	} else {
		$admin = array();
	}

	// Set dependencies.
	$dependencies = array(
		'html'         => array(
			'_admin_menu',
			'filters',
		),
		'fields'       => array(
			'actions',
			'html',
		),
		'options'      => 'fields',
		'post-meta'    => 'fields',
		'term-meta'    => 'fields',
		'wp-customize' => 'fields',
		'layout'       => 'fields',
		'image'        => '_admin_menu',
		'compiler'     => '_admin_menu',
		'uikit'        => 'compiler',
		'_admin_menu'  => 'options',
	);

	foreach ( (array) $components as $component ) {

		// Stop here if the component is already loaded or doesn't exists.
		if ( in_array( $component, $loaded ) || ( ! isset( $common[ $component ] ) && ! isset( $admin[ $component ] ) ) ) {
			continue;
		}

		// Cache loaded component before calling dependencies.
		$loaded[] = $component;

		// Load dependencies.
		if ( array_key_exists( $component, $dependencies ) ) {
			beans_load_api_components( $dependencies[ $component ] );
		}

		$_components = array();

		// Add common components.
		if ( isset( $common[ $component ] ) ) {
			$_components = (array) $common[ $component ];
		}

		// Add admin components.
		if ( isset( $admin[ $component ] ) ) {
			$_components = array_merge( (array) $_components, (array) $admin[ $component ] );
		}

		// Load components.
		foreach ( $_components as $component_path  ) {
			require_once( $component_path );
		}

		/**
		 * Fires when an API component is loaded.
		 *
		 * The dynamic portion of the hook name, $component, refers to the name of the API component loaded.
		 *
		 * @since 1.0.0
		 */
		do_action( 'beans_loaded_api_component_' . $component );

	}

	return true;

}