TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:00 +02:00
commit f9941541b7
1178 changed files with 135377 additions and 0 deletions
@@ -0,0 +1,109 @@
+<?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\Controller;
+
+use Psr\Http\Message\ResponseInterface;
+use Psr\Http\Message\ServerRequestInterface;
+use TYPO3\CMS\Backend\Attribute\AsController;
+use TYPO3\CMS\Backend\Module\ModuleInterface;
+use TYPO3\CMS\Backend\Module\ModuleProvider;
+use TYPO3\CMS\Backend\Template\Enum\ModuleLayout;
+use TYPO3\CMS\Backend\Template\ModuleTemplateFactory;
+use TYPO3\CMS\Backend\Utility\BackendUtility;
+use TYPO3\CMS\Core\Authentication\BackendUserAuthentication;
+use TYPO3\CMS\Core\Localization\LanguageService;
+use TYPO3\CMS\Core\Type\Bitmask\Permission;
+
+/**
+ * Controller for displaying a card-based overview of available submodules.
+ * This provides a user-friendly way to navigate between third-level modules.
+ *
+ * @internal This class is a specific Backend controller implementation and is not part of the TYPO3's Core API.
+ */
+#[AsController]
+final readonly class SubmoduleOverviewController
+{
+    public function __construct(
+        private ModuleTemplateFactory $moduleTemplateFactory,
+        private ModuleProvider $moduleProvider,
+    ) {}
+
+    /**
+     * Main action that displays the submodule overview cards
+     */
+    public function handleRequest(ServerRequestInterface $request): ResponseInterface
+    {
+        $view = $this->moduleTemplateFactory->create($request);
+        $currentModule = $request->getAttribute('module');
+        if (!($currentModule instanceof ModuleInterface) || !$this->moduleProvider->accessGranted($currentModule->getIdentifier(), $this->getBackendUser())) {
+            return $view->renderResponse('SubmoduleOverview/Cards');
+        }
+
+        $id = (int)($request->getParsedBody()['id'] ?? $request->getQueryParams()['id'] ?? 0);
+        $pageinfo = BackendUtility::readPageAccess($id, $this->getBackendUser()->getPagePermsClause(Permission::PAGE_SHOW)) ?: [];
+        $view->setTitle(
+            $this->getLanguageService()->sL($currentModule->getTitle()),
+            $id !== 0 && isset($pageinfo['title']) ? $pageinfo['title'] : ''
+        );
+        if ($pageinfo !== []) {
+            $view->getDocHeaderComponent()->setPageBreadcrumb($pageinfo);
+        }
+        $view->makeDocHeaderModuleMenu(['id' => $id]);
+        $view->getDocHeaderComponent()->setShortcutContext(
+            $currentModule->getIdentifier(),
+            $this->getLanguageService()->sL($currentModule->getTitle())
+        );
+
+        $view->setTitle($this->getLanguageService()->sL($currentModule->getTitle()));
+        $view->setLayout(ModuleLayout::NORMAL);
+        $view->assign('currentModule', $currentModule);
+        $view->assignMultiple([
+            'additionalParameters' => array_filter(['id' => $id]),
+            'submodules' => $this->getAccessibleSubmodules($currentModule),
+            'moduleTitle' => $this->getLanguageService()->sL($currentModule->getTitle()),
+        ]);
+        return $view->renderResponse('SubmoduleOverview/Cards');
+    }
+
+    /**
+     * Get all submodules the current user has access to
+     *
+     * @return ModuleInterface[]
+     */
+    private function getAccessibleSubmodules(ModuleInterface $module): array
+    {
+        $accessibleSubmodules = [];
+        foreach ($module->getSubModules() as $submodule) {
+            // Check if the user has access to this submodule
+            if ($this->moduleProvider->accessGranted($submodule->getIdentifier(), $this->getBackendUser())) {
+                $accessibleSubmodules[] = $submodule;
+            }
+        }
+        return $accessibleSubmodules;
+    }
+
+    private function getLanguageService(): LanguageService
+    {
+        return $GLOBALS['LANG'];
+    }
+
+    private function getBackendUser(): BackendUserAuthentication
+    {
+        return $GLOBALS['BE_USER'];
+    }
+}