CustomMainBarProvider.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
namespace ILIAS\MainMenu\Provider;
 
use ILIAS\DI\Container;
use ILIAS\GlobalScreen\Scope\MainMenu\Collector\Information\TypeInformation;
use ILIAS\GlobalScreen\Scope\MainMenu\Collector\Information\TypeInformationCollection;
use ILIAS\GlobalScreen\Scope\MainMenu\Collector\Renderer\ComplexItemRenderer;
use ILIAS\GlobalScreen\Scope\MainMenu\Collector\Renderer\LinkListItemRenderer;
use ILIAS\GlobalScreen\Scope\MainMenu\Collector\Renderer\LostItemRenderer;
use ILIAS\GlobalScreen\Scope\MainMenu\Collector\Renderer\SeparatorItemRenderer;
use ILIAS\GlobalScreen\Scope\MainMenu\Collector\Renderer\TopParentItemRenderer;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\hasAction;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\hasTitle;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\isChild;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\isItem;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\Item\Complex;
use ILIAS\GlobalScreen\Scope\MainMenu\Factory\Item\Link;
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\GlobalScreen\Scope\MainMenu\Provider\AbstractStaticMainMenuProvider;
use ILIAS\GlobalScreen\Scope\MainMenu\Provider\StaticMainMenuProvider;
use ilMMCustomItemStorage;
use ilMMItemStorage;
use ilMMTypeHandlerLink;
use ilMMTypeHandlerRepositoryLink;
use ilMMTypeHandlerSeparator;
use ilMMTypeHandlerTopLink;
use ilObjMainMenuAccess;
use ilMMTopLinkItemRenderer;
use ilMMLinkItemRenderer;
use ilMMRepositoryLinkItemRenderer;
 
class CustomMainBarProvider extends AbstractStaticMainMenuProvider implements StaticMainMenuProvider
{
    private \ilMainMenuAccess $mm_access;
    protected Container $dic;
 
    public function __construct(Container $dic, ?\ilMainMenuAccess $access = null)
    {
        parent::__construct($dic);
        $this->mm_access = $access ?? new ilObjMainMenuAccess();
    }
 
    public function getStaticTopItems(): array
    {
        $top_items = [];
        foreach (ilMMCustomItemStorage::where(['top_item' => true])->get() as $item) {
            $top_items[] = $this->getSingleCustomItem($item, true);
        }
 
        return $top_items;
    }
 
    public function getStaticSubItems(): array
    {
        $items = [];
        foreach (ilMMCustomItemStorage::where(['top_item' => false])->get() as $item) {
            $items[] = $this->getSingleCustomItem($item, true);
        }
 
        return $items;
    }
 
    public function getSingleCustomItem(ilMMCustomItemStorage $storage, bool $register = false): isItem
    {
        $identification = $this->globalScreen()->identification()->core($this)->identifier($storage->getIdentifier());
 
        $item = $this->globalScreen()->mainBar()->custom($storage->getType(), $identification);
 
        $item = $item->withVisibilityCallable(
            $this->mm_access->isCurrentUserAllowedToSeeCustomItem(
                $storage,
                fn(): bool => $item->isVisible()
            )
        );
 
        if ($item instanceof hasTitle && !empty($storage->getDefaultTitle())) {
            $item = $item->withTitle($storage->getDefaultTitle());
        }
        if ($item instanceof hasAction) {
            $item = $item->withAction("#");
        }
        if ($item instanceof isChild) {
            $mm_item = ilMMItemStorage::find($identification->serialize());
            $parent_identification = '';
            if ($mm_item instanceof ilMMItemStorage) {
                $parent_identification = $mm_item->getParentIdentification();
            }
 
            if ($parent_identification !== '' && $parent_identification !== '0') {
                $item = $item->withParent(
                    $this->globalScreen()
                         ->identification()
                         ->fromSerializedIdentification($parent_identification)
                );
            }
        }
 
        if ($register) {
            ilMMItemStorage::register($item);
        }
 
        return $item;
    }
 
    #[\Override]
    public function provideTypeInformation(): TypeInformationCollection
    {
        $c = new TypeInformationCollection();
        // TopParentItem
        $c->add(
            new TypeInformation(
                TopParentItem::class,
                $this->translateType(TopParentItem::class),
                new TopParentItemRenderer()
            )
        );
        // TopLinkItem
        $c->add(
            new TypeInformation(
                TopLinkItem::class,
                $this->translateType(TopLinkItem::class),
                new ilMMTopLinkItemRenderer(),
                new ilMMTypeHandlerTopLink()
            )
        );
        // Link
        $c->add(
            new TypeInformation(
                Link::class,
                $this->translateType(Link::class),
                new ilMMLinkItemRenderer(),
                new ilMMTypeHandlerLink()
            )
        );
 
        // LinkList
        $link_list = new TypeInformation(
            LinkList::class,
            $this->translateType(LinkList::class),
            new LinkListItemRenderer()
        );
        $link_list->setCreationPrevented(true);
        $c->add($link_list);
 
        // Separator
        $c->add(
            new TypeInformation(
                Separator::class,
                $this->translateType(Separator::class),
                new SeparatorItemRenderer(),
                new ilMMTypeHandlerSeparator(),
                $this->translateByline(Separator::class)
            )
        );
 
        // RepositoryLink
        $c->add(
            new TypeInformation(
                RepositoryLink::class,
                $this->translateType(RepositoryLink::class),
                new ilMMRepositoryLinkItemRenderer(),
                new ilMMTypeHandlerRepositoryLink()
            )
        );
 
        // Lost
        $lost = new TypeInformation(
            Lost::class,
            $this->translateType(Lost::class),
            new LostItemRenderer()
        );
        $lost->setCreationPrevented(true);
        $c->add($lost);
 
        // Complex
        $complex = new TypeInformation(
            Complex::class,
            $this->translateType(Complex::class),
            new ComplexItemRenderer()
        );
        $complex->setCreationPrevented(true);
        $c->add($complex);
 
        return $c;
    }
 
    private function translateType(string $type): string
    {
        $last_part = substr(strrchr($type, "\\"), 1);
        $last_part = strtolower((string) preg_replace('/(?<!^)[A-Z]/', '_$0', $last_part));
 
        return $this->dic->language()->txt("type_" . strtolower($last_part));
    }
 
    private function translateByline(string $type): string
    {
        $last_part = substr(strrchr($type, "\\"), 1);
        $last_part = strtolower((string) preg_replace('/(?<!^)[A-Z]/', '_$0', $last_part));
 
        return $this->dic->language()->txt("type_" . strtolower($last_part) . "_info");
    }
 
    #[\Override]
    public function getProviderNameForPresentation(): string
    {
        return "Custom";
    }
}