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,98 @@
+<?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\Module;
+
+use Psr\EventDispatcher\EventDispatcherInterface;
+use Symfony\Component\DependencyInjection\Attribute\Autoconfigure;
+use TYPO3\CMS\Core\Imaging\IconRegistry;
+
+/**
+ * @internal only to be used within TYPO3 Core
+ */
+#[Autoconfigure(public: true)]
+readonly class ModuleFactory
+{
+    public function __construct(
+        protected IconRegistry $iconRegistry,
+        protected EventDispatcherInterface $eventDispatcher,
+    ) {}
+
+    public function createModule(string $identifier, array $configuration): ModuleInterface
+    {
+        $configuration = $this->eventDispatcher->dispatch(
+            new BeforeModuleCreationEvent($identifier, $configuration)
+        )->getConfiguration();
+
+        $configuration = $this->sanitizeConfiguration($identifier, $configuration);
+
+        if (is_array($configuration['controllerActions'] ?? false)) {
+            return ExtbaseModule::createFromConfiguration($identifier, $configuration);
+        }
+        return Module::createFromConfiguration($identifier, $configuration);
+    }
+
+    private function sanitizeConfiguration(string $identifier, array $configuration): array
+    {
+        if (empty($configuration['path'])) {
+            $configuration['path'] = '/module/' . trim(str_replace('_', '/', $identifier), '/');
+        }
+
+        if ($configuration['icon'] ?? false) {
+            $iconPath = $configuration['icon'];
+            if ($iconPath !== '') {
+                $iconIdentifier = 'module-' . $identifier;
+                $iconProvider = $this->iconRegistry->detectIconProvider($iconPath);
+                $this->iconRegistry->registerIcon($iconIdentifier, $iconProvider, ['source' => $iconPath]);
+                $configuration['iconIdentifier'] = $iconIdentifier;
+            }
+            unset($configuration['icon']);
+        }
+        return $configuration;
+    }
+
+    /**
+     * In order to keep modules that reference to an alias (e.g. switch of main module form "web" to "content"),
+     * the modules need to be re-located to reference the "new" identifier and not the now available alias. This
+     * concerns "parent" and the "position" options, which reference other module identifiers.
+     */
+    public function adaptAliasMappingFromModuleConfiguration(array $moduleConfigurations): array
+    {
+        // collect ALL aliases
+        $availableAliases = [];
+        foreach ($moduleConfigurations as $moduleIdentifier => $moduleConfiguration) {
+            foreach ($moduleConfiguration['aliases'] ?? [] as $aliasIdentifier) {
+                $availableAliases[$aliasIdentifier] = $moduleIdentifier;
+            }
+        }
+        // rewrite references
+        $adaptedModuleConfiguration = [];
+        foreach ($moduleConfigurations as $moduleIdentifier => $moduleConfiguration) {
+            if (isset($moduleConfiguration['parent'], $availableAliases[$moduleConfiguration['parent']])) {
+                $moduleConfiguration['parent'] = $availableAliases[$moduleConfiguration['parent']];
+            }
+            if (isset($moduleConfiguration['position']['before'], $availableAliases[$moduleConfiguration['position']['before']])) {
+                $moduleConfiguration['position']['before'] = $availableAliases[$moduleConfiguration['position']['before']];
+            }
+            if (isset($moduleConfiguration['position']['after'], $availableAliases[$moduleConfiguration['position']['after']])) {
+                $moduleConfiguration['position']['after'] = $availableAliases[$moduleConfiguration['position']['after']];
+            }
+            $adaptedModuleConfiguration[$moduleIdentifier] = $moduleConfiguration;
+        }
+        return $adaptedModuleConfiguration;
+    }
+}