DashboardController.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\Dashboard\Controller;
 
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
use ‪TYPO3\CMS\Backend\Routing\Exception\RouteNotFoundException as RouteNotFoundExceptionAlias;
use ‪TYPO3\CMS\Backend\Routing\UriBuilder;
use ‪TYPO3\CMS\Backend\Template\ModuleTemplate;
use ‪TYPO3\CMS\Core\Http\HtmlResponse;
use ‪TYPO3\CMS\Core\Http\RedirectResponse;
use ‪TYPO3\CMS\Core\Page\PageRenderer;
use ‪TYPO3\CMS\Core\Utility\ExtensionManagementUtility;
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
use ‪TYPO3\CMS\Core\Utility\PathUtility;
use ‪TYPO3\CMS\Dashboard\Dashboard;
use ‪TYPO3\CMS\Dashboard\DashboardInitializationService;
use ‪TYPO3\CMS\Dashboard\DashboardPresetRegistry;
use ‪TYPO3\CMS\Dashboard\DashboardRepository;
use ‪TYPO3\CMS\Dashboard\WidgetGroupInitializationService;
use ‪TYPO3\CMS\Extbase\Mvc\View\ViewInterface;
use ‪TYPO3\CMS\Fluid\View\StandaloneView;
 
class ‪DashboardController extends ‪AbstractController
{
    private ‪$moduleTemplate;
 
    protected ‪$uriBuilder;
 
    protected ‪$view;
 
    protected ‪$currentDashboard;
 
    protected ‪$dashboardPresetRepository;
 
    protected ‪$dashboardRepository;
 
    private ‪$dashboardInitializationService;
 
    private ‪$widgetGroupInitializationService;
 
    public function ‪__construct(
        ‪ModuleTemplate ‪$moduleTemplate,
        ‪UriBuilder ‪$uriBuilder,
        ‪DashboardPresetRegistry ‪$dashboardPresetRepository,
        ‪DashboardRepository ‪$dashboardRepository,
        ‪DashboardInitializationService ‪$dashboardInitializationService,
        ‪WidgetGroupInitializationService ‪$widgetGroupInitializationService
    ) {
        $this->moduleTemplate = ‪$moduleTemplate;
        $this->uriBuilder = ‪$uriBuilder;
        $this->dashboardPresetRepository = ‪$dashboardPresetRepository;
        $this->dashboardRepository = ‪$dashboardRepository;
        $this->dashboardInitializationService = ‪$dashboardInitializationService;
 
        $this->dashboardInitializationService->‪initializeDashboards($this->‪getBackendUser());
        $this->currentDashboard = $this->dashboardInitializationService->getCurrentDashboard();
        $this->widgetGroupInitializationService = ‪$widgetGroupInitializationService;
    }
 
    public function ‪mainAction(): void
    {
        $this->view->assignMultiple([
            'availableDashboards' => $this->dashboardInitializationService->getDashboardsForUser(),
            'dashboardPresets' => $this->dashboardPresetRepository->getDashboardPresets(),
            'widgetGroups' => $this->widgetGroupInitializationService->buildWidgetGroupsConfiguration(),
            'currentDashboard' => $this->currentDashboard,
            'addWidgetUri' => (string)$this->uriBuilder->buildUriFromRoute('dashboard', ['action' => 'addWidget']),
            'addDashboardUri' => (string)$this->uriBuilder->buildUriFromRoute('dashboard', ['action' => 'addDashboard']),
            'deleteDashboardUri' => (string)$this->uriBuilder->buildUriFromRoute('dashboard', ['action' => 'deleteDashboard']),
            'configureDashboardUri' => (string)$this->uriBuilder->buildUriFromRoute('dashboard', ['action' => 'configureDashboard']),
        ]);
    }
 
    public function ‪handleRequest(ServerRequestInterface $request): ResponseInterface
    {
        $pageRenderer = $this->moduleTemplate->getPageRenderer();
        $this->‪preparePageRenderer($pageRenderer);
 
        $action = $request->getQueryParams()['action'] ?? $request->getParsedBody()['action'] ?? 'main';
        $this->‪initializeView('Dashboard/' . ucfirst($action));
        $result = $this->{$action . 'Action'}($request);
        if ($result instanceof ResponseInterface) {
            return $result;
        }
        $this->‪addFrontendResources($pageRenderer);
        $this->moduleTemplate->setContent($this->view->render());
        return new ‪HtmlResponse($this->moduleTemplate->renderContent());
    }
 
    public function ‪configureDashboardAction(ServerRequestInterface $request): ResponseInterface
    {
        $parameters = $request->getParsedBody();
        ‪$currentDashboard = $parameters['currentDashboard'] ?? '';
        $route = $this->uriBuilder->buildUriFromRoute('dashboard', ['action' => 'main'], ‪UriBuilder::ABSOLUTE_URL);
 
        if (‪$currentDashboard !== '' && isset($parameters['dashboard'])) {
            $this->dashboardRepository->updateDashboardSettings(‪$currentDashboard, $parameters['dashboard']);
        }
 
        return new ‪RedirectResponse($route);
    }
 
