Lernseite · Fluid, Frontend-Ausgabe und Lokalisierung

Vom Controller in den Browser: Fluid, Ausgabe und Übersetzung

Stand 15. November 2026 · TYPO3 14.3 LTS · ca. 24 Min. Lesezeit

Der Controller hat seine Konferenzen geladen. Jetzt soll daraus eine sichere Seite in mehreren Sprachen werden. Auf dieser Seite folgst du den Daten vom Controller bis in den Browser. Unterwegs geht es um Fluid, eigene ViewHelper und Data Processors, um CSS, Seitentitel und Meta-Tags und zuletzt um die Sprachdateien.

Die View und ihr View Model

Im Muster Model-View-Controller holt der Controller die Daten und gibt sie an die View. Die View stellt nur dar, was sie bekommt. Sie fragt keine Datenbank ab und enthält keine Geschäftsregeln. Darum kann es für dieselben Daten mehrere Views geben, zum Beispiel HTML und JSON.

In TYPO3 übernimmt Fluid die Rolle der View. In Extbase übergibt der Controller die Daten mit assign(). Außerhalb von Extbase erzeugst du eine View über das ViewFactoryInterface.

Unser Beispiel ist die Extension my_extension mit dem Modell Conference. Sie zeigt eine Liste mit Blättern und eine Detailseite, auf Deutsch und auf Englisch. Die Liste braucht je Konferenz einen Zeitraum, die Zahl der Vorträge und die Angabe, ob sie ausgebucht ist.

Ein View Model bündelt genau diese Daten und ihre Aufbereitung in einem eigenen Objekt, etwa ConferenceTeaser. Der Controller erzeugt es und übergibt es der View. Das Template bleibt einfach, weil die Werte fertig formatiert vorliegen. Das Domain-Modell bekommt keine Darstellungsmethoden. Und die Aufbereitung lässt sich per Unit-Test prüfen.

Fluid lesen und schreiben

Fluid ist die Template-Engine von TYPO3 und ein eigenes PHP-Paket. TYPO3 14 nutzt Fluid 5. Templates enden seit TYPO3 14 üblicherweise auf .fluid.html, alte Dateien mit .html funktionieren weiter.

Variablen stehen in einfachen geschweiften Klammern, Eigenschaften und Array-Schlüssel erreichst du mit einem Punkt. Doppelte Klammern wie in Twig und PHP-Syntax gibt es in Fluid nicht.

<h2>{conference.title}</h2>
Der Titel der Konferenz in einfachen geschweiften Klammern: conference, Punkt, title.

Bei einem Objekt probiert Fluid nacheinander getTitle(), isTitle() und hasTitle() und erst danach eine öffentliche Eigenschaft. Hat das Modell nur isOnline(), liefert die Variable conference Punkt online also deren Ergebnis. Geschützte Eigenschaften liest Fluid nie direkt.

ViewHelper sind PHP-Klassen, die du als Tag oder inline aufrufst. Der Namensraum f ist überall vorgegeben. Darum funktioniert der ViewHelper f:link.page ohne Import.

  • Der ViewHelper f:if gibt einen Bereich nur aus, wenn die Bedingung zutrifft. Die Zweige stehen in f:then und f:else.
  • Inline, etwa in einem Attribut, nutzt du die Argumente then und else. Inline-Aufrufe brauchen benannte Argumente.
  • Der ViewHelper f:switch vergleicht den Wert aus expression mit mehreren f:case. Passt keiner, greift f:defaultCase.
  • Der ViewHelper f:for läuft über eine Liste. Das Argument as nennt die Variable für das aktuelle Element.
  • Was in f:comment steht, gibt Fluid gar nicht aus, auch nicht als HTML-Kommentar.
<f:if condition="{conferences}">
  <f:then>
    <f:for each="{conferences}" as="conference" iteration="i">
      <li class="{f:if(condition: i.isFirst, then: 'first')}">{i.cycle}. {conference.title}</li>
    </f:for>
  </f:then>
  <f:else>Keine Konferenzen gefunden</f:else>
