Logo - dev-werk.de
Zurück

Eigene Datensätze zur Breadcrumb-Navigation hinzufügen

Avatar of Andre Lanius Andre Lanius - 10. September 2026 - TYPO3, Extbase & Fluid - 2 minute read
Eigene Datensätze zur Breadcrumb-Navigation hinzufügen

Die Breadcrumb-Navigation in TYPO3 basiert standardmäßig auf der Seitenstruktur. Bei dynamischen Inhalten, die von Extensions bereitgestellt werden, reicht diese Struktur jedoch nicht immer aus. Detailseiten von Datensätzen gehören beispielsweise nicht direkt zur Rootline und werden deshalb nicht automatisch als letzter Eintrag in der Breadcrumb-Navigation dargestellt.

Mit einem eigenen DataProcessor lässt sich dieses Verhalten gezielt erweitern. Der Processor kann zusätzliche Daten aus der aktuellen Anfrage ermitteln, einen passenden Datensatz aus der Datenbank laden und diesen anschließend an die bereits vorhandenen Breadcrumb-Einträge anhängen.

In diesem Beitrag wird Schritt für Schritt gezeigt, wie ein solcher eigener DataProcessor in einer TYPO3-Extension umgesetzt wird. Dabei kommt der TYPO3 ConnectionPool zum Einsatz, um den benötigten Datensatz direkt aus der Datenbank auszulesen und seinen Titel dynamisch in die Breadcrumb-Navigation zu integrieren. Ich habe es in diesem Fall etwas einfacherer gehalten und daher nutze ich in diesem Beispiel zur Datenbankabfrage den Connectionpool, es kann aber auch jede beliebige Repository-Abfrage integriert werden, wie man es aus TYPO3 Extensions normalerweise gewohnt ist.

Für den eigenen DataProcessor wird zunächst eine neue PHP-Klasse innerhalb der Sitepackage-Extension angelegt. Dafür wird im Ordner Classes ein eigener Unterordner DataProcessing erstellt. Diese Datei muss nicht unbedingt im Sitepackage erstellt werden, sie kann auch direkt innerhalb der eigenen Extension angelegt werden. Wir gehen hier aber mal von einem Sitepackage als Beispiel aus.

Die benötigte Struktur sieht anschließend so aus:
packages/
└── sitepackage/
   └── Classes/
       └── DataProcessing/
           └── BlogBreadcrumbProcessor.php

Die Datei BlogBreadcrumbProcessor.php ist dabei der eigentliche DataProcessor. In ihr wird später die Logik untergebracht, die den aktuellen Datensatz ermittelt und dessen Titel an die Breadcrumb-Navigation übergibt.

Zusätzlich wird der DataProcessor anschließend im TypoScript des sitepackage eingebunden. Dafür muss keine weitere PHP-Datei erstellt werden. Die vorhandene TypoScript-Konfiguration der Seite wird lediglich um den Aufruf des neuen Processors erweitert.

Der Inhalt des DataProcessor könnte z.B. wie folgt aussehen:

<?php

declare(strict_types=1);

namespace Vendor\Extension\DataProcessing;

use TYPO3\CMS\Core\Database\Connection;
use TYPO3\CMS\Core\Database\ConnectionPool;
use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Frontend\ContentObject\ContentObjectRenderer;
use TYPO3\CMS\Frontend\ContentObject\DataProcessorInterface;

class BlogBreadcrumbProcessor implements DataProcessorInterface
{
    public function process(
        ContentObjectRenderer $cObj,
        array $contentObjectConfiguration,
        array $processorConfiguration,
        array $processedData
    ): array {
        $request = $GLOBALS['TYPO3_REQUEST'];

        $queryParams = $request->getQueryParams();

        $postUid = (int) (
            $queryParams['tx_t3extblog_blogsystem']['post'] ?? 0
        );

        if ($postUid <= 0) {
            return $processedData;
        }

        $connection = GeneralUtility::makeInstance(
            ConnectionPool::class
        )->getConnectionForTable(
            'tx_t3blog_post'
        );

        $queryBuilder = $connection->createQueryBuilder();

        $post = $queryBuilder
            ->select('uid', 'title')
            ->from('tx_t3blog_post')
            ->where(
                $queryBuilder->expr()->eq(
                    'uid',
                    $queryBuilder->createNamedParameter(
                        $postUid,
                        Connection::PARAM_INT
                    )
                )
            )
            ->executeQuery()
            ->fetchAssociative();

        if (!$post) {
            return $processedData;
        }

        $menuName = $processorConfiguration['addToMenus'] ?? 'breadcrumb';

        if (
            !isset($processedData[$menuName])
            || !is_array($processedData[$menuName])
        ) {
            return $processedData;
        }

        $processedData[$menuName][] = [
            'title' => $post['title'],
            'link' => '',
            'active' => true,
            'current' => true,
        ];

        return $processedData;
    }
}

Die neu angelegte PHP-Klasse bildet den eigentlichen DataProcessor. Sie implementiert das TYPO3-Interface DataProcessorInterface und stellt damit die Methode process() bereit. Diese Methode wird später von TYPO3 aufgerufen und erhält unter anderem die bereits verarbeiteten Daten, die anschließend um den zusätzlichen Breadcrumb-Eintrag erweitert werden.

