class.ilMMItemRepository.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
use ILIAS\Cache\Container\Container;
use ILIAS\GlobalScreen\Scope\MainMenu\Collector\Information\TypeInformation;
use ILIAS\GlobalScreen\Identification\IdentificationInterface;
use ILIAS\GlobalScreen\Identification\NullIdentification;
use ILIAS\GlobalScreen\Identification\NullPluginIdentification;
use ILIAS\GlobalScreen\Scope\MainMenu\Collector\Handler\TypeHandler;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\isItem;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\TopItem\TopLinkItem;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\TopItem\TopParentItem;
use ILIAS\MainMenu\Provider\CustomMainBarProvider;
use ILIAS\GlobalScreen\Services;
use ILIAS\GlobalScreen\Scope\MainMenu\Collector\MainMenuMainCollector;
use ILIAS\Cache\Container\Request;
 
class ilMMItemRepository implements Request
{
    private ilDBInterface $db;
 
    private Services $services;
 
    private MainMenuMainCollector $main_collector;
 
    private Container $cache;
 
    public function __construct()
    {
        global $DIC;
        $this->cache = $DIC->globalCache()->get($this);
        $this->db = $DIC->database();
        $this->main_collector = $DIC->globalScreen()->collector()->mainmenu();
        $this->main_collector->collectOnce();
        $this->services = $DIC->globalScreen();
 
        foreach ($this->main_collector->getRawUnfilteredItems() as $top_item) {
            ilMMItemStorage::register($top_item);
        }
    }
 
    public function getContainerKey(): string
    {
        return 'mm_items';
    }
 
    public function isForced(): bool
    {
        return false;
    }
 
    public function clearCache(): void
    {
        $this->cache->flush();
    }
 
    public function getSingleItem(IdentificationInterface $identification): isItem
    {
        return $this->main_collector->getSingleItemFromRaw($identification);
    }
 
    public function getSingleItemFromFilter(IdentificationInterface $identification): isItem
    {
        return $this->main_collector->getSingleItemFromFilter($identification);
    }
 
    public function resolveIdentificationFromString(string $identification_string): IdentificationInterface
    {
        return $this->services->identification()->fromSerializedIdentification($identification_string);
    }
 
    public function repository(): ilMMItemRepository
    {
        return $this;
    }
 
    public function getTopItems(): array
    {
        return ilMMItemStorage::where(" parent_identification = '' OR parent_identification IS NULL ")->orderBy(
            'position'
        )->getArray();
    }
 
    public function getLostItems(): array
    {
        $q = "SELECT sub_items.* " .
            "FROM il_mm_items AS sub_items " .
            "LEFT JOIN il_mm_items AS top_items ON top_items.identification = sub_items.parent_identification " .
            "WHERE sub_items.parent_identification != '' AND sub_items.parent_identification IS NOT NULL " .
            "AND (top_items.identification IS NULL OR top_items.identification = '') " .
            "ORDER BY top_items.position, parent_identification, sub_items.position ASC";
 
        $r = $this->db->query($q);
        $return = [];
        while ($data = $this->db->fetchAssoc($r)) {
            $return[] = $data;
        }
 
        return $return;
    }
 
 
    public function getSubItemsForTable(?ilMMItemFacadeInterface $parent = null): array
    {
        if ($parent !== null) {
            $r = $this->db->queryF(
                "SELECT sub_items.*, top_items.position AS parent_position
FROM il_mm_items AS sub_items
LEFT JOIN il_mm_items AS top_items ON top_items.identification = sub_items.parent_identification
WHERE sub_items.parent_identification != '' AND sub_items.parent_identification = %s 
ORDER BY top_items.position, parent_identification, sub_items.position ASC",
                ['text'],
                [$parent->identification()->serialize()]
            );
        } else {
            $r = $this->db->query(
                "SELECT sub_items.*, top_items.position AS parent_position
FROM il_mm_items AS sub_items
LEFT JOIN il_mm_items AS top_items ON top_items.identification = sub_items.parent_identification
WHERE sub_items.parent_identification != ''  
ORDER BY top_items.position, parent_identification, sub_items.position ASC",
            );
        }
        $return = [];
        while ($data = $this->db->fetchAssoc($r)) {
            $return[] = $data;
        }
 
        return $return;
    }
 
