class.ilMMAbstractItemFacade.php

Go to the documentation of this file.

<?php
 
use ILIAS\GlobalScreen\Identification\NullIdentification;
use ILIAS\GlobalScreen\Scope\MainMenu\Collector\MainMenuMainCollector as Main;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\hasSymbol;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\isChild;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\isInterchangeableItem;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\isItem;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\isTopItem;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\Item\Complex;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\Item\LinkList;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\Item\Lost;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\Item\RepositoryLink;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\Item\Separator;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\TopItem\TopLinkItem;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\TopItem\TopParentItem;
use ILIAS\UI\Component\Link\Link;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\isParent;
 
abstract class ilMMAbstractItemFacade implements ilMMItemFacadeInterface
{
    protected $role_based_visibility = false;
    protected $global_role_ids = [];
    protected $type_information;
    protected $mm_item;
    protected $raw_item;
    protected $filtered_item;
    protected $identification;
    protected $default_title = "-";
 
    public function __construct(
        \ILIAS\GlobalScreen\Identification\IdentificationInterface $identification,
        Main $collector
    ) {
        $this->identification = $identification;
        $this->raw_item = $collector->getSingleItemFromRaw($identification);
        $this->filtered_item          = $collector->getSingleItemFromFilter($identification);
        $this->type_information = $collector->getTypeInformationCollection()->get(get_class($this->raw_item));
        $this->mm_item = ilMMItemStorage::register($this->raw_item);
    }
 
    public function getId() : string
    {
        return $this->identification->serialize();
    }
 
    public function hasStorage() : bool
    {
        return ilMMItemStorage::find($this->getId()) !== null;
    }
 
    public function supportsRoleBasedVisibility() : bool
    {
        return false;
    }
 
    public function hasRoleBasedVisibility() : bool
    {
        return $this->role_based_visibility;
    }
 
    public function setRoleBasedVisibility(bool $role_based_visibility) : void
    {
        $this->role_based_visibility = $role_based_visibility;
    }
 
    public function getGlobalRoleIDs() : array
    {
        return $this->global_role_ids;
    }
 
    public function setGlobalRoleIDs(array $global_role_ids) : void
    {
        $this->global_role_ids = $global_role_ids;
    }
 
    public function isEmpty() : bool
    {
        return $this->mm_item->getIdentification() == '';
    }
 
    public function itemStorage() : ilMMItemStorage
    {
        return $this->mm_item;
    }
 
    public function identification() : \ILIAS\GlobalScreen\Identification\IdentificationInterface
    {
        return $this->identification;
    }
 
    
    public function getRawItem() : isItem
    {
        return $this->raw_item;
    }
    public function getFilteredItem() : isItem
    {
        return $this->filtered_item;
    }
 
    public function getAmountOfChildren() : int
    {
        if ($this->filtered_item instanceof isParent) {
            return count($this->filtered_item->getChildren());
        }
 
        return 0;
    }
 
    public function isAvailable() : bool
    {
        return (bool) ($this->filtered_item->isAvailable() || $this->filtered_item->isAlwaysAvailable());
    }
 
    public function isActivated() : bool
    {
        return (bool) ($this->mm_item->isActive() && $this->getRawItem()->isAvailable()) || $this->getRawItem()->isAlwaysAvailable();
    }
 
    public function isAlwaysAvailable() : bool
    {
        return $this->getRawItem()->isAlwaysAvailable();
    }
 
    public function getProviderNameForPresentation() : string
    {
        return $this->identification->getProviderNameForPresentation();
    }
 
    public function getDefaultTitle() : string
    {
        $default_translation = ilMMItemTranslationStorage::getDefaultTranslation($this->identification);
        if ($default_translation !== "") {
            return $default_translation;
        }
        if ($this->default_title == "-" && $this->raw_item instanceof \ILIAS\GlobalScreen\Scope\MainMenu\Factory\hasTitle) {
            $this->default_title = $this->raw_item->getTitle();
        }
 
        return $this->default_title;
    }
 
    public function setDefaultTitle(string $default_title)
    {
        $this->default_title = $default_title;
    }
 
    public function getStatus() : string
    {
        global $DIC;
        if (!$this->raw_item->isAvailable() || $this->raw_item->isAlwaysAvailable()) {
            return $DIC->ui()->renderer()->render($this->raw_item->getNonAvailableReason());
        }
 
        return "";
    }
 
    public function getTypeForPresentation() : string
    {
        return $this->type_information->getTypeNameForPresentation();
    }
 
    public function getParentIdentificationString() : string
    {
        if ($this->raw_item instanceof isChild) {
            $provider_name_for_presentation = $this->raw_item->getParent()->serialize();
            
            $storage_parent = $this->mm_item->getParentIdentification();
            if ($storage_parent !== $provider_name_for_presentation) {
                return $storage_parent;
            }
 
            return $provider_name_for_presentation;
        }
 
        return "";
    }
 
    public function isCustomType() : bool
    {
        $known_core_types = [
            Complex::class,
            Link::class,
            LinkList::class,
            Lost::class,
            RepositoryLink::class,
            Separator::class,
            TopLinkItem::class,
            TopParentItem::class,
        ];
        foreach ($known_core_types as $known_core_type) {
            if (get_class($this->raw_item) === $known_core_type) {
                return false;
            }
        }
 
        return true;
    }
 
    public function isTopItem() : bool
    {
        return $this->raw_item instanceof isTopItem;
    }
 
    public function isChild() : bool
    {
        return $this->getRawItem() instanceof isChild;
    }
 
    public function isInLostItem() : bool
    {
        if ($this->raw_item instanceof isChild) {
            return $this->raw_item->getParent() instanceof NullIdentification;
        }
 
        return false;
    }
 
    public function setIsTopItm(bool $top_item)
    {
        // TODO: Implement setIsTopItm() method.
    }
 
    public function isInterchangeable() : bool
    {
        return false;
    }
 
    public function getType() : string
    {
        return $this->type_information->getType();
    }
 
    public function setParent(string $parent)
    {
        $this->mm_item->setParentIdentification($parent);
    }
 
    public function setPosition(int $position)
    {
        $this->mm_item->setPosition($position);
    }
 
    public function setActiveStatus(bool $status)
    {
        $this->mm_item->setActive($status);
    }
 
    public function supportsCustomIcon() : bool
    {
        return $this->raw_item instanceof hasSymbol;
    }
 
    public function getIconID() : ?string
    {
        return $this->mm_item->getIconId();
    }
 
    public function setIconID(string $icon_id)
    {
        $this->mm_item->setIconId($icon_id);
    }
 
    // CRUD
 
    public function update()
    {
        ilMMItemTranslationStorage::storeDefaultTranslation($this->identification, $this->default_title);
        $this->mm_item->update();
    }
 
    public function create()
    {
        ilMMItemTranslationStorage::storeDefaultTranslation($this->identification, $this->default_title);
        $this->mm_item->create();
        ilMMItemStorage::register($this->raw_item);
    }
 
    protected function deleteAssociatedTranslations()
    {
        $ts = ilMMItemTranslationStorage::where([
            'identification' => $this->identification->serialize(),
        ], '=')->get();
 
        if (!empty($ts)) {
            foreach ($ts as $translation) {
                if ($translation instanceof ilMMItemTranslationStorage) {
                    $translation->delete();
                }
            }
        }
    }
 
    public function delete()
    {
        if ($this->isDeletable()) {
            $this->deleteAssociatedTranslations();
            $serialize = $this->identification->serialize();
            $mm = ilMMItemStorage::find($serialize);
            if ($mm instanceof ilMMItemStorage) {
                $mm->delete();
            }
        }
    }
}