PreviewModule.php

Go to the documentation of this file.

<?php
declare(strict_types = 1);
 
namespace ‪TYPO3\CMS\Adminpanel\Modules;
 
/*
 * 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!
 */
 
use Psr\Http\Message\ServerRequestInterface;
use ‪TYPO3\CMS\Adminpanel\ModuleApi\AbstractModule;
use ‪TYPO3\CMS\Adminpanel\ModuleApi\InitializableInterface;
use ‪TYPO3\CMS\Adminpanel\ModuleApi\PageSettingsProviderInterface;
use ‪TYPO3\CMS\Adminpanel\ModuleApi\ResourceProviderInterface;
use ‪TYPO3\CMS\Adminpanel\Repositories\FrontendGroupsRepository;
use ‪TYPO3\CMS\Core\Context\Context;
use ‪TYPO3\CMS\Core\Context\DateTimeAspect;
use ‪TYPO3\CMS\Core\Context\UserAspect;
use ‪TYPO3\CMS\Core\Context\VisibilityAspect;
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
use ‪TYPO3\CMS\Fluid\View\StandaloneView;
use ‪TYPO3\CMS\Frontend\Authentication\FrontendUserAuthentication;
use ‪TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController;
 
class ‪PreviewModule extends ‪AbstractModule implements ‪InitializableInterface, ‪PageSettingsProviderInterface, ‪ResourceProviderInterface
{
    protected ‪$config;
 
    public function ‪getIconIdentifier(): string
    {
        return 'actions-preview';
    }
 
    public function ‪getIdentifier(): string
    {
        return 'preview';
    }
 
    public function ‪getLabel(): string
    {
        return $this->‪getLanguageService()->‪sL(
            'LLL:EXT:adminpanel/Resources/Private/Language/locallang_preview.xlf:module.label'
        );
    }
 