    public function flushLostItems(): void
    {
        foreach ($this->getLostItems() as $item) {
            $item_facade = $this->getItemFacade(
                $this->services->identification()->fromSerializedIdentification($item['identification'])
            );
            $item_facade->delete();
        }
    }
 
    public function hasLostItems(): bool
    {
        return count($this->getLostItems()) > 0;
    }
 
    public function getItemFacade(?IdentificationInterface $identification = null): ilMMItemFacadeInterface
    {
        if ($identification === null || $identification instanceof NullIdentification || $identification instanceof NullPluginIdentification) {
            return new ilMMNullItemFacade($identification ?: new NullIdentification(), $this->main_collector);
        }
        if ($identification->getClassName() === CustomMainBarProvider::class) {
            return new ilMMCustomItemFacade($identification, $this->main_collector);
        }
 
        return new ilMMItemFacade($identification, $this->main_collector);
    }
 
    public function getItemFacadesForIdentificationStrings(array $identifications): array
    {
        $item_facades = [];
        foreach ($identifications as $identification) {
            $id = $this->services->identification()->fromSerializedIdentification($identification);
            $item_facades[] = $this->getItemFacade($id);
        }
 
        return $item_facades;
    }
 
    public function getItemFacadeForIdentificationString(string $identification): ilMMItemFacadeInterface
    {
        $id = $this->services->identification()->fromSerializedIdentification($identification);
 
        return $this->getItemFacade($id);
    }
 
    public function getPossibleParentsForFormAndTable(): array
    {
        static $parents;
        if ($parents === null) {
            $parents = [];
            foreach (array_keys($this->getTopItems()) as $top_item_identification) {
                $identification = $this->services->identification()->fromSerializedIdentification(
                    $top_item_identification
                );
                $item = $this->getSingleItem($identification);
                if ($item instanceof TopParentItem) {
                    $parents[$top_item_identification] = $this->getItemFacade($identification)
                                                              ->getDefaultTitle();
                }
            }
        }
 
        return $parents;
    }
 
    public function getPossibleSubItemTypesWithInformation(): array
    {
        $types = [];
        foreach ($this->main_collector->getTypeInformationCollection()->getAll() as $information) {
            if ($information->isCreationPrevented()) {
                continue;
            }
            if ($information->isChild()) {
                // since these two types are identical (more or less), we truncate one
                if ($information->getType() === TopLinkItem::class) {
                    continue;
                }
                $types[$information->getType()] = $information;
            }
        }
 
        return $types;
    }
 
    public function getPossibleTopItemTypesWithInformation(bool $new): array
    {
        $types = [];
        foreach ($this->main_collector->getTypeInformationCollection()->getAll() as $information) {
            if (!$new || $information->isTop()) {
                $types[$information->getType()] = $information;
            }
        }
 
        return $types;
    }
 
    public function getTypeHandlerForType(string $type): TypeHandler
    {
        $item = $this->services->mainBar()->custom($type, new NullIdentification());
 
        return $this->main_collector->getTypeHandlerForItem($item);
    }
 
    public function updateItem(ilMMItemFacadeInterface $item_facade): void
    {
        if ($item_facade->isEditable()) {
            $item_facade->update();
            $this->clearCache();
        }
    }
 
    public function createItem(ilMMItemFacadeInterface $item_facade): void
    {
        $item_facade->create();
        $this->clearCache();
    }
 
    public function deleteItem(ilMMItemFacadeInterface $item_facade): void
    {
        if ($item_facade->isDeletable()) {
            $item_facade->delete();
            $this->clearCache();
        }
    }
}