Develop

.github/workflows/ci.yaml

@@ -8,7 +8,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: remindgmbh/[email protected]
-  phpcs:
+  static-analysis:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -18,4 +18,4 @@ jobs:
           extensions: intl
           tools: composer:v2
       - run: composer install
-      - run: composer run-script phpcs
+      - run: composer run-script static-analysis

.gitignore

@@ -1,18 +1,2 @@
-### IDE ###
-nbproject/
-.idea/
-
-### Composer ###
-composer.phar
-
-### General ###
-*.log
-cache.properties
-
-### CI ###
-.build/bin/
-.build/logs/
-.build/var/
-.build/vendor/
-.build/web/
-coverage.xml
+/vendor
+/public

.vscode/settings.json

@@ -1,8 +1,6 @@
 {
-    "phpCodeSniffer.exec.linux": "./.build/bin/phpcs",
+    "phpCodeSniffer.exec.linux": "./vendor/bin/phpcs",
     "phpCodeSniffer.standard": "Custom",
-    "phpCodeSniffer.standardCustom": "./.build/phpcs.xml",
-    "phpCodeSniffer.exclude": [
-        "**/.build/vendor/**"
-    ]
+    "phpCodeSniffer.standardCustom": "./phpcs.xml",
+    "phpCodeSniffer.exclude": []
 }

Classes/BreadcrumbTitle/AbstractBreadcrumbTitleProvider.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Remind\Headless\BreadcrumbTitle;
+
+use TYPO3\CMS\Core\SingletonInterface;
+
+class AbstractBreadcrumbTitleProvider implements BreadcrumbTitleProviderInterface, SingletonInterface
+{
+    protected string $title = '';
+
+    public function getTitle(): string
+    {
+        return $this->title;
+    }
+}

Classes/BreadcrumbTitle/BreadcrumbTitleProviderInterface.php

@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Remind\Headless\BreadcrumbTitle;
+
+interface BreadcrumbTitleProviderInterface
+{
+    public function getTitle(): string;
+}

Classes/BreadcrumbTitle/BreadcrumbTitleProviderManager.php

@@ -0,0 +1,110 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Remind\Headless\BreadcrumbTitle;
+
+use Psr\Log\LoggerAwareInterface;
+use Psr\Log\LoggerAwareTrait;
+use TYPO3\CMS\Core\Service\DependencyOrderingService;
+use TYPO3\CMS\Core\SingletonInterface;
+use TYPO3\CMS\Core\TypoScript\TypoScriptService;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use UnexpectedValueException;
+
+class BreadcrumbTitleProviderManager implements SingletonInterface, LoggerAwareInterface
+{
+    use LoggerAwareTrait;
+
+    /**
+     * @var string[]
+     */
+    private array $breadcrumbTitleCache = [];
+
+    public function getTitle(): string
+    {
+        $breadcrumbTitle = '';
+
+        $titleProviders = $this->getBreadcrumbTitleProviderConfiguration();
+        $titleProviders = $this->setProviderOrder($titleProviders);
+
+        $orderedTitleProviders = GeneralUtility::makeInstance(DependencyOrderingService::class)
+            ->orderByDependencies($titleProviders);
+
+        $this->logger?->debug('Breadcrumb title providers ordered', [
+            'orderedTitleProviders' => $orderedTitleProviders,
+        ]);
+
+        foreach ($orderedTitleProviders as $provider => $configuration) {
+            if (
+                class_exists($configuration['provider']) &&
+                is_subclass_of($configuration['provider'], BreadcrumbTitleProviderInterface::class)
+            ) {
+                /** @var BreadcrumbTitleProviderInterface $titleProviderObject */
+                $titleProviderObject = GeneralUtility::makeInstance($configuration['provider']);
+                if (
+                    ($breadcrumbTitle = $titleProviderObject->getTitle())
+                    || ($breadcrumbTitle = $this->breadcrumbTitleCache[$configuration['provider']] ?? '') !== ''
+                ) {
+                    $this->logger?->debug('Breadcrumb title provider {provider} used on page {title}', [
+                        'provider' => $configuration['provider'],
+                        'title' => $breadcrumbTitle,
+                    ]);
+                    $this->breadcrumbTitleCache[$configuration['provider']] = $breadcrumbTitle;
+                    break;
+                }
+                $this->logger?->debug('Breadcrumb title provider {provider} skipped on page {title}', [
+                    'provider' => $configuration['provider'],
+                    'providerUsed' => $configuration['provider'],
+                    'title' => $breadcrumbTitle,
+                ]);
+            }
+        }
+
+        return $breadcrumbTitle;
+    }
+
+    /**
+     * @param mixed[] $orderInformation
+     * @return mixed[]
+     */
+    protected function setProviderOrder(array $orderInformation): array
+    {
+        foreach ($orderInformation as $provider => &$configuration) {
+            if (isset($configuration['before'])) {
+                if (is_string($configuration['before'])) {
+                    $configuration['before'] = GeneralUtility::trimExplode(',', $configuration['before'], true);
+                } elseif (!is_array($configuration['before'])) {
+                    throw new UnexpectedValueException(
+                        'The specified "before" order configuration for provider "' . $provider . '" is invalid.',
+                        1535803185
+                    );
+                }
+            }
+            if (isset($configuration['after'])) {
+                if (is_string($configuration['after'])) {
+                    $configuration['after'] = GeneralUtility::trimExplode(',', $configuration['after'], true);
+                } elseif (!is_array($configuration['after'])) {
+                    throw new UnexpectedValueException(
+                        'The specified "after" order configuration for provider "' . $provider . '" is invalid.',
+                        1535803186
+                    );
+                }
+            }
+        }
+        return $orderInformation;
+    }
+
+    /**
+     * @return mixed[]
+     */
+    private function getBreadcrumbTitleProviderConfiguration(): array
+    {
+        $typoscriptService = GeneralUtility::makeInstance(TypoScriptService::class);
+        $config = $typoscriptService->convertTypoScriptArrayToPlainArray(
+            $GLOBALS['TSFE']->config['config'] ?? []
+        );
+
+        return $config['breadcrumbTitleProviders'] ?? [];
+    }
+}