Lokalisierung
Beschriftungen im Frontend wie Check availability and book, Adults, Room occupancy und Book now sind nicht fest in den Templates hinterlegt. Sie stammen aus XLF-Übersetzungsdateien und richten sich nach der TYPO3-Sprache der Site der gerade gerenderten Seite.
Dieses Kapitel erklärt, wer welchen Text ändern kann, wie Übersetzungen funktionieren und wo das Handbuch der Extension veröffentlicht wird.
So werden Beschriftungen ermittelt
Die Beschriftungen werden in Ebenen angewendet (für Überschreibungen durch Redakteure gewinnt die höchste Priorität):
- FlexForm-Reiter Texts – pro Inhaltselement, nur Überschrift und primäre Buttons. Leeres Feld = Ebene 2 oder 3 verwenden.
- TypoScript
_LOCAL_LANG– Formulierungen für die ganze Site, für Integratoren (keine zusätzlichen FlexForm-Felder). - Mitgeliefertes XLF –
Resources/Private/Language/locallang.xlf(englische Quelle) undde.locallang.xlf(Deutsch). Weitere Sprachen überit.locallang.xlfusw. oder über einlocallangXMLOverrideim Sitepackage.
Per JavaScript erzeugte Bedienelemente (Zimmer im Kalender hinzufügen, dynamische Stepper) lesen dieselben Übersetzungen aus window.CB_LABELS. Der Controller erzeugt über den LabelResolver ein JSON (cbLabelsJson). Ein verstecktes Element .cb-labels-json und ein Inline-Skript führen es in window.CB_LABELS zusammen, bevor widget.js läuft.
Sprache der Site (automatische Übersetzung)
Öffnet ein Besucher eine deutsche Sprachversion der Site, lädt TYPO3 die Datei de.locallang.xlf, und Texte wie Adults werden zu Erwachsene.
Ist die Demo-Seite englisch, siehst du die englischen Quelltexte aus locallang.xlf. Für die Standardbeschriftungen in EN/DE ist keine FlexForm-Konfiguration nötig.
Hinweise zur Belegung, die Kalenderlegende, Lademeldungen und Fehlertexte werden immer über XLF übersetzt. Sie sind keine FlexForm-Felder.
FlexForm-Reiter Texts (für Redakteure)
Jedes Plugin hat im Inhaltselement einen Reiter Texts.
Lass ein Feld leer, um die Standardübersetzung für die aktuelle Seitensprache zu behalten.
| Plugin | FlexForm-Schlüssel | Wenn leer |
|---|---|---|
| Widget | labels.heading labels.bookNow labels.enquiry | widget.heading.default oder Zimmername, widget.calendar.bookNow, widget.calendar.enquiry |
| Search bar | labels.heading labels.submit | searchbar.heading, searchbar.submit |
| Room types | labels.heading labels.book labels.details | roomtypes.heading (nur Übersicht), roomtypes.book, roomtypes.details |
| Packages | labels.heading labels.book labels.details | packages.heading (nur Übersicht), packages.book / packages.bookNow, packages.details |
| Price teaser | labels.heading | Keine Überschrift (nur die Preiszeile) |
Beschriftungen, die nicht in FlexForm stehen (nur XLF / _LOCAL_LANG): Adults, Children, Room occupancy, Kalenderlegende, Loading availability…, from, leere Zustände, Texte des Backend-Moduls.
TypoScript _LOCAL_LANG (für Integratoren)
Überschreibe jeden locallang-Schlüssel für die ganze Site, ohne FlexForm zu verwenden:
plugin.tx_casablancabooking._LOCAL_LANG.de {
widget.heading.default = Jetzt Verfügbarkeit prüfen
widget.adults = Erwachsene
widget.calendar.bookNow = Zur Buchung
widget.calendar.occupancy = Gäste
}
plugin.tx_casablancabooking._LOCAL_LANG.en {
widget.calendar.bookNow = Reserve now
}
Signaturen pro Plugin (wenn du Überschreibungen nur für ein Plugin brauchst):
plugin.tx_casablancabooking_widget._LOCAL_LANG.de {
widget.heading.default = Verfügbarkeit prüfen
}
Neue Sprache hinzufügen
- Kopiere
locallang.xlfnachResources/Private/Language/fr.locallang.xlf(oder ergänze<target>-Einträge in einer Override-Datei im Sitepackage). - Registriere die Sprache in der TYPO3-Site-Konfiguration.
- Leere die Caches.
Agenturen können Überschreibungen auch im Sitepackage mitliefern:
plugin.tx_casablancabooking._LOCAL_LANG.fr {
widget.adults = Adultes
}
Locallang-Schlüssel (Frontend)
Häufig von Agenturen überschriebene Schlüssel:
| Schlüssel | Standard (EN) |
|---|---|
widget.heading.default | Check availability and book |
widget.heading.room | Availability for %s |
widget.adults | Adults |
widget.children | Children |
widget.rooms.count | Rooms |
widget.calendar.occupancy | Room occupancy |
widget.calendar.bookNow | Book now |
widget.calendar.enquiry | Enquiry |
widget.calendar.addRoom | Add another room |
searchbar.heading | Search availability |
searchbar.submit | Search & book |
searchbar.occupancyToggle | Guests and rooms |
roomtypes.heading | Our rooms |
roomtypes.book | Book now |
packages.heading | Packages & offers |
widget.legend.available | Available |
widget.calendar.loading | Loading availability… |
Die vollständige Liste steht in Resources/Private/Language/locallang.xlf.
JavaScript-Labels
Resources/Public/JavaScript/widget.js darf keine für Nutzer sichtbaren englischen Texte enthalten. Dynamische Zimmerblöcke lesen window.CB_LABELS:
adults,children,childrenAgescalendarBookNow,calendarRemoveRoom,roomNusw.
Resources/Private/Partials/Calendar/LabelsScript.html gibt CB_LABELS aus denselben Übersetzungen aus (und aus FlexForm-Überschreibungen für die Buttons Buchen/Anfrage). Überschreibst du eine Beschriftung in Fluid, leere die Caches, damit das Inline-Skript neu erzeugt wird.
Fluid-ViewHelper
Templates verwenden casablanca:label für Überschriften und Call-to-Actions mit optionaler Überschreibung aus FlexForm:
<casablanca:label key="widget.calendar.bookNow"
override="{labels.bookNow}"
default="Book now" />
So findest du das Handbuch
Der Ordner Documentation/ in dieser Extension ist das offizielle TYPO3-Extension-Handbuch (reStructuredText). Nach der Installation wird es nicht im TYPO3-Backend angezeigt. Redakteure durchsuchen im CMS keine .rst-Dateien.
Hier siehst du das Handbuch tatsächlich:
- docs.typo3.org – nach der Veröffentlichung der Extension (Composer / TER) baut TYPO3 Intercept aus
Documentation/HTML und hostet es auf docs.typo3.org. Die TER-Seite der Extension verlinkt auf dieses Handbuch. - Git / Composer – die Quelldateien liegen im Repository bzw. nach
composer requireuntervendor/casablanca/bookingengine-connector/Documentation/. - README.md – kurzer Überblick auf GitHub und Packagist.
Lokale HTML-Vorschau (nur für Autoren):
docker run --rm -it \
-v $(pwd):/project \
ghcr.io/typo3-documentation/render-guides:latest \
--path Documentation
Öffne das erzeugte HTML in Documentation-GENERATED-temp/ im Browser. Das ist zum Schreiben und Prüfen der Doku gedacht, nicht für Redakteure im Hotel.
Siehe auch: Inhaltselemente (FlexForm-Texte pro Plugin).