</f:if>
<button class="{f:if(condition: conference.online, then: 'active', else: 'inactive')}">Live</button>
Fluid-Beispiel. Gibt es Konferenzen, läuft f:for mit der Iterationsvariable i über die Liste. Der erste Eintrag bekommt die Klasse first, jeder zeigt seine Nummer aus i Punkt cycle. Sonst erscheint „Keine Konferenzen gefunden“. Ein Button bekommt inline die Klasse active oder inactive.

Eine leere Liste oder ein leeres Abfrageergebnis gilt in einer Bedingung als falsch, denn Fluid wertet sie über ihre Anzahl aus. Alternativ zählst du mit f:count. Die Iterationsvariable kennt index ab null, cycle ab eins, total, isFirst, isLast, isEven und isOdd.

Neu in Fluid 5:

  • Variablennamen mit einem Unterstrich am Anfang sind reserviert. Legst du so eine Variable an, wirft Fluid eine Exception.
  • Jedes Template, Layout und Partial importiert seine Namensräume selbst. Sie werden nicht mehr vererbt.
  • Einen CDATA-Abschnitt gibt Fluid aus, ignoriert darin aber ViewHelper-Tags und wertet Variablen nur in dreifachen geschweiften Klammern aus. So bettest du CSS oder JavaScript ein.

Eigene Namensräume importierst du im Template mit einem xmlns-Attribut. Global registrierst du sie seit TYPO3 14.1 in der Datei Namespaces.php im Ordner Configuration/Fluid der Extension. Der ältere Weg über SYS.fluid.namespaces in den TYPO3_CONF_VARS funktioniert noch, ist aber veraltet.

Layouts, Partials und Komponenten

Ein Layout ist der gemeinsame Rahmen. Das Template nennt sein Layout mit f:layout und liefert seine Inhalte in Sections. Das Layout holt sie mit dem ViewHelper f:render und dem Argument section.

<!-- Templates/Conference/List.fluid.html -->
<f:layout name="Default" />
<f:section name="Main">…Liste…</f:section>

<!-- Layouts/Default.fluid.html -->
<main><f:render section="Main" /></main>
<aside><f:render section="Sidebar" optional="true" /></aside>
Das Template List nennt mit f:layout das Layout Default und liefert die Section Main. Das Layout rendert Main und die Section Sidebar, diese mit optional gleich true.

Fehlt eine Section, wirft f:render eine Exception. Mit optional gleich true rendert es dann einfach nichts. Das Argument default legt dagegen einen Ersatztext fest, falls Section oder Partial fehlen.

Ein Partial ist ein wiederverwendbares Stück, etwa die Karte einer Konferenz. Es sieht nur die Variablen, die du ihm in arguments mitgibst. Fluid findet es über die partialRootPaths.

Eine Komponente ist ein reines Fluid-Template mit typisierten Argumenten. Sie gehört zu einer Component Collection, die du in der Datei ComponentCollections.php im Ordner Configuration/Fluid anmeldest. Danach nutzt du sie wie einen eigenen Tag, in jedem Template und ohne partialRootPaths. Mit f:argument legt sie Name und Typ ihrer Argumente fest. Mit f:slot gibt sie den Inhalt zwischen ihren Tags aus. ViewHelper, die einen übergeordneten ViewHelper suchen, funktionieren darin nicht.

<f:argument name="title" type="string" />
<div class="card"><h3>{title}</h3><f:slot /></div>

<my:card title="{conference.title}"><p>Ausgebucht</p></my:card>
Eine Komponente mit dem Argument title vom Typ string. Sie zeigt den Titel und darunter mit f:slot ihren Inhalt. Darunter der Aufruf als Tag my:card.

Sichere Ausgabe: XSS und Escaping

Bei Cross-Site-Scripting, kurz XSS, läuft fremdes JavaScript im Browser eines Opfers, etwa um seine Sitzung zu übernehmen. Es gibt drei Arten:

  • Stored XSS: Der Schadcode wird gespeichert und anderen Benutzern ausgeliefert.
  • Reflected XSS: Der Schadcode aus der Anfrage landet direkt in der Antwort.
  • DOM-based XSS: JavaScript im Browser fügt den Schadcode in die Seite ein.

