julienmonnerie/kirby/src/Cms/Items.php

<?php

namespace Kirby\Cms;

use Closure;
use Exception;

/**
 * A collection of items
 * @since 3.5.0
 *
 * @package   Kirby Cms
 * @author    Bastian Allgeier <bastian@getkirby.com>
 * @link      https://getkirby.com
 * @copyright Bastian Allgeier
 * @license   https://getkirby.com/license
 */
class Items extends Collection
{
	public const ITEM_CLASS = Item::class;

	protected Field|null $field;

	/**
	 * @var array
	 */
	protected $options;

	/**
	 * @var \Kirby\Cms\ModelWithContent
	 */
	protected $parent;

	/**
	 * Constructor
	 *
	 * @param array $objects
	 * @param array $options
	 */
	public function __construct($objects = [], array $options = [])
	{
		$this->options = $options;
		$this->parent  = $options['parent'] ?? App::instance()->site();
		$this->field   = $options['field']  ?? null;

		parent::__construct($objects, $this->parent);
	}

	/**
	 * Creates a new item collection from a
	 * an array of item props
	 *
	 * @param array $items
	 * @param array $params
	 * @return \Kirby\Cms\Items
	 */
	public static function factory(array $items = null, array $params = [])
	{
		$options = array_merge([
			'field'   => null,
			'options' => [],
			'parent'  => App::instance()->site(),
		], $params);

		if (empty($items) === true || is_array($items) === false) {
			return new static();
		}

		if (is_array($options) === false) {
			throw new Exception('Invalid item options');
		}

		// create a new collection of blocks
		$collection = new static([], $options);

		foreach ($items as $params) {
			if (is_array($params) === false) {
				continue;
			}

			$params['field']    = $options['field'];
			$params['options']  = $options['options'];
			$params['parent']   = $options['parent'];
			$params['siblings'] = $collection;
			$class = static::ITEM_CLASS;
			$item  = $class::factory($params);
			$collection->append($item->id(), $item);
		}

		return $collection;
	}

	/**
	 * Returns the parent field if known
	 */
	public function field(): Field|null
	{
		return $this->field;
	}

	/**
	 * Convert the items to an array
	 *
	 * @return array
	 */
	public function toArray(Closure $map = null): array
	{
		return array_values(parent::toArray($map));
	}
}