Im Beispiel wird zunächst die aktuelle Anfrage ausgewertet, um die UID des gewünschten Datensatzes zu ermitteln. Bei einer anderen, individuell entwickelten Extension kann dieser Parameter jedoch anders heißen oder an einer anderen Stelle übergeben werden. Deshalb müssen die Query-Parameter an die jeweilige Extension angepasst werden. Entscheidend ist, dass der DataProcessor die UID des aktuellen Datensatzes kennt.

Anschließend wird über den TYPO3 ConnectionPool eine Datenbankverbindung zur entsprechenden Tabelle hergestellt. Auch der Tabellenname muss bei einer eigenen Extension angepasst werden. Über den QueryBuilder wird der Datensatz anhand seiner UID ausgelesen und anschließend dessen Titel an das bestehende Breadcrumb-Array angehängt. Auf diese Weise lässt sich das Prinzip unabhängig von einer bestimmten Extension verwenden: Datensatz ermitteln, Datenbankeintrag laden und den gewünschten Wert – beispielsweise den Titel – zur Breadcrumb-Navigation hinzufügen.

Über das TypoScript wird der eigene DataProcessor anschließend in den Rendering-Prozess eingebunden. Zunächst wird mit dem menu-DataProcessor die normale Breadcrumb-Navigation aus der Rootline erzeugt und unter dem Namen breadcrumb zur Verfügung gestellt. Der anschließend aufgerufene eigene DataProcessor kann dadurch auf diese bereits vorhandenen Breadcrumb-Daten zugreifen und sie erweitern.

Über die Zeile 451 = Vendor\Extension\DataProcessing\AddRecordToBreadcrumbProcessor wird die zuvor erstellte PHP-Klasse als DataProcessor aufgerufen. Der Namespace und Klassenname sind dabei an die eigene Extension anzupassen. Mit addToMenus = breadcrumb wird zusätzlich festgelegt, welches verarbeitete Daten-Array erweitert werden soll. In diesem Fall handelt es sich um das zuvor erzeugte breadcrumb-Array.

Die Reihenfolge der DataProcessor ist dabei wichtig: Zuerst wird die Rootline als Breadcrumb erzeugt, anschließend wird der eigene Processor ausgeführt und fügt den zusätzlichen Datensatz hinzu. Dadurch entsteht am Ende eine Breadcrumb-Navigation, die sowohl die normalen Seiten der Rootline als auch den aktuellen Datensatz der Extension enthält.

Services.yaml

Falls du den DataProcessor stattdessen als eigenen Alias registrieren möchtest, kann die Configuration/Services.yaml beispielsweise so aussehen:

services:
  Vendor\Extension\DataProcessing\AddRecordToBreadcrumbProcessor:
    tags:
      - name: frontend.data.processor
        identifier: add-record-to-breadcrumb

Die Services.yaml wird verwendet, um den eigenen DataProcessor als TYPO3-Service zu registrieren. Dadurch kann für die PHP-Klasse ein eigener Identifier vergeben werden, über den der DataProcessor später im TypoScript angesprochen wird. Im Beispiel lautet dieser Identifier add-record-to-breadcrumb.

Die eigentliche PHP-Klasse wird unter services: mit ihrem vollständigen Namespace angegeben. Über den Tag frontend.data.processor erkennt TYPO3, dass es sich um einen eigenen DataProcessor für das Frontend handelt. Der Wert identifier definiert anschließend den Namen, unter dem der Processor im TypoScript verwendet werden kann.

Für das hier gezeigte Beispiel ist die Services.yaml allerdings nicht zwingend notwendig. TYPO3 kann einen DataProcessor auch direkt über den vollständigen Klassennamen im TypoScript aufrufen. Die Registrierung über Services.yaml bietet sich insbesondere dann an, wenn der Processor einen eigenen, sprechenden Identifier erhalten und sauber als TYPO3-Service eingebunden werden soll.

Typoscript 

dataProcessing {
    451 = add-record-to-breadcrumb
    451 {
        addToMenus = breadcrumb
    }
}

Damit ist die Einbindung des eigenen DataProcessors in das TypoScript abgeschlossen. Die bestehende Breadcrumb-Navigation wird zunächst wie gewohnt aus der Rootline erzeugt und anschließend durch den eigenen Processor um den aktuellen Datensatz erweitert.

Der große Vorteil dieser Lösung besteht darin, dass die eigentliche Logik vollständig in der PHP-Klasse gekapselt bleibt. Im TypoScript wird lediglich festgelegt, wann der DataProcessor ausgeführt wird und welches Daten-Array er bearbeiten soll. Dadurch bleibt die Konfiguration übersichtlich und der Processor kann bei Bedarf auch für andere Datensätze oder Breadcrumb-Strukturen wiederverwendet werden.

Welche Parameter zur Ermittlung des aktuellen Datensatzes benötigt werden und aus welcher Datenbanktabelle dieser geladen wird, hängt dabei von der jeweiligen Extension ab. Genau diese beiden Stellen müssen bei der Verwendung in einer eigenen Extension entsprechend angepasst werden.

0 comments  
New comment

0 comments