ContextMenu.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */
 
namespace ‪TYPO3\CMS\Backend\ContextMenu;
 
use ‪TYPO3\CMS\Backend\ContextMenu\ItemProviders\PageProvider;
use ‪TYPO3\CMS\Backend\ContextMenu\ItemProviders\ProviderInterface;
use ‪TYPO3\CMS\Backend\ContextMenu\ItemProviders\RecordProvider;
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
 
class ‪ContextMenu
{
    protected ‪$itemProviders = [
        PageProvider::class,
        RecordProvider::class,
    ];
 
    public function ‪getItems(string $table, string $identifier, string $context = ''): array
    {
        $items = [];
        $itemsProviders = $this->‪getAvailableProviders($table, $identifier, $context);
 
        foreach ($itemsProviders as $provider) {
            $items = $provider->addItems($items);
        }
        return $this->‪cleanItems($items);
    }
 
    protected function ‪getAvailableProviders(string $table, string $identifier, string $context): array
    {
        $providers = array_merge($this->itemProviders, ‪$GLOBALS['TYPO3_CONF_VARS']['BE']['ContextMenu']['ItemProviders'] ?? []);
        $availableProviders = [];
        foreach ($providers as $providerClass) {
            $provider = GeneralUtility::makeInstance($providerClass, $table, $identifier, $context);
            if ($provider->canHandle()) {
                $priority = $provider->getPriority();
                $availableProviders[$priority] = $provider;
            }
        }
        krsort($availableProviders);
        return $availableProviders;
    }
 
    protected function ‪cleanItems(array $items): array
    {
        $canRender = false;
        $prevItemWasDivider = false;
 
        foreach ($items as $key => $item) {
            if ($item['type'] === 'item') {
                $canRender = true;
                $prevItemWasDivider = false;
                continue;
            }
            if ($item['type'] === 'divider') {
                if ($prevItemWasDivider === true) {
                    unset($items[$key]);
                } else {
                    $prevItemWasDivider = true;
                }
                continue;
            }
            if ($item['type'] === 'submenu') {
                $childItems = $this->‪cleanItems($item['childItems']);
                if (empty($childItems)) {
                    unset($items[$key]);
                } else {
                    $items[$key]['childItems'] = $childItems;
                    $canRender = true;
                    $prevItemWasDivider = false;
                }
                continue;
            }
        }
 
        if ($canRender) {
            //Remove first and last divider
            $fistItem = reset($items);
            if ($fistItem['type'] === 'divider') {
                $key = key($items);
                unset($items[$key]);
            }
            $lastItem = end($items);
            if ($lastItem['type'] === 'divider') {
                $key = key($items);
                unset($items[$key]);
            }
        } else {
            //no menu when there are no item or submenu
            $items = [];
        }
        return $items;
    }
}