Fluid maskiert jede Ausgabe einer Variablen mit der PHP-Funktion htmlspecialchars, egal welche Dateiendung das Template hat.

Drei Stellen musst du kennen:

  • Der ViewHelper f:format.raw gibt einen Wert ohne Maskierung aus. Nimm ihn nur für vertrauenswürdige Inhalte, nie für Benutzereingaben.
  • Für HTML aus dem Rich-Text-Editor gibt es f:format.html. Er schickt den Text durch lib.parseFunc_RTE. Das wandelt interne Links in URLs um und ruft danach den HTML-Sanitizer auf. Der lässt nur erlaubte Tags und Attribute durch und entfernt etwa Script-Tags und Event-Handler.
  • Werte in ViewHelper-Argumenten maskiert Fluid nicht. Das muss der ViewHelper selbst tun.

Maskieren muss zum Kontext passen. In JavaScript oder in einem Link, der mit javascript beginnt, reicht HTML-Maskierung nicht. Werte für Skripte gibst du besser als data-Attribut oder JSON weiter.

Zusätzlich schützen zwei Dinge. Eine Content Security Policy ist ein HTTP-Header. Er legt fest, aus welchen Quellen der Browser Skripte, Styles, Bilder und andere Ressourcen laden darf, und blockiert etwa eingeschleuste Inline-Skripte. TYPO3 hat dafür eine eigene API, im Frontend zum Beispiel über eine Datei csp.yaml in der Site-Konfiguration. Verstöße zeigt die Browserkonsole. Das Cookie-Attribut HttpOnly verhindert, dass JavaScript Session-Cookies liest. Beides ersetzt das Maskieren aber nicht.

Eigene ViewHelper

Für die Liste schreiben wir einen ViewHelper, der den Zeitraum formatiert. Fluid 5 bietet drei Basisklassen: AbstractViewHelper als allgemeine Basis, AbstractTagBasedViewHelper mit einem TagBuilder für HTML-Tags und AbstractConditionViewHelper für Bedingungen.

Argumente registrierst du in initializeArguments() mit registerArgument(). Beim Rendern stehen die Werte in der Eigenschaft arguments. Fluid 5 prüft Typen strenger, wandelt einfache Typen wie int aber automatisch in string um. Union-Typen wie array oder string sind erlaubt. Die Methode validateArguments() gibt es nicht mehr.

namespace MyVendor\MyExtension\ViewHelpers;

final class DateRangeViewHelper extends AbstractViewHelper
{
    public function initializeArguments(): void
    {
        $this->registerArgument('start', \DateTimeInterface::class, 'Beginn', true);
        $this->registerArgument('end', \DateTimeInterface::class, 'Ende', true);
    }

    public function render(): string
    {
        return $this->arguments['start']->format('d.') . ' bis ' . $this->arguments['end']->format('d.m.Y');
    }
}
Codebeispiel. DateRangeViewHelper erweitert AbstractViewHelper, registriert die Pflichtargumente start und end und baut in render den Zeitraum. Im Template heißt er my:dateRange.

Soll ein ViewHelper seinen Wert auch ohne Argument bekommen, ruft er renderChildren() auf. Das liefert den Inhalt zwischen seinen Tags oder den Wert, der inline mit dem Pfeil übergeben wurde.

<m:format>{value}</m:format>
{value -> m:format()}
Zwei Schreibweisen für denselben ViewHelper: der Wert zwischen den Tags oder inline mit dem Pfeil übergeben.

Standardmäßig maskiert Fluid die Ausgabe eines ViewHelpers. Setzt du die Eigenschaft escapeOutput auf false, muss render() Benutzereingaben selbst gegen XSS maskieren. Den Inhalt zwischen den Tags maskiert Fluid dann weiter, denn ohne eigene Angabe schaltet es escapeChildren ein.

Ein eigener Bedingungs-ViewHelper, etwa für „ausgebucht“, erbt von AbstractConditionViewHelper und implementiert nur die statische Methode verdict(). Sie bekommt die Argumente und den Rendering-Kontext und gibt wahr oder falsch zurück. Then und else übernimmt die Basisklasse.

