Neu in 5.3.50 Was sich gegenüber 5.3.48 geändert hat
Die wichtigste Änderung betrifft die Installation unmittelbar:
EXT:t3sb_package wird nicht mehr benötigt.
Alle Dateien, die t3sbootstrap selbst erzeugt, liegen standardmäßig unter typo3temp/assets/t3sbootstrap/ — seit 5.3.59 lässt sich dieses Verzeichnis verlegen.
Neue Ablage
TypoScript/– t3sbconstants & t3sbsetupT3SB-SCSS/– custom-variables-x.scss, custom-x.scssT3SB-CSS/,T3SB-JS/– Dateien aus „CDN to local“T3SB-Bootstrap/– Bootstrap-Quellencss/– kompiliertes CSS
Was das bedeutet
- Bei einer Neuinstallation entfällt der Download von t3sb_package – auch ohne Composer.
- Die Datenbank ist die einzige Quelle. Fehlende TypoScript- und SCSS-Dateien werden beim nächsten Frontend-Aufruf automatisch neu geschrieben.
- Nur die per „CDN to local“ geladenen CSS-/JS-Dateien benötigen einen erneuten Task-Lauf — oder man nimmt sie mit
assetDirgleich austypo3temp/heraus. - Beim Upgrade übernimmt der Wizard Move generated assets out of EXT:t3sb_package vorhandene Dateien einmalig.
Außerdem in 5.3.50:
- Export & Import der T3SB Config direkt im Backend-Modul
- Alert-Dropdown im RTE mit allen acht Bootstrap-Varianten
– b13/container ab ^4.1
- zahlreiche Bugfixes gegenüber 5.3.48.
Requirements
- TYPO3 >= 14.3
- PHP 8.2 - 8.5
Für eine Neuinstallation von TYPO3 und die Einbindung der Extension “t3sbootstrap” wird die folgende Reihenfolge für eine korrekte Installation empfohlen:
Composer support
Die empfohlene Methode zur Installation der Erweiterung ist die Verwendung des Composers.
Dazu im Composer-basierten TYPO3-Projektverzeichnis einfach folgenden Befehl ausführen:
composer require t3sbs/t3sbootstrap
… oder aus dem TYPO3 Extension Repository (TER)
Erweiterung im Extension Manager herunterladen und installieren.
Nach der Installation prüfen, ob die benötigten DB Tabellen und Felder erstellt wurden (Analyze Database Structure).
Folgende Extensions werden benötigt und ebenfalls installiert/eingebunden:
- Fluid Styled Content (fluid_styled_content)
- Container Content Elements - (container)
- rte_ckeditor
5.3.50 T3SB Package (t3sb_package) steht hier nicht mehr: Die Abhängigkeit ist entfallen, die Extension schreibt ihre Dateien seitdem ins Asset-Verzeichnis. Vorhandene Installationen dürfen das Paket behalten, es wird nur nicht mehr beschrieben.
Die EXT:t3sb_package ist nicht im TER verfügbar!
Wenn du eine “klassische” Installation ohne Composer nutzt, musst du t3sb_package hier downloaden und lokal einbinden:
5.3.50 Ab dieser Version entfällt dieser Schritt: t3sb_package wird nicht mehr benötigt – auch bei einer klassischen Installation ohne Composer nicht. Der Download bleibt nur für ältere Versionen stehen.
TypoScript Datensatz
Wenn die Website eine gemischte Konfiguration aus einer TypoScript-Vorlage (sys_template) und Site-Sets verwendet, ist es wichtig, das Kontrollkästchen “Löschen” für Konstanten und Einstellungen in der TypoScript-Vorlage zu deaktivieren.
Ansonsten ist ein klassischer TypoScript-Template-Datensatz (sys_template) in der Datenbank für die grundlegende Konfiguration nicht mehr zwingend erforderlich.
Bei einigen Installationen, wird standardmäßig ein Page-Objekt eingefügt - z.B. in:
typo3/typo3conf/sites/<some_site>/setup.typoscript
oder bei Composer Installationen in:
typo3-composer/config/sites/<some_site>/setup.typoscript
page = PAGE
page.10 = COA
page.10.stdWrap.wrap = <div style="max-width: 800px; margin: 2em auto;">|</div>
page.10.10 = TEXT
page.10.10.value (
<div style="width: 300px;">
<svg> *** TYPO2 LOGO *** </svg>
</div>
)
page.10.20 = CONTENT
page.10.20 {
table = tt_content
select {
orderBy = sorting
where = {#colPos}=0
}
}Dieses ist zu entfernen - ansonsten funktioniert t3sbootstrap nicht!
Laden von TypoScript über das Site-Package
Dein Site-Package lädt sein TypoScript ebenfalls, indem die Dateien “constants.typoscript” und “setup.typoscript” im Ordner des Site-Sets abgelegt werden.
Diese Dateien verwenden @import-Anweisungen, um TypoScript-Dateien in das Verzeichnis “Configuration/Sets/SitePackage/TypoScript” zu importieren.
Wenn du noch kein eigenes Sitepackage hast:
Site-Konfiguration
Die erforderlichen Site Sets
- T3S Bootstrap - MAIN SETTINGS
sind einzubinden.dependencies: typo3/fluid-styled-content
Folgende Sets sind optional:
T3S Bootstrap - VERSION (optional - erforderlich für den Scheduler)
T3S Bootstrap - IMAGE SETTINGS (optional)
T3S Bootstrap - BOOTSTRAP OPTIMIZE (optional)
T3S Bootstrap - OTHER SETTINGS (optional)
T3S Bootstrap - PAGES OVERRIDE (optional)
T3S Bootstrap - CONTENT BLOCKS (optional - nur mit EXT:content_blocks)
T3S Bootstrap - CONTENT BLOCKS reicht die Felder von t3sbootstrap an die Templates von EXT:content_blocks weiter. Padding, Margin, „extra class“ und Hintergrund stehen im Formular eines Content Blocks ohnehin, ausgewertet wurden sie bisher aber nur in den Content-Elementen von t3sbootstrap. Mit dem Set gibt es im frontend.html dieselben Variablen wie dort, etwa {classAttr} und {styleAttr}:
<div id="c{data.uid}"{classAttr -> f:format.raw()}{styleAttr -> f:format.raw()}>
Site Einstellungen
Nach der ersten Installation werden die JS- & CSS-Dateien per CDN (extern) geladen.
Ich empfehle jedoch die Dateien lokal einzubinden:
Hierfür lädt der Scheduler-Task die benötigten JS- und CSS-Dateien herunter und legt sie im Asset-Verzeichnis ab – standardmäßig typo3temp/assets/t3sbootstrap/, seit 5.3.59 über die Extension-Konfiguration assetDir verlegbar. Eingebunden werden sie danach automatisch.
Die Site Option “Enable CDN” ist zu deaktivieren und der Scheduler Task “T3SB CDN to local” auszuführen (nachdem die T3SB Config erstellt wurde).
Weitere Informationen siehe unten!
5.3.50 Die Dateien werden nicht mehr in ein Sitepackage ausgelagert, sondern nach typo3temp/assets/t3sbootstrap/ geschrieben – seit 5.3.59 ist dieser Ort über assetDir verlegbar. Der Ablauf selbst bleibt unverändert: „Enable CDN“ deaktivieren, dann den Task ausführen.
T3SB Config
Im BE Modul "T3SB Config", können alle relevanten Konfigurationen für dein "Bootstrap-Layout" angepasst werden.
Zuerst muss eine Konfiguration auf der Root-Page erstellt werden.
Diese kann jederzeit editiert werden, ein Löschen im Backend ist nicht möglich!
Nach dem Speichern der Konfiguration in die Datenbank, werden die Dateien t3sbconstants.typoscript und t3sbsetup.typoscript mit der gespeicherten Konfiguration in der EXT:t3sb_package erstellt bzw. aktualisiert.
Wenn “Custom SCSS” aktiviert und der Task ausgeführt wurde, werden auch die Dateien custom-x.scss und custom-variables-x.scss aktualisiert.
5.3.50 t3sbconstants.typoscript und t3sbsetup.typoscript landen standardmäßig in typo3temp/assets/t3sbootstrap/TypoScript/, die SCSS-Dateien in …/T3SB-SCSS/. Werden sie gelöscht, schreibt t3sbootstrap sie beim nächsten Frontend-Aufruf aus der Konfiguration neu. Neu ist außerdem der Export & Import der Konfiguration direkt im Modul.
Scheduler Tasks
In der Site-Konfiguration ist das Set “T3S Bootstrap - VERSION” einzubinden.
Hier kannst du Versionen bei Bedarf aktualisieren/anpassen.
CDN to local
Im Planer (Scheduler) den Task "T3SB CDN to local" hinzufügen und ausführen.
(Console: vendor/bin/typo3 t3sbootstrap:cdnToLocal )
Jetzt liegen die benötigten CSS- und JS-Dateien im Asset-Verzeichnis unter T3SB-CSS/ und T3SB-JS/ und werden automatisch lokal eingebunden. Standardmäßig ist das typo3temp/assets/t3sbootstrap/; seit 5.3.59 lässt sich der Ort über assetDir verlegen.
Ein Lauf genügt, solange typo3temp/ erhalten bleibt — das ist der Normalfall. Wiederkehrend muss der Task nur laufen, wenn ein automatisches Update beim Hoster den Ordner leert; bei einem eigenen Deployment hängt der Befehl einfach hinter das Update. Seit 5.3.59 lässt sich das Verzeichnis mit assetDir auch ganz aus typo3temp/ herausnehmen, dann entfällt beides. Siehe Deployment & typo3temp.
5.3.50 Der Screenshot zeigt noch die alte Ablage im Sitepackage t3sb_package. Seit 5.3.50 liegen die Dateien im Asset-Verzeichnis, seit 5.3.59 ist dessen Ort über assetDir wählbar.
Custom SCSS
Nachdem “Enable CDN” deaktiviert wurde kann "Custom Scss" aktiviert werden!
Im Planer (Scheduler) den Task "T3SB Custom SCSS" hinzufügen, das Argument “Root page ID” eintragen und einmalig ausführen.
(Console: vendor/bin/typo3 t3sbootstrap:customScss 1 - wenn root page uid = 1)
Die benötigten SCSS-Dateien liegen danach im Asset-Verzeichnis unter T3SB-Bootstrap/ und T3SB-SCSS/ und werden automatisch eingebunden – standardmäßig in typo3temp/assets/t3sbootstrap/, seit 5.3.59 über assetDir verlegbar.
Danach können die Bootstrap-SCSS-Variablen & Mixins im BE Module “T3SB Config” editiert werden (s. Screenshot).
Multidomain Setup
Wenn im Seitenbaum mehrere Seiten mit der Option "Als Anfang der Webseite benutzen" (Root-Page) aktiviert wurden, wird für jede eine eigene custom-variables-xx.scss sowie custom-xx.scss erstellt (s.Screenshot).
Nehmen wir einmal an, es gibt eine weitere "Root-Page" mit der id=205, dann werden unter T3SB-SCSS/ die Dateien custom-variables-205.scss und custom-205.scss erstellt.
5.3.57 Die Zeitstempel-Kopien gibt es nicht mehr. Bis 5.3.56 setzte der Task den Inhalt bei jedem Lauf auf das Bootswatch-Theme oder den Vorgabe-Kommentar zurück – dafür legte er vorher eine Kopie mit Unterstrich und Zeitstempel daneben, bis zu dreißig Stück. Seitdem ist der Konfigurations-Datensatz die Quelle: Steht dort Inhalt, wird die Datei daraus geschrieben und der Inhalt bleibt. Es gibt also nichts mehr zu retten, und die Kopien sind entfallen. Einen Schritt zurück gibt es über die Datensatz-Historie am Konfigurations-Datensatz.
5.3.60 url() löst jetzt auch EXT:-Pfade auf. Eine Schrift oder ein Bild aus dem eigenen Sitepackage lässt sich damit direkt aus dem SCSS einbinden: url(EXT:mein_sitepackage/Resources/Public/Fonts/x.woff2). In Composer-Installationen wird daraus der passende _assets/<hash>/-Pfad. Bei @import ging das schon vorher, bei url() gab es bis dahin keinen Weg zu Dateien anderer Extensions.
5.3.60 Fremdes SCSS bleibt fremd. Bis 5.3.59 hat t3sbootstrap jede SCSS-Datei der Seite kompiliert – auch die eines Sitepackages, das dafür eine eigene Extension wie ws_scss einsetzt. Angefasst werden jetzt nur noch Dateien unterhalb des eigenen Asset-Verzeichnisses. Bringt eine andere Extension zudem eine neuere Fassung von scssphp mit, tritt der Parser von t3sbootstrap beiseite und vermerkt das im Log; eigenes SCSS steht dann nicht zur Verfügung, und die Seite bindet ersatzweise die lokale bootstrap.min.css ein.
5.3.50 Bootstrap-Quellen und SCSS liegen standardmäßig in typo3temp/assets/t3sbootstrap/T3SB-Bootstrap/ und …/T3SB-SCSS/ – nicht mehr im Sitepackage. Beim Multidomain-Setup bleibt es bei je einer custom-variables-xx.scss und custom-xx.scss pro Root-Page.
SCSS editieren
Wenn der Scheduler Task “Custom Scss” ausgeführt wurde, können die Bootstrap-SCSS-Variablen sowie eigene Variablen und Mixins im BE-Module “T3SB Config” im Configuration Type “Custom SCSS” für jede Site angepasst werden.
Oder du installiserst die EXT:t3sbootstrap_builder
Migration nach "textmedia"
Mit den restlichen Scheduler Tasks kannst du die Content-Elemente “text”, “textpic” und “image” bei Bedarf nach “textmedia” migrieren.
Sinnvoll, wenn diese Content-Elemente mit den “Register static Page TSconfig files” deaktiviert wurden.
Bootswatch Themes
In den “Site Einstellungen” unter "Bootswatch Themes" kann ein Theme ausgewählt werden.
Beispiele & Info: https://bootswatch.com/
CDN ist aktiviert:
Das Bootswatch Themes wir per CDN automatisch eingebunden!
SCSS ist aktiviert:
Nach Auswahl und speichern eines Themes muss der Task "T3SB Custom Scss" ausführt werden!
Die SCSS-Dateien "custom-variables-x.scss" und "custom-x.scss" können dann im BE Module T3SB Config editiert werden (s. Screenshot: Site-Konfiguration).
Nach der Erstinstallation nicht vergessen
Ohne die beiden Scheduler-Tasks fehlen die lokalen CSS-, JS- und SCSS-Dateien – die Website wird dann unvollständig formatiert ausgeliefert. Reihenfolge:
- T3SB Config auf der Root-Page anlegen und speichern.
- Task T3SB CDN to local ausführen – Konsole:
vendor/bin/typo3 t3sbootstrap:cdnToLocal. Erst danach liegen Bootstrap, Lightbox, Swiper & Co. lokal vor. - In den Site Settings Enable CDN deaktivieren.
- Nur wenn eigenes SCSS genutzt wird: Enable Custom SCSS aktivieren und den Task T3SB Custom SCSS mit der Root page ID ausführen – Konsole:
vendor/bin/typo3 t3sbootstrap:customScss.
Beide Tasks sind auch nach einem Deployment erneut nötig, wenn das Asset-Verzeichnis nicht mit übernommen wird – standardmäßig liegt es in typo3temp/, seit 5.3.59 lässt es sich mit assetDir dort herausnehmen. Das TypoScript und das custom SCSS schreibt t3sbootstrap dagegen selbst aus der Datenbank nach. Was dabei zurückkommt und was nicht: Deployment & typo3temp.
Damit wäre die Installation abgeschlossen!
Auf der Root-Page unter “Seite bearbeiten” → “Erscheinungsbild” muss noch ein Backend-Layout ausgewählt werden.
UPGRADE - Best practice
Upgrade auf TYPO3 v14
Strukturwechsel in 5.3.50
Upgrade von 5.3.33 auf aktuelle Version
Nach dem Upgrade
Ein Punkt, der kein Upgrade-Schritt ist, sondern Dauerbetrieb: typo3temp/ ist Wegwerfware. Wird es geleert, schreibt t3sbootstrap TypoScript und SCSS von selbst nach – die heruntergeladenen CDN-Assets und Bootstrap-Quellen nicht. Ab 5.3.59 lässt sich das ganze Verzeichnis aus typo3temp/ herausnehmen – assetDir = uploads/t3sb-assets/. Wann das zum Problem wird und was man dagegen einrichtet, steht auf Deployment & typo3temp.
Community-Insights & Experten-Tipps
Upgrade für ältere Versionen & Upgrade Wizards
UPGRADE - Best practice
Upgrade Wizards
v5.3.54 - UpgradeWizard - RteColorSettingUpgradeWizard: benennt die Einstellung rteStyleColors in rteColor um
v5.3.52 - UpgradeWizard - AnchorUpgradeWizard: erzeugt die fehlenden Speaking IDs aus den Überschriften – läuft nur, wenn speakingID vorher eingeschaltet ist
v5.3.51 - UpgradeWizard - NavbarBrandImageUpgradeWizard: zieht die Navbar-Logo-Einstellungen aus jeder Site-Konfiguration in den Konfigurations-Datensatz
v5.3.51 - UpgradeWizard - RteBadgeSettingUpgradeWizard: benennt die Einstellung rteStyleBadges in rteBadge um
v5.3.50 - UpgradeWizard - LegacyAssetLocationUpgradeWizard: Ausgelagerte Dateien werden von t3sb_package nach typo3temp/assets kopiert
v5.3.46 - UpgradeWizard - BackendlayoutUpgradeWizard: Migrate backend layout keys
v5.3.20 - UpgradeWizard - IconpackTitleUpgradeWizard: FontAwesome-Icons aus pages.tx_t3sbootstrap_fontawesome_icon nach Iconpack
v5.3.20 - UpgradeWizard - IconpackHeaderUpgradeWizard: dasselbe für tt_content.tx_t3sbootstrap_header_fontawesome
v5.3.20 - UpgradeWizard - IconpackBodytextUpgradeWizard: dasselbe für Icons im bodytext, einschließlich fa-fw, Größe und Drehung
v5.3.3 - BgOpacityUpgradeWizard - change settings from e.g. 80 to 0.8 - Wizard wurde in v5.3.13 entfernt!
v5.1.5 - t3sbs_carousel migrate image -> assets (Local-Video und "original image" in Carousel) - Wizard wurde in v5.3 entfernt!
v5.0.0 - Hiermit werden die eingesetzten Utility-Classes umbenannt (INFO) - Wizard wurde in v5.3 entfernt!
v4.5.5 - Migrate tx_gridelements to tx_container - Wizard wurde in v5 entfernt!






