Navigation als TypoScript Library in TYPO3 Webseite

Die Navigation in einer TYPO3-Webseite wird im Allgemeinen über TypoScript aufgebaut. Dieser Teilbereich von TypoScript stellt mehrere Möglichkeiten bereit, eine Navigation aufzubauen. Im Regelfall schreibt man jedes Modul der Navigation in ein eigene TypoScript-Datei, die man dann als Library einbindet.

Auch mit dem ►VHS Viewhelper können Sie eine Navigation aufbauen - nützlich vor allem dann, wenn Sie mit Bedingungen (Conditions) unterschiedliche Inhalte darstellen möchten.

Libraries für TypoScript in TYPO3

In der täglichen Arbeit mit TypoScript zum Aufbau von Webseiten mit TYPO3 hat es sich als Best Practice herausgestellt, die einzelnen Module der Navigation in Dateien zu speichern, die man als lib. Dateien ins System einbindet. Dies bietet mehrere Vorteile:

  • Bei der Kontrolle der ins System eingebundenen Libraries tauchen die Funktionen für die Navigation zusammen mit den anderen Elementen im TypoScript Objekt Browser auf
  • Die Dateien sind versionierbar und können von mehreren Entwicklern unabhängig voneinander bearbeitet werden
  • Als lib. benannte Funktionen können in den Cache geladen werden und sparen damit im Gegensatz zu temp. Dateien Ladezeit

Einbindung einer TypoScript Datei und Funktion

Die Datei kann dann über das Setup ins System eingebunden werden:

@import "EXT:ibkprovider/Configuration/TypoScript/Library/lib.navigation.ts"

Damit steht dem System eine Lib bereit, die Sie über den TypoScript Objekt Browser kontrollieren können. Dort bekommen Sie den Namen der Funktion angezeigt, die Sie nun dort in Ihr Fluid Template einbinden, wo Sie Ihre Navigation benötigen:

<f:cObject typoscriptObjectPath="lib.navigation" />

Damit steht Ihnen die Navigation in Ihrer Webseite zur Verfügung. 

Beachten Sie:
Mit dem @import Befehl binden Sie eine Datei ein.
Der typoscriptObjectPath Befehl bindet eine Funktion ein.

Library Verzeichnis für TypoScript Navigation

In den wenigsten Fällen reicht eine einzige Funktion aus, um die Navigation einer Webseite bereitzustellen. Im Normalfall benötigt man weitere Bestandteile der Navigation, etwa für eine Breadcrumb Navigation oder besondere Seiten. In solchen Fällen bietet es sich an, Verzeichnisse für TypoScript anzulegen und mehrere Dateien zu erstellen, die man ins System lädt. 

Eine Verzeichnisstruktur kann folgendermaßen aussehen:

TypoScript
         ├── Setup
         └── Library
                   ├── Search
                   ├── Navigation
                   └── Includes

Im Verzeichnis Navigation legt man nun die einzelnen TypoScript Dateien für die weiteren Bestandteile der Navigation ab. Die Einbindung der Dateien erfolgt nun analog zu der Top Navigation auf der Webseite:

 @import "EXT:ibkprovider/Configuration/TypoScript/Library/Navigation/lib.breadcrumb.ts"
@import "EXT:ibkprovider/Configuration/TypoScript/Library/Navigation/lib.special.ts"

Beispiele für Navigation mit TypoScript

Sehen Sie hier einige Beispiele für eine Navigation mit TypoScript:

Thomas Berscheid, 02.12.2019 22:59
^