[!!!][TASK] Migrate to Site Sets and remove obsolete PageTsConfig registrations

This commit modernizes the Bootstrap Package for TYPO3 13 by fully
embracing Site Sets and removing legacy configuration approaches.

The registerPageTSConfigFile calls have been removed from all TCA
override files since content elements are now automatically registered
to the new content element wizard via TCA configuration in TYPO3 13.
This also means the mod.wizards.newContentElement PageTsConfig files
are no longer needed and have been deleted.

Backend layouts are now configurable via site settings, allowing users
to enable or disable individual layouts through the site configuration.
A new siteSetting() expression language function has been added to
support conditional PageTsConfig based on these settings.

The extension configuration has been simplified by removing the obsolete
PageTS toggle options which are now provided via Site Sets. Only the
feature flags disableCssProcessing and disableGoogleFontCaching remain.

The documentation has been completely rewritten to reflect the migration
from TypoScript constants to Site Settings. Each Site Set now has its
own dedicated documentation page. The outdated AdministratorManual and
migration guides have been removed.

Legacy TsConfig files like TCADefaults.tsconfig, TCEFORM.tsconfig and
TCEMAIN.tsconfig have been cleaned up as these configurations are now
provided via Site Sets.

Author: benjaminkott

Classes/ExpressionLanguage/ConditionProvider.php

@@ -1,5 +1,5 @@
 <?php
-declare(strict_types = 1);
+declare(strict_types=1);
 
 /*
  * This file is part of the package bk2k/bootstrap-package.
@@ -24,5 +24,8 @@ public function __construct()
             'extension' => GeneralUtility::makeInstance(ExtensionWrapper::class),
             'extensionConfiguration' => GeneralUtility::makeInstance(ExtensionConfigurationWrapper::class),
         ];
+        $this->expressionLanguageProviders = [
+            FunctionsProvider::class,
+        ];
     }
 }

Classes/ExpressionLanguage/FunctionsProvider.php

@@ -0,0 +1,61 @@
+<?php
+declare(strict_types=1);
+
+/*
+ * This file is part of the package bk2k/bootstrap-package.
+ *
+ * For the full copyright and license information, please read the
+ * LICENSE file that was distributed with this source code.
+ */
+
+namespace BK2K\BootstrapPackage\ExpressionLanguage;
+
+use Symfony\Component\ExpressionLanguage\ExpressionFunction;
+use Symfony\Component\ExpressionLanguage\ExpressionFunctionProviderInterface;
+use TYPO3\CMS\Core\Exception\SiteNotFoundException;
+use TYPO3\CMS\Core\Site\SiteFinder;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+
+/**
+ * Provides custom expression language functions for TypoScript/PageTsConfig conditions.
+ */
+class FunctionsProvider implements ExpressionFunctionProviderInterface
+{
+    /**
+     * @return ExpressionFunction[]
+     */
+    public function getFunctions(): array
+    {
+        return [
+            $this->getSiteSettingFunction(),
+        ];
+    }
+
+    protected function getSiteSettingFunction(): ExpressionFunction
+    {
+        return new ExpressionFunction(
+            'siteSetting',
+            static fn () => null, // Not used for compilation
+            static function (array $arguments, string $settingKey, mixed $default = null): mixed {
+                // Try to get page from the expression language context
+                $pageId = 0;
+                if (isset($arguments['page']['uid'])) {
+                    $pageId = (int)$arguments['page']['uid'];
+                }
+
+                if ($pageId <= 0) {
+                    return $default;
+                }
+
+                try {
+                    $siteFinder = GeneralUtility::makeInstance(SiteFinder::class);
+                    $site = $siteFinder->getSiteByPageId($pageId);
+                    $settings = $site->getSettings();
+                    return $settings->get($settingKey, $default);
+                } catch (SiteNotFoundException) {
+                    return $default;
+                }
+            }
+        );
+    }
+}

Configuration/Sets/BackendLayouts/PageTsConfig/BackendLayouts.tsconfig

@@ -1,2 +1,51 @@
-@import './BackendLayouts/'
+[siteSetting("backendlayout.default", true) == true]
+    @import './BackendLayouts/default.tsconfig'
+[end]
 