Seitentemplates, Data Processors und USER

Nicht jede Ausgabe hat einen Controller. Das TypoScript-Objekt PAGEVIEW rendert eine ganze Seite mit Fluid. Du gibst nur Basispfade an. Das Template liegt im Unterordner Pages und heißt wie das Seitenlayout, etwa Default.fluid.html. Layouts und Partials liegen in Layouts und Partials. Ohne weitere Konfiguration stehen page, site, language und settings bereit, die Settings aus Site Sets und Konstanten. Die Variable data gehört dagegen zu Inhaltselementen, etwa bei FLUIDTEMPLATE.

Weitere Daten liefern Data Processors unter dataProcessing. Das Template muss sie dann nicht selbst holen.

  • Der Processor menu baut ein Menü wie HMENU, standardmäßig in der Variable menu. Jeder Eintrag bietet title, link, active für den Pfad zur aktuellen Seite, current für die Seite selbst und children für die nächste Ebene.
  • Der Processor files lädt Dateien, etwa über references.fieldName aus dem Feld image, als Dateireferenzen in die Variable files.
  • Der Processor database-query lädt Datensätze wie CONTENT, also mit Beachtung von versteckten, gelöschten und übersetzten Datensätzen. Jede Zeile steht im Schlüssel data. Ohne as heißt die Variable records.
  • Der Processor language-menu liefert je Sprache unter anderem title, link, active und available. Ist die Seite in einer Sprache nicht übersetzt, ist available null.
page.10 = PAGEVIEW
page.10.paths.10 = EXT:site_package/Resources/Private/Templates/
page.10.dataProcessing {
  10 = menu
  10.levels = 2
  20 = database-query
  20.table = tx_myext_partner
  20.pidInList = 30
  20.as = partners
  30 = upcoming-conferences
  30.limit = 3
}
TypoScript-Beispiel. Ein PAGEVIEW mit dem Pfad zu den Templates. Processor 10 baut ein Menü über zwei Ebenen. Processor 20 lädt Partner aus dem Ordner 30 in die Variable partners, im Template dann partner Punkt data Punkt name. Processor 30 ist unser eigener Alias upcoming-conferences.

Einen eigenen Data Processor schreibst du mit dem DataProcessorInterface. Seine Methode process() bekommt den ContentObjectRenderer, die Konfiguration des Inhaltsobjekts, die Konfiguration des Processors und die bisher verarbeiteten Daten. Diese Daten enthalten die Ergebnisse früherer Processors. Du ergänzt sie und gibst sie zurück.

$limit = (int)$cObj->stdWrapValue('limit', $processorConfiguration, 3);
$as = $cObj->stdWrapValue('as', $processorConfiguration, 'upcomingConferences');
$processedData[$as] = $this->conferenceService->findUpcoming($limit);
return $processedData;
Aus der Methode process. Sie liest limit und as mit stdWrapValue, jeweils mit Standardwert, legt die nächsten Konferenzen in die Daten und gibt sie zurück.

Liest du Optionen mit stdWrapValue(), funktionieren alle stdWrap-Eigenschaften. Den kurzen Alias vergibst du in der Services.yaml mit dem Tag data.processor und dem Schlüssel identifier. Der Tag erlaubt zugleich Dependency Injection, ohne die Klasse öffentlich zu machen. Für verschachtelte dataProcessing-Schritte je Ergebnis rufst du den ContentDataProcessor mit seiner Methode process() auf.

USER und USER_INT rufen per userFunc eine PHP-Methode auf. Seit TYPO3 14 braucht sie das Attribut AsAllowedCallable, sonst wirft TYPO3 eine AllowedCallableException. Das gilt auch für preUserFuncInt, postUserFunc und postUserFuncInt in stdWrap. Die Methode bekommt den Inhalt, ihre Konfiguration und den Request mit dem Attribut currentContentObject. Hat die Klasse setContentObjectRenderer(), ruft TYPO3 auch diese Methode auf.