    public function ‪setActiveDashboardAction(ServerRequestInterface $request): ResponseInterface
    {
        $this->‪saveCurrentDashboard($request->getQueryParams()['currentDashboard']);
        $route = $this->uriBuilder->buildUriFromRoute('dashboard', ['action' => 'main']);
        return new ‪RedirectResponse($route);
    }
 
    public function ‪addDashboardAction(ServerRequestInterface $request): ResponseInterface
    {
        $parameters = $request->getParsedBody();
        $dashboardIdentifier = $parameters['dashboard'] ?? '';
 
        if ($dashboardIdentifier !== '') {
            $dashboard = $this->dashboardRepository->create($this->dashboardPresetRepository->getDashboardPresets()[$dashboardIdentifier], (int)$this->getBackendUser()->user['uid'], $parameters['dashboard-title']);
 
            if ($dashboard instanceof ‪Dashboard) {
                $this->‪saveCurrentDashboard($dashboard->getIdentifier());
            }
        }
 
        return new ‪RedirectResponse($this->uriBuilder->buildUriFromRoute('dashboard', ['action' => 'main']));
    }
 
    public function ‪deleteDashboardAction(): ResponseInterface
    {
        $this->dashboardRepository->delete($this->currentDashboard);
        return new ‪RedirectResponse($this->uriBuilder->buildUriFromRoute('dashboard', ['action' => 'main']));
    }
 
    public function ‪addWidgetAction(ServerRequestInterface $request): ResponseInterface
    {
        $parameters = $request->getQueryParams();
        $widgetKey = $parameters['widget'];
 
        if ($widgetKey) {
            $widgets = $this->currentDashboard->getWidgetConfig();
            $hash = sha1($widgetKey . '-' . time());
            $widgets[$hash] = ['identifier' => $widgetKey];
            $this->dashboardRepository->updateWidgetConfig($this->currentDashboard, $widgets);
        }
 
        $route = $this->uriBuilder->buildUriFromRoute('dashboard', ['action' => 'main']);
        return new ‪RedirectResponse($route);
    }
 
    public function ‪removeWidgetAction(ServerRequestInterface $request): ResponseInterface
    {
        $parameters = $request->getQueryParams();
        $widgetHash = $parameters['widgetHash'];
        $widgets = $this->currentDashboard->getWidgetConfig();
 
        if (array_key_exists($widgetHash, $widgets)) {
            unset($widgets[$widgetHash]);
            $this->dashboardRepository->updateWidgetConfig($this->currentDashboard, $widgets);
        }
        $route = $this->uriBuilder->buildUriFromRoute('dashboard', ['action' => 'main']);
        return new ‪RedirectResponse($route);
    }
 
    protected function ‪initializeView(string $templateName): void
    {
        $this->view = GeneralUtility::makeInstance(StandaloneView::class);
        $this->view->setTemplate($templateName);
 
        $this->view->getRenderingContext()->getTemplatePaths()->fillDefaultsByPackageName('dashboard');
        $this->moduleTemplate->getDocHeaderComponent()->disable();
    }
 
    protected function ‪addFrontendResources(‪PageRenderer $pageRenderer): void
    {
        foreach ($this->dashboardInitializationService->getRequireJsModules() as $requireJsModule) {
            if (is_array($requireJsModule)) {
                $pageRenderer->‪loadRequireJsModule($requireJsModule[0], $requireJsModule[1]);
            } else {
                $pageRenderer->‪loadRequireJsModule($requireJsModule);
            }
        }
        foreach ($this->dashboardInitializationService->getCssFiles() as $cssFile) {
            $pageRenderer->‪addCssFile($cssFile);
        }
        foreach ($this->dashboardInitializationService->getJsFiles() as $jsFile) {
            $pageRenderer->‪addJsFile($jsFile);
        }
    }
 
    protected function ‪preparePageRenderer(PageRenderer $pageRenderer): void
    {
        $publicResourcesPath =
            ‪PathUtility::getAbsoluteWebPath(‪ExtensionManagementUtility::extPath('dashboard')) . 'Resources/Public/';
 
        $pageRenderer->addRequireJsConfiguration(
            [
                'paths' => [
                    'muuri' => $publicResourcesPath . 'JavaScript/Contrib/muuri',
                    'web-animate' => $publicResourcesPath . 'JavaScript/Contrib/web-animate',
                ],
            ]
        );
 
        $pageRenderer->loadRequireJsModule('muuri');
        $pageRenderer->loadRequireJsModule('web-animate');
        $pageRenderer->loadRequireJsModule('TYPO3/CMS/Dashboard/Grid');
        $pageRenderer->loadRequireJsModule('TYPO3/CMS/Dashboard/WidgetContentCollector');
        $pageRenderer->loadRequireJsModule('TYPO3/CMS/Dashboard/WidgetSelector');
        $pageRenderer->loadRequireJsModule('TYPO3/CMS/Dashboard/WidgetRemover');
        $pageRenderer->loadRequireJsModule('TYPO3/CMS/Dashboard/DashboardModal');
        $pageRenderer->loadRequireJsModule('TYPO3/CMS/Dashboard/DashboardDelete');
        $pageRenderer->addCssFile($publicResourcesPath . 'Css/dashboard.css');
    }
}