+[siteSetting("backendlayout.simple", true) == true]
+    @import './BackendLayouts/simple.tsconfig'
+[end]
+
+[siteSetting("backendlayout.2_columns", true) == true]
+    @import './BackendLayouts/2_columns.tsconfig'
+[end]
+
+[siteSetting("backendlayout.2_columns_25_75", true) == true]
+    @import './BackendLayouts/2_columns_25_75.tsconfig'
+[end]
+
+[siteSetting("backendlayout.2_columns_50_50", true) == true]
+    @import './BackendLayouts/2_columns_50_50.tsconfig'
+[end]
+
+[siteSetting("backendlayout.2_columns_offset_right", true) == true]
+    @import './BackendLayouts/2_columns_offset_right.tsconfig'
+[end]
+
+[siteSetting("backendlayout.3_columns", true) == true]
+    @import './BackendLayouts/3_columns.tsconfig'
+[end]
+
+[siteSetting("backendlayout.special_feature", true) == true]
+    @import './BackendLayouts/special_feature.tsconfig'
+[end]
+
+[siteSetting("backendlayout.special_start", true) == true]
+    @import './BackendLayouts/special_start.tsconfig'
+[end]
+
+[siteSetting("backendlayout.subnavigation_left", true) == true]
+    @import './BackendLayouts/subnavigation_left.tsconfig'
+[end]
+
+[siteSetting("backendlayout.subnavigation_left_2_columns", true) == true]
+    @import './BackendLayouts/subnavigation_left_2_columns.tsconfig'
+[end]
+
+[siteSetting("backendlayout.subnavigation_right", true) == true]
+    @import './BackendLayouts/subnavigation_right.tsconfig'
+[end]
+
+[siteSetting("backendlayout.subnavigation_right_2_columns", true) == true]
+    @import './BackendLayouts/subnavigation_right_2_columns.tsconfig'
+[end]

Configuration/Sets/BackendLayouts/settings.definitions.yaml

@@ -0,0 +1,100 @@
+categories:
+  BootstrapPackage:
+    label: 'Bootstrap Package'
+  BootstrapPackage.backendLayouts:
+    label: 'Backend Layouts'
+    parent: BootstrapPackage
+
+settings:
+
+  # Backend Layouts
+  backendlayout.default:
+    label: 'Enable Default Layout'
+    description: 'Enable the default backend layout with border, content before/after, main content and footer columns.'
+    category: BootstrapPackage.backendLayouts
+    type: bool
+    default: true
+
+  backendlayout.simple:
+    label: 'Enable Simple Layout'
+    description: 'Enable the simple backend layout with border, content before/after and main content columns.'
+    category: BootstrapPackage.backendLayouts
+    type: bool
+    default: true
+
+  backendlayout.2_columns:
+    label: 'Enable 2 Columns Layout'
+    description: 'Enable the 2 columns (75/25) backend layout.'
+    category: BootstrapPackage.backendLayouts
+    type: bool
+    default: true
+
+  backendlayout.2_columns_25_75:
+    label: 'Enable 2 Columns 25/75 Layout'
+    description: 'Enable the 2 columns (25/75) backend layout.'
+    category: BootstrapPackage.backendLayouts
+    type: bool
+    default: true
+
+  backendlayout.2_columns_50_50:
+    label: 'Enable 2 Columns 50/50 Layout'
+    description: 'Enable the 2 columns (50/50) backend layout.'
+    category: BootstrapPackage.backendLayouts
+    type: bool
+    default: true
+
+  backendlayout.2_columns_offset_right:
+    label: 'Enable 2 Columns Offset Right Layout'
+    description: 'Enable the 2 columns offset right backend layout.'
+    category: BootstrapPackage.backendLayouts
+    type: bool
+    default: true
+
+  backendlayout.3_columns:
+    label: 'Enable 3 Columns Layout'
+    description: 'Enable the 3 columns backend layout.'
+    category: BootstrapPackage.backendLayouts
+    type: bool
+    default: true
+
+  backendlayout.special_feature:
+    label: 'Enable Special Feature Layout'
+    description: 'Enable the special feature backend layout.'
+    category: BootstrapPackage.backendLayouts
+    type: bool
+    default: true
+
+  backendlayout.special_start:
+    label: 'Enable Special Start Layout'
+    description: 'Enable the special start backend layout.'
+    category: BootstrapPackage.backendLayouts
+    type: bool
+    default: true
+
+  backendlayout.subnavigation_left:
+    label: 'Enable Subnavigation Left Layout'
+    description: 'Enable the subnavigation left backend layout.'
+    category: BootstrapPackage.backendLayouts
+    type: bool
+    default: true
+
+  backendlayout.subnavigation_left_2_columns:
+    label: 'Enable Subnavigation Left 2 Columns Layout'
+    description: 'Enable the subnavigation left with 2 columns backend layout.'
+    category: BootstrapPackage.backendLayouts
+    type: bool
+    default: true
+
+  backendlayout.subnavigation_right:
+    label: 'Enable Subnavigation Right Layout'
+    description: 'Enable the subnavigation right backend layout.'
+    category: BootstrapPackage.backendLayouts
+    type: bool
+    default: true
+
+  backendlayout.subnavigation_right_2_columns:
+    label: 'Enable Subnavigation Right 2 Columns Layout'
+    description: 'Enable the subnavigation right with 2 columns backend layout.'
+    category: BootstrapPackage.backendLayouts
+    type: bool
+    default: true