Die Ausgabe von USER landet mit der Seite im Cache. Bei USER_INT steht im Seitencache nur ein Platzhalter INT_SCRIPT. Bei jedem Aufruf wird nur dieser Teil neu gerendert, mit Kosten bei jedem Request. Dasselbe gilt für COA und COA_INT. Ein Extbase-Plugin läuft als USER. Steht die aufgerufene Action im vierten Argument von configurePlugin(), wird es zu USER_INT.

CSS, JavaScript und Kopfdaten

Die Detailseite braucht ein Stylesheet und ein Skript für eine Karte. Der AssetCollector sammelt CSS und JavaScript während des Renderns. Jedes Asset hat einen Identifier und erscheint nur einmal. Steht unser Plugin fünfmal auf der Seite, kommt das Stylesheet trotzdem nur einmal. Bei gleichem Identifier überschreiben spätere Attribute frühere. Mit hasStyleSheet() prüfst du vorab.

<f:asset.css identifier="conference" href="EXT:my_extension/Resources/Public/Css/conference.css" />
<f:asset.script identifier="conference-map" src="EXT:my_extension/Resources/Public/JavaScript/map.js" />
f:asset.css bindet conference.css mit dem Identifier conference ein, f:asset.script das Skript map.js mit dem Identifier conference-map.

Im Template nimmst du f:asset.css und f:asset.script, in PHP addStyleSheet() und addJavaScript(). Beides bindet die Datei nur ein, wenn das Plugin gerendert wird. Die TypoScript-Einstellung page.includeCSS bindet sie dagegen auf jeder Seite ein.

Die Option priority entscheidet über den Ort. JavaScript mit priority steht im head, ohne am Ende des body. CSS steht immer im head und wird nur nach priority gruppiert. Assets aus dem AssetCollector folgen auf die Dateien aus TypoScript.

Wohin mit CSS und JavaScript? Gehört zu einem Template oder Inhaltselement f:asset.css f:asset.script Hängt von Logik im Controller ab AssetCollector addStyleSheet() Andere Kopfdaten, etwa ein preconnect-Link f:page.headerData oder PageRenderer Haupt-CSS und -JS der ganzen Website TypoScript page.includeCSS Gleicher Identifier: Asset erscheint nur einmal.
Welches Werkzeug für welches Asset?

Neu in TYPO3 14: Die Option useNonce heißt jetzt csp, das alte Argument ist veraltet. Die Option external ist entfallen. Relative URLs schreibst du stattdessen mit dem Präfix URI und einem Doppelpunkt. Zusammenfassen und Komprimieren gibt es im Core nicht mehr. Die Optionen concatenateJs, concatenateCss, compressJs und compressCss unter config sind wirkungslos. includeCSS und includeJS bleiben.

Der PageRenderer baut das HTML-Gerüst im Frontend und Backend und rendert alle Assets und Kopfdaten. Du bekommst ihn per Dependency Injection. Er bietet etwa addCssFile(), addJsFooterFile(), addJsInlineCode() und addHeaderData().

Für beliebiges Markup im Kopf, etwa einen preconnect-Link, gibt es seit TYPO3 14 den ViewHelper f:page.headerData, für das Seitenende f:page.footerData. Sie ersetzen die veralteten Sections HeaderAssets und FooterAssets. Der ViewHelper f:asset.css ist nur für Stylesheets gedacht.

Seitentitel, Meta-Tags und Blättern

Den Titel im Browser-Tab bestimmt die PageTitle API. Mehrere Page Title Provider liefern Vorschläge. TYPO3 fragt sie in der Reihenfolge ab, die config.pageTitleProviders mit before und after festlegt. Der erste nicht leere Titel gewinnt. Der Standard-Provider record liefert immer einen Wert, eigene Provider müssen also davor stehen.

EXT:seo ergänzt die Seiteneigenschaften um das Feld seo_title. Ist es gefüllt, steht dieser Text im title-Tag statt des Seitentitels. Der Navigationstitel wirkt nur in Menüs. Der websiteTitle ist der Name der ganzen Website.

