TYPO3 v12: TypoScript-Modul für nicht-Administratoren

Nach der Umstellung auf TYPO3 v12 will das Modul TypoScript (ehemals Template) für nicht-Admin Nutzer nicht mehr funktionieren.

Der bisherige Workaround scheint unvollständig. Um das Modul für nicht-Administratoren wieder gangbar zu machen, müssen folgende Schritte unternommen werden.

Eigene Erweiterung

Hier wird davon ausgegangen, dass es - irgendwie geartet - bereits eine eigene TYPO3-Erweiterung im System gibt, auf deren Inhalt Einfluss genommen werden kann. Im folgenden Text wird hierfür der Name my_extension verwendet.

TCA anpassen

Per TCA-Override muss die Berechtigung für die Tabelle sys_template gelockert werden. Hierzu muss die Datei my_extension/Configuration/TCA/Overrides/sys_template.php mit folgender TCA-Konfiguration vorhanden sein:

<?php
$GLOBALS['TCA']['sys_template']['ctrl']['adminOnly'] = 0;

Zugriffsberechtigungen für Modul überschreiben

Die Modul-Konfiguration aus dem TYPO3 Core (typo3/cms-tstemplate) muss angepasst werden. Hier hilft leider nur eine komplette Kopie der Vorlage aus /typo3/cms-tstemplate/Configuration/Backend/Modules.php. Die jeweiligen Unterschlüssel der Konfiguration für den Zugriff (access) müssen von admin auf user geändert werden:

<?php

/**
* Definitions for modules provided by EXT:tstemplate
*/

use TYPO3\CMS\Tstemplate\Controller\ActiveTypoScriptController;
use TYPO3\CMS\Tstemplate\Controller\ConstantEditorController;
use TYPO3\CMS\Tstemplate\Controller\InfoModifyController;
use TYPO3\CMS\Tstemplate\Controller\TemplateAnalyzerController;
use TYPO3\CMS\Tstemplate\Controller\TemplateRecordsOverviewController;

return [
    'web_ts' => [
        'parent' => 'site',
        'access' => 'user',
        'path' => '/module/web/ts',
        'iconIdentifier' => 'module-template',
        'labels' => [
            'title' => 'LLL:EXT:tstemplate/Resources/Private/Language/locallang.xlf:module.typoscript.title',
            'shortDescription' => 'LLL:EXT:tstemplate/Resources/Private/Language/locallang.xlf:module.typoscript.shortDescription',
            'description' => 'LLL:EXT:tstemplate/Resources/Private/Language/locallang.xlf:module.typoscript.description',
        ],
        'navigationComponent' => '@typo3/backend/page-tree/page-tree-element',
    ],
    'web_typoscript_recordsoverview' => [
        'parent' => 'web_ts',
        'access' => 'user',
        'path' => '/module/web/typoscript/records-overview',
        'iconIdentifier' => 'module-template',
        'labels' => [
            'title' => 'LLL:EXT:tstemplate/Resources/Private/Language/locallang.xlf:submodules.option.templateRecordsOverview',
        ],
        'routes' => [
            '_default' => [
                'target' => TemplateRecordsOverviewController::class . '::handleRequest',
            ],
        ],
    ],
    'web_typoscript_constanteditor' => [
        'parent' => 'web_ts',
        'access' => 'user',
        'path' => '/module/web/typoscript/constant-editor',
        'iconIdentifier' => 'module-template',
        'labels' => [
            'title' => 'LLL:EXT:tstemplate/Resources/Private/Language/locallang.xlf:submodules.option.constantEditor',
        ],
        'routes' => [
            '_default' => [
                'target' => ConstantEditorController::class . '::handleRequest',
            ],
        ],
        'moduleData' => [
            'selectedTemplatePerPage' => [],
            'selectedCategory' => '',
        ],
    ],
    'web_typoscript_infomodify' => [
        'parent' => 'web_ts',
        'access' => 'user',
        'path' => '/module/web/typoscript/overview',
        'iconIdentifier' => 'module-template',
        'labels' => [
            'title' => 'LLL:EXT:tstemplate/Resources/Private/Language/locallang.xlf:submodules.option.infoModify',
        ],
        'routes' => [
            '_default' => [
                'target' => InfoModifyController::class . '::handleRequest',
            ],
        ],
        'moduleData' => [
            'selectedTemplatePerPage' => [],
        ],
    ],
    'typoscript_active' => [
        'parent' => 'web_ts',
        'access' => 'user',
        'path' => '/module/typoscript/active',
        'iconIdentifier' => 'module-template',
        'labels' => [
            'title' => 'LLL:EXT:tstemplate/Resources/Private/Language/locallang.xlf:submodules.option.active',
        ],
        'routes' => [
            '_default' => [
                'target' => ActiveTypoScriptController::class . '::indexAction',
            ],
            'edit' => [
                'target' => ActiveTypoScriptController::class . '::editAction',
            ],
            'update' => [
                'target' => ActiveTypoScriptController::class . '::updateAction',
                'methods' => ['POST'],
            ],
        ],
        'moduleData' => [
            'sortAlphabetically' => true,
            'displayConstantSubstitutions' => true,
            'displayComments' => true,
            'selectedTemplatePerPage' => [],
            'constantConditions' => [],
            'setupConditions' => [],
        ],
    ],
    'web_typoscript_analyzer' => [
        'parent' => 'web_ts',
        'access' => 'user',
        'path' => '/module/web/typoscript/analyzer',
        'iconIdentifier' => 'module-template',
        'labels' => [
            'title' => 'LLL:EXT:tstemplate/Resources/Private/Language/locallang.xlf:submodules.option.templateAnalyzer',
        ],
        'routes' => [
            '_default' => [
                'target' => TemplateAnalyzerController::class . '::indexAction',
            ],
            'source' => [
                'target' => TemplateAnalyzerController::class . '::sourceAction',
            ],
            'sourceWithIncludes' => [
                'target' => TemplateAnalyzerController::class . '::sourceWithIncludesAction',
            ],
        ],
        'moduleData' => [
            'selectedTemplatePerPage' => [],
            'constantConditions' => [],
            'setupConditions' => [],
        ],
    ],
];

Fluid-Template-Pfade hinzufügen

Da das Modul nun aus der eigenen Erweiterung my_extension aufgerufen wird und das Fluid-Template die jeweiligen Template-Dateien erwartet, muss noch auf die Nutzung der Core-eigenen Templates verwiesen werden. Hierzu sollte die Datei my_extension/Configuration/page.tsconfig mit folgendem Inhalt erstellt werden:

templates.typo3/cms-backend {
  1742393409 = typo3/cms-tstemplate:Resources/Private/
}

Berechtigungen zuweisen

Nachdem alle o.g. Schritte durchgeführt und der TYPO3-Cache geleert ist, können die Berechtigungen für das TypoScript-Modul auf Benutzer- oder Gruppen-Ebene vergeben werden.