    public function ‪initializeModule(ServerRequestInterface $request): void
    {
        // Backend preview params (ADMCMD_) take precedence over configured admin panel values
        $simulateGroupByRequest = (int)($request->getQueryParams()['ADMCMD_simUser'] ?? 0);
        $simulateTimeByRequest = (int)($request->getQueryParams()['ADMCMD_simTime'] ?? 0);
        $this->config = [
            'showHiddenPages' => (bool)$this->‪getConfigOptionForModule('showHiddenPages'),
            'simulateDate' => $simulateTimeByRequest ?: (int)$this->‪getConfigOptionForModule('simulateDate'),
            'showHiddenRecords' => (bool)$this->‪getConfigOptionForModule('showHiddenRecords'),
            'simulateUserGroup' => $simulateGroupByRequest ?: (int)$this->‪getConfigOptionForModule('simulateUserGroup'),
            'showFluidDebug' => (bool)$this->‪getConfigOptionForModule('showFluidDebug'),
        ];
        if ($this->config['showFluidDebug']) {
            // forcibly unset fluid caching as it does not care about the tsfe based caching settings
            unset(‪$GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheConfigurations']['fluid_template']['frontend']);
            ‪$GLOBALS['TSFE']->set_no_cache('Cache is disabled if fluid debugging is enabled', true);
        }
        $this->‪initializeFrontendPreview(
            $this->config['showHiddenPages'],
            $this->config['showHiddenRecords'],
            $this->config['simulateDate'],
            $this->config['simulateUserGroup']
        );
    }
 
    public function ‪getPageSettings(): string
    {
        $view = GeneralUtility::makeInstance(StandaloneView::class);
        $templateNameAndPath = 'EXT:adminpanel/Resources/Private/Templates/Modules/Settings/Preview.html';
        $view->setTemplatePathAndFilename(GeneralUtility::getFileAbsFileName($templateNameAndPath));
        $view->setPartialRootPaths(['EXT:adminpanel/Resources/Private/Partials']);
 
        $frontendGroupsRepository = GeneralUtility::makeInstance(FrontendGroupsRepository::class);
 
        $view->assignMultiple(
            [
                'show' => [
                    'pageId' => (int)$this->‪getTypoScriptFrontendController()->id,
                    'hiddenPages' => $this->config['showHiddenPages'],
                    'hiddenRecords' => $this->config['showHiddenRecords'],
                    'fluidDebug' => $this->config['showFluidDebug'],
                ],
                'simulateDate' => $this->config['simulateDate'],
                'frontendUserGroups' => [
                    'availableGroups' => $frontendGroupsRepository->getAvailableFrontendUserGroups(),
                    'selected' => (int)$this->config['simulateUserGroup'],
                ],
            ]
        );
        return $view->render();
    }
 
    protected function ‪getConfigOptionForModule(string $option): string
    {
        return $this->configurationService->getConfigurationOption(
            'preview',
            $option
        );
    }
 
    protected function ‪getTypoScriptFrontendController(): ‪TypoScriptFrontendController
    {
        return ‪$GLOBALS['TSFE'];
    }
 
    protected function ‪initializeFrontendPreview(
        bool $showHiddenPages,
        bool $showHiddenRecords,
        int $simulateDate,
        int $simulateUserGroup
    ): void {
        $context = GeneralUtility::makeInstance(Context::class);
        $typoScriptFrontendController = $this->‪getTypoScriptFrontendController();
        $typoScriptFrontendController->clear_preview();
        $typoScriptFrontendController->fePreview = 1;
 
        // Modify visibility settings (hidden pages + hidden content)
        $context->setAspect(
            'visibility',
            GeneralUtility::makeInstance(VisibilityAspect::class, $showHiddenPages, $showHiddenRecords)
        );
 
        // Simulate date
        $simTime = null;
        if ($simulateDate) {
            $simTime = $this->‪parseDate($simulateDate);
            if ($simTime) {
                ‪$GLOBALS['SIM_EXEC_TIME'] = $simTime;
                ‪$GLOBALS['SIM_ACCESS_TIME'] = $simTime - $simTime % 60;
                $context->setAspect(
                    'date',
                    GeneralUtility::makeInstance(
                        DateTimeAspect::class,
                        new \DateTimeImmutable('@' . ‪$GLOBALS['SIM_EXEC_TIME'])
                    )
                );
            }
        }
        // simulate usergroup
        if ($simulateUserGroup) {
            $typoScriptFrontendController->simUserGroup = $simulateUserGroup;
            if (!$typoScriptFrontendController->fe_user instanceof ‪FrontendUserAuthentication) {
                $typoScriptFrontendController->fe_user = GeneralUtility::makeInstance(
                    FrontendUserAuthentication::class
                );
            }
            if (!is_array($typoScriptFrontendController->fe_user->user)) {
                // This can be removed once #90989 is fixed
                $typoScriptFrontendController->fe_user->user = ['uid' => PHP_INT_MAX];
            }
            $typoScriptFrontendController->fe_user->user[$typoScriptFrontendController->fe_user->usergroup_column] = $simulateUserGroup;
            $context->setAspect(
                'frontend.user',
                GeneralUtility::makeInstance(
                    UserAspect::class,
                    $typoScriptFrontendController->fe_user ?: null,
                    [$simulateUserGroup]
                )
            );
        }
        if (!$simulateUserGroup && !$simTime && !$showHiddenPages && !$showHiddenRecords) {
            $typoScriptFrontendController->fePreview = 0;
        }
    }
 
    public function ‪getJavaScriptFiles(): array
    {
        return ['EXT:adminpanel/Resources/Public/JavaScript/Modules/Preview.js'];
    }
 
    protected function ‪parseDate(int $simulateDate): ?int
    {
        try {
            $simTime = (new \DateTime('@' . $simulateDate))->getTimestamp();
            $simTime = max($simTime, 60);
        } catch (\Exception $e) {
            $simTime = null;
        }
        return $simTime;
    }
 
    public function ‪getCssFiles(): array
    {
        return [];
    }
}