Für die Detailseite gibt es in TYPO3 14 drei Wege zum Titel der Konferenz:

  • Im Template mit dem neuen ViewHelper f:page.title.
  • In PHP mit dem neuen RecordTitleProvider und dessen Methode setTitle().
  • Mit einem eigenen Provider auf Basis von AbstractPageTitleProvider, registriert in config.pageTitleProviders.

Meta-Tags: Das Meta-Tag description liefert Suchmaschinen die Kurzbeschreibung für die Ergebnisliste. Redakteure pflegen es in den Seiteneigenschaften. Das Meta-Tag robots steuert dagegen das Indexieren.

In PHP nutzt du die MetaTag API. Die injizierte MetaTagManagerRegistry liefert mit getManagerForProperty() den zuständigen Manager, für og:title den für OpenGraph. Mit addProperty() setzt du den Wert, auch mit Unterangaben wie og:image:width. Dazu gibt es removeProperty() und removeAllProperties().

$this->metaTagManagerRegistry->getManagerForProperty('og:title')
    ->addProperty('og:title', $conference->getTitle());
Die Registry liefert den Manager für og:title, und addProperty setzt og:title auf den Titel der Konferenz.
<f:page.meta property="og:title">{conference.title}</f:page.meta>
Dasselbe in Fluid mit dem neuen ViewHelper f:page.meta.

Brauchst du dasselbe Meta-Tag mehrmals, schreibst du einen eigenen Manager mit dem MetaTagManagerInterface. Du registrierst ihn in der ext_localconf.php bei der Registry, mit before und after für die Reihenfolge.

Blättern: Die Pagination API teilt lange Listen in Seiten mit fester Eintragszahl. Ein Paginator lädt die Einträge der aktuellen Seite: ArrayPaginator für Arrays, QueryResultPaginator für Extbase-Ergebnisse und neu in TYPO3 14 QueryBuilderPaginator für den QueryBuilder. Eine Pagination berechnet nur die Navigation. SimplePagination zeigt alle Seitenzahlen, SlidingWindowPagination nur ein Fenster um die aktuelle Seite.

$paginator = new QueryResultPaginator($conferences, $currentPage, 10);
$pagination = new SlidingWindowPagination($paginator, 5);
$this->view->assignMultiple(['paginator' => $paginator, 'pagination' => $pagination]);
Ein QueryResultPaginator teilt die Konferenzen in Seiten zu zehn Einträgen, eine SlidingWindowPagination zeigt höchstens fünf Seitenzahlen. Beide gehen an die View.

Internationalisierung und Lokalisierung

i18n steht für Internationalization, die 18 zählt die Buchstaben zwischen i und n. Gemeint ist, die Software technisch für mehrere Sprachen und Regionen vorzubereiten:

  • Texte stehen in Sprachdateien wie XLIFF statt im Code.
  • Die Software nutzt durchgängig Unicode, also UTF-8.
  • Datum, Zahlen und Währung erscheinen im Format des Locale.
  • Layouts haben Platz für längere Texte und Schreibrichtungen wie Arabisch.

Lokalisierung, kurz l10n, passt die Software an eine konkrete Region an. Das ist mehr als Übersetzen. Aus 1.234,56 in Deutschland wird 1,234.56 in den USA. Pluralregeln unterscheiden sich. Bilder, Beispiele und rechtliche Angaben müssen zur Region passen. Für einheitliche Übersetzungen hilft ein Glossar. Gib Übersetzern Kontext, etwa Beschreibungen zu den Schlüsseln. Nutze Platzhalter statt zusammengesetzter Satzteile, denn die Wortstellung ist je Sprache anders.

In der Site-Konfiguration legst du je Sprache unter anderem das locale fest, etwa de_DE.UTF-8, die base, etwa /en/, dazu hreflang, navigationTitle und den fallbackType, etwa strict oder fallback. Alle Sprachen teilen sich eine Datenbank. Übersetzte Datensätze verweisen über l10n_parent auf ihr Original.

Formate: Der ViewHelper f:format.date nutzt mit dem Argument pattern ICU-Muster und das Locale des Requests, bei Bedarf ein festes locale. So steht auf der deutschen Seite „Oktober“, auf der englischen „October“. Das Argument format nutzt dagegen die PHP-Funktion date und liefert Monatsnamen immer englisch.

