ORIENT/modules/cms/classes/CmsObjectCollection.php

127 lines
3.8 KiB
PHP

<?php namespace Cms\Classes;
use ApplicationException;
use October\Rain\Support\Collection as CollectionBase;
/**
* This class represents a collection of Cms Objects.
*
* @package october\cms
* @author Alexey Bobkov, Samuel Georges
*/
class CmsObjectCollection extends CollectionBase
{
/**
* Returns objects that use the supplied component.
* @param string|array $components
* @param null|callback $callback
* @return static
*/
public function withComponent($components, $callback = null)
{
return $this->filter(function ($object) use ($components, $callback) {
$hasComponent = false;
foreach ((array) $components as $componentName) {
if (!$callback && $object->hasComponent($componentName)) {
$hasComponent = true;
}
if ($callback && ($component = $object->getComponent($componentName))) {
$hasComponent = call_user_func($callback, $component) ?: $hasComponent;
}
}
return $hasComponent;
});
}
/**
* Returns objects whose properties match the supplied value.
*
* This is a wrapper for our custom `applyWhereFilter` method, as the signature of this method changed in Laravel 6.
*
* @param string $key
* @param mixed $operator
* @param mixed $value
* @return static
*/
public function where($key, $operator = null, $value = null)
{
if (empty($operator) || !is_string($operator)) {
throw new ApplicationException('You must provide a string value to compare with when executing a "where" '
. 'query for CMS object collections.');
}
if (!isset($value) || !is_bool($value)) {
$value = true;
}
return $this->applyWhereFilter($key, $operator, $value);
}
/**
* Returns objects whose properties match the supplied value.
* @param string $property
* @param string $value
* @param bool $strict
* @return static
*/
protected function applyWhereFilter($property, $value, $strict = true)
{
return $this->filter(function ($object) use ($property, $value, $strict) {
if (!array_key_exists($property, $object->settings)) {
return false;
}
return $strict
? $object->settings[$property] === $value
: $object->settings[$property] == $value;
});
}
/**
* Returns objects whose component properties match the supplied value.
* @param mixed $components
* @param string $property
* @param string $value
* @param bool $strict
* @return static
*/
public function whereComponent($components, $property, $value, $strict = false)
{
return $this->filter(function ($object) use ($components, $property, $value, $strict) {
$hasComponent = false;
foreach ((array) $components as $componentName) {
if (!$componentAlias = $object->hasComponent($componentName)) {
continue;
}
$componentSettings = array_get($object->settings, 'components', []);
if (!array_key_exists($componentAlias, $componentSettings)) {
continue;
}
$settings = $componentSettings[$componentAlias];
if (!array_key_exists($property, $settings)) {
continue;
}
if (
($strict && $settings[$property] === $value) ||
(!$strict && $settings[$property] == $value)
) {
$hasComponent = true;
}
}
return $hasComponent;
});
}
}