Carbon_Fields\Container\Repository

Complexity

Total Complexity

19

Size/Duplication

Total Lines	163
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	1

Test Coverage

Coverage

39.34%

Importance

Changes

0

9 Methods

Rating	Name	Duplication	Size	Complexity
A	register_container()	0	5	1
A	initialize_containers()	0	9	2
A	get_containers()	0	17	4
A	get_field_in_containers()	0	17	4
A	get_active_containers()	0	5	1
A	get_unique_panel_id()	0	12	2
A	is_unique_panel_id()	0	3	1
A	register_unique_panel_id()	0	5	2
A	unregister_unique_panel_id()	0	5	2

<?php

namespace Carbon_Fields\Container;

use Carbon_Fields\Helper\Helper;
use Carbon_Fields\Exception\Incorrect_Syntax_Exception;

/**
 * Keeps track of all instantiated containers
 */
class Repository {
	/**
	 * List of registered unique panel identificator ids
	 *
	 * @see get_unique_panel_id()
	 * @see register_unique_panel_id()
	 * @see unregister_unique_panel_id()
	 * @var array
	 */
	protected $registered_panel_ids = array();

	/**
	 * List of registered containers that should be initialized
	 *
	 * @see initialize_containers()
	 * @var array
	 */
	protected $pending_containers = array();

	/**
	 * List of all containers
	 *
	 * @see _attach()
	 * @var array
	 */
	protected $containers = array();

	/**
	 * Register a container with the repository
	 *
	 * @return array
	 */
	public function register_container( Container $container ) {
		$this->register_unique_panel_id( $container->id );
		$this->containers[] = $container;
		$this->pending_containers[] = $container;
	}

	/**
	 * Initialize registered containers
	 *
	 * @return array
	 */
	public function initialize_containers() {
		$initialized_containers = array();
		while ( ( $container = array_shift( $this->pending_containers ) ) ) {
			$container->init();
			$initialized_containers[] = $container;
		}

		return $initialized_containers;
	}

	/**
	 * Return all containers
	 *
	 * @param string $type Container type to filter for
	 * @return array
	 */
	public function get_containers( $type = null ) {
		$raw_containers = $this->containers;
		$containers = array();

		if ( $type === null ) {
			$containers = $raw_containers;
		} else {
			$normalized_type = Helper::normalize_type( $type );
			foreach ( $raw_containers as $container ) {
				if ( $container->type === $normalized_type ) {
					$containers[] = $container;
				}
			}
		}

		return $containers;
	}

	/**
	 * Return field in containers
	 *
	 * @param string $field_name
	 * @param string $container_type Container type to filter for
	 * @param bool $include_nested_fields Search in nested fields as well
	 * @return Carbon_Fields\Field\Field
	 */
	public function get_field_in_containers( $field_name, $container_type = null, $include_nested_fields = true ) {
		$containers = $this->get_containers( $container_type );
		$field = null;

		foreach ( $containers as $container ) {
			if ( $include_nested_fields ) {
				$field = $container->get_field_by_name( $field_name );
			} else {
				$field = $container->get_root_field_by_name( $field_name );
			}
			if ( $field ) {
				break;
			}
		}

		return $field;
	}

	/**
	 * Return all currently active containers
	 *
	 * @return array
	 */
	public function get_active_containers() {
		return array_filter( $this->containers, function( $container ) {
			return $container->active();
		} );
	}

	/**
	 * Generate a unique container identificator id based on container title
	 * 
	 * @param string $title
	 */
	public function get_unique_panel_id( $title ) {
		$id = preg_replace( '~[^\w\-]*~', '', remove_accents( $title ) );
		$base = $id;
		$suffix = 0;

		while ( ! $this->is_unique_panel_id( $id ) ) {
			$suffix++;
			$id = $base . strval( $suffix );
		}

		return $id;
	}

	/**
	 * Check if container identificator id is unique
	 * 
	 * @param string $id
	 */
	protected function is_unique_panel_id( $id ) {
		return ! in_array( $id, $this->registered_panel_ids );
	}

	/**
	 * Add container identificator id to the list of unique container ids
	 *
	 * @param string $id
	 */
	protected function register_unique_panel_id( $id ) {
		if ( $this->is_unique_panel_id( $id ) ) {
			$this->registered_panel_ids[] = $id;
		}
	}

	/**
	 * Remove container identificator id from the list of unique container ids
	 *
	 * @param string $id
	 */
	protected function unregister_unique_panel_id( $id ) {
		if ( ! $this->is_unique_panel_id( $id ) ) {
			unset( $this->registered_panel_ids[ array_search( $id, $this->registered_panel_ids ) ] );
		}
	}
}