<f:format.date pattern="d. MMMM y">{conference.startDate}</f:format.date>
<f:format.currency currencySign="€" decimalSeparator="," thousandsSeparator=".">{price}</f:format.currency>
f:format.date mit dem ICU-Muster d Punkt MMMM y gibt den 15. Oktober 2026 aus, englisch 15 October 2026. f:format.currency gibt den Preis mit Euro-Zeichen, Komma und Tausenderpunkt aus.

Der ViewHelper f:format.currency gibt zwei Nachkommastellen aus, seine Standardtrenner sind schon Komma und Punkt. Das Währungszeichen steht mit Leerzeichen hinter der Zahl. Aus 1234.5 wird also „1.234,50 €“. Der ViewHelper f:format.number trennt standardmäßig umgekehrt, mit Punkt für Dezimalen und Komma für Tausender.

Labels mit XLIFF übersetzen

Feste Texte wie „Ausgebucht“ heißen Labels. TYPO3 speichert sie in XLIFF-Dateien mit der Endung .xlf, nicht in Gettext-Dateien. Sie liegen in Resources/Private/Language: locallang.xlf für allgemeine Labels, locallang_db.xlf für das TCA. Die Quelldatei ist englisch und hat weder target-language noch target-Elemente. Die deutsche Übersetzung liegt daneben mit Sprachpräfix, also de.locallang.xlf.

<xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
  <file source-language="en" target-language="de" datatype="plaintext" original="messages">
    <body>
      <trans-unit id="conference.soldOut">
        <source>Sold out</source>
        <target>Ausgebucht</target>
      </trans-unit>
    </body>
  </file>
</xliff>
XLIFF 1.2 einer deutschen Übersetzungsdatei. Das Element file nennt Englisch als Ausgangs- und Deutsch als Zielsprache. Im body steht eine trans-unit mit der id conference.soldOut, mit source „Sold out“ und target „Ausgebucht“.

Seit TYPO3 14 liest TYPO3 auch XLIFF 2.0, dort mit unit und segment statt trans-unit. Intern nutzt es die Komponente Symfony Translation. Eigene Parser werden nicht mehr unterstützt.

Wo sucht TYPO3 ein Label? de_CH.locallang.xlf Schweizerdeutsch Schlüssel fehlt de.locallang.xlf Deutsch Schlüssel fehlt locallang.xlf englische Quelldatei Schlüssel fehlt default-Argument sonst leere Ausgabe Übersetzungen mit approved="no" werden übersprungen.
Fehlt eine Übersetzung, fällt TYPO3 auf die nächste Datei zurück.

Fehlt in de.locallang.xlf ein Schlüssel, zeigt die deutsche Seite also den englischen Text. Übersetzungen mit approved gleich no ignoriert TYPO3 ebenfalls, denn die Einstellung LANG.requireApprovedLocalizations ist standardmäßig eingeschaltet.

Translation Domains sind neu in TYPO3 14. Statt des langen Pfads schreibst du my_extension.messages, einen Doppelpunkt und den Schlüssel. Das Präfix locallang mit Unterstrich entfällt: Aus locallang.xlf wird messages, aus locallang_db.xlf wird db. Die klassische Schreibweise mit LLL bleibt gültig.

<f:translate key="conference.soldOut" domain="my_extension" />
<f:translate key="my_extension.messages:conference.soldOut" />
<f:translate key="LLL:EXT:my_extension/Resources/Private/Language/locallang.xlf:conference.soldOut" />

<f:translate key="list.count" arguments="{0: total}" />
<f:translate key="talks.count" arguments="{count: 3}" />
Drei gültige Schreibweisen für f:translate: mit dem Argument domain, mit der Domain im Schlüssel und mit dem vollen Pfad. Darunter Argumente als Liste mit dem Schlüssel null und als benanntes Argument count.

Sind domain und extensionName gesetzt, gewinnt domain. Im Extbase-Template genügt der Schlüssel aus der eigenen locallang.xlf. Gibst du arguments als Liste, ersetzt TYPO3 Platzhalter wie Prozent d und Prozent s mit vsprintf. Benannte Argumente wertet TYPO3 14 als ICU-Nachricht mit Platzhaltern in geschweiften Klammern aus, auch mit Pluralformen. Der Inhalt des Tags dient nur als Standardtext.

In PHP übersetzt du mit LocalizationUtility::translate() oder dem LanguageService. Labels in TCA und FlexForms schreibst du ebenfalls als Referenz, zum Beispiel mit der Domain my_extension.db.

Sprachpakete für Core und TER-Extensions entstehen gemeinschaftlich auf Crowdin. Du installierst sie im Modul Maintenance unter Manage Language Packs oder mit dem Befehl language:update. Eigene Anpassungen trägst du unter LANG.resourceOverrides ein, früher locallangXMLOverride.

Das Wichtigste in Kürze

  • Die View stellt nur dar. View Models liefern ihr fertig aufbereitete Daten.
  • Fluid probiert get, is und has, dann eine öffentliche Eigenschaft.
  • Fluid 5 verbietet Variablen mit Unterstrich am Anfang und vererbt keine Namensräume.
  • Fluid maskiert jede Variable. f:format.raw hebt das auf, f:format.html ist für Rich-Text.
  • Argumente maskiert Fluid nicht, das muss der ViewHelper tun.
  • Bedingungs-ViewHelper implementieren nur verdict().
  • Data Processors liefern fertige Variablen, ein Alias entsteht über den Tag data.processor.
  • USER wird gecacht, USER_INT steht als Platzhalter im Cache. Jede userFunc braucht AsAllowedCallable.
  • Der AssetCollector bindet jedes Asset je Identifier nur einmal ein.
  • Neu sind f:page.title, f:page.meta, f:page.headerData und f:page.footerData.
  • Fehlt eine Übersetzung, erscheint der englische Ausgangstext.

Begriffe

Data Processor
PHP-Klasse, die Daten für ein Fluid-Template aufbereitet.
Escaping
Sonderzeichen so umwandeln, dass sie als Text statt als Code erscheinen.
i18n
Internationalisierung, die technische Vorbereitung auf mehrere Sprachen.
l10n
Lokalisierung, die Anpassung an eine konkrete Sprache und Region.
Locale
Sprache plus Region, etwa de_DE, steuert die Formate.
PAGEVIEW
TypoScript-Objekt, das ein Fluid-Seitentemplate rendert.
Translation Domain
Kurzer Name für eine Sprachdatei, etwa my_extension.messages.
View Model
Objekt mit genau den Daten, die ein Template braucht.
ViewHelper
PHP-Klasse, die man in Fluid als Tag oder inline aufruft.
XLIFF
XML-Format für Übersetzungen.

Stand: 15. November 2026 (TYPO3 14.3 LTS)

Quellen:

  • TYPO3 Explained 14.3, Kapitel Fluid, Frontend Rendering (AssetCollector, PageRenderer, PageTitle API, MetaTag API, Pagination) und Localization
  • Fluid-Dokumentation für typo3fluid/fluid 5 (Syntax, Escaping, Komponenten, eigene ViewHelper)
  • TypoScript-Referenz 14.3, PAGEVIEW, dataProcessing, USER und USER_INT
  • Changelog TYPO3 14.0 bis 14.3 (Fluid 5, Namespaces.php, Translation Domains, XLIFF 2.0, f:page-ViewHelper, AssetCollector)
  • Quellcode TYPO3 14.3 und Fluid 5, geprüft für Variablenauflösung, Escaping, f:translate, AssetCollector und Format-ViewHelper
  • Lernzielkatalog TYPO3 CMS Certified Developer 14 LTS

Diese Lernseite ist mit KI erstellt und gegen die Quellen geprüft.

Zertifikate & Prüfungen

Welche Prüfung kommt als Nächstes?

51 Prüfungen kannst du schon üben, über 16 stimmst du gerade ab. Sieh dir alle Zertifikate mit offiziellen Infos an, gib deine Stimme ab oder schlag deine Prüfung vor.

Zur Zertifikatsübersicht