5.3.33 → aktuell Upgrade-Anleitung
Upgrade von 5.3.33 auf die aktuelle Version
Das ist kein Extension-Update, das ist ein Plattformwechsel. 5.3.33 läuft auf TYPO3 12.4 und 13.4, die aktuelle Version verlangt ^14.3 — die Extension lässt sich erst installieren, wenn der Core steht.
Stand dieser Anleitung: 5.3.57. Jede spätere Version ist von hier aus ein normales Update — der Weg bleibt derselbe.
Dazwischen liegen gut zwei Dutzend Versionen: neun Upgrade-Wizards, rund vierzig neue Datenbankspalten, der Umzug von FontAwesome auf EXT:iconpack, ein Hauptversionssprung bei b13/container und das eigene SCSS, das aus Dateien in den Konfigurations-Datensatz gewandert ist. Die Reihenfolge ist dabei nicht beliebig.
Auf einen Blick
Zuerst der Core
TYPO3 14.3 ist Pflicht. Es gibt keine Version von t3sbootstrap, die 13.4 und 14.3 zugleich kann.
Abhängigkeiten
b13/container von ^3.1 auf ^4.1. rte_ckeditor und fluid_styled_content jetzt ausdrücklich, content-defender nicht mehr.
Datenbank
Rund vierzig neue Spalten, dazu entfallene. Datenbankanalyse ist Pflicht, nicht Kür.
Neun Wizards
Backend-Layouts, drei für Iconpack, Anker, Asset-Pfade, Navbar-Logo und zwei RTE-Einstellungen.
FontAwesome
Die alten Icon-Felder entfallen. Wer Icons gesetzt hat, braucht EXT:iconpack — vor den Wizards.
Eigenes SCSS
Quelle ist jetzt der Konfigurations-Datensatz, nicht mehr die Datei in typo3temp.
Was dazwischen passiert ist
Nur die Punkte, die beim Upgrade etwas verlangen — reine Bugfix-Releases sind weggelassen.
| Version | Was zu tun ist |
|---|---|
5.3.40 05.05.2026 | Support für TYPO3 v14. Ab hier ist der Core-Sprung überhaupt möglich. |
5.3.42 17.05.2026 | Das Site Set „T3S Bootstrap — OTHER SETTINGS“ wird obligatorisch. Fehlt es in der Site-Konfiguration, fehlen Einstellungen. |
5.3.46 20.06.2026 | Der BackendlayoutUpgradeWizard kommt dazu. |
5.3.48 26.07.2026 | Speaking ID wird eingeführt (Schalter, ab Werk aus). |
5.3.50 22.08.2026 | EXT:t3sb_package wird nicht mehr gebraucht. Dazu b13/container ab ^4.1, Export & Import der Konfiguration im Backend-Modul und die Einstellung flexformDir. |
5.3.51 01.09.2026 | Drei Spalten navbar_image_width/height/alt plus Navbar-Wizard; Badges bekommen ein eigenes RTE-Werkzeug. Geändertes Verhalten: die Lightbox beachtet jetzt den Bildzuschnitt. |
5.3.52 02.10.2026 | Jumbotron-Hintergrundvideo — DB-Update nötig. |
5.3.55 14.10.2026 | Inhaltseinzug und senkrechte Überschrift — DB-Update nötig. |
5.3.56 15.10.2026 | Werkzeug Klassen im RTE, Backend-Layout wird vererbt. |
5.3.57 19.10.2026 | div als Block im RTE, h1 kann den Navigationstitel nehmen — DB-Update nötig. |
Zu 5.3.34 bis 5.3.39 gibt es weder Tags noch Log-Einträge — die Nummern sind nie einzeln veröffentlicht worden.
Reihenfolge: zuerst TYPO3, dann die Extension
Die aktuelle Version fordert in ext_emconf.php und composer.json ausdrücklich TYPO3 14.3. Ein Versuch, die Extension auf einer 12er oder 13er Installation zu aktualisieren, scheitert bereits bei Composer.
| 1. Core | TYPO3 auf 14.3 bringen — bei 12.4 über 13.4 als Zwischenstufe. |
| 2. Abhängigkeiten | b13/container auf ^4.1. Hauptversionssprung mit eigenen Änderungen. |
| 3. t3sbootstrap | Erst jetzt auf die aktuelle Version. |
| 4. Site Set | T3S Bootstrap — OTHER SETTINGS eintragen, falls noch nicht geschehen. Seit 5.3.42 obligatorisch. |
| 5. Datenbank | Analyse ausführen, bevor irgendein Wizard startet. |
| 6. Wizards | In der Reihenfolge weiter unten. |
| 7. Datensatz | Konfigurations-Datensatz öffnen, speichern, Cache leeren. |
Nicht auf Live. Dieser Sprung lässt sich nicht in Einzelschritten zurücknehmen. Auf einer Kopie arbeiten, Datenbank-Dump und fileadmin vorher sichern.
Vorbereitung
Drei Dinge, die nach dem Update nicht mehr auslesbar sind:
- Die Extension-Konfiguration abschreiben. Mehrere Optionen sind verschoben oder entfallen. Ein Screenshot der Tabs genügt.
- Eigenes SCSS sichern. Alles aus
public/typo3temp/assets/t3sbootstrap/, besonderscustom-*.scssundcustom-variables-*.scss. - Den Konfigurations-Datensatz sichern. Ab 5.3.50 geht das im Backend-Modul T3SB Config über Export; auf einer 5.3.33 gibt es das noch nicht — dort die Seite exportieren oder die Werte abschreiben.
Wer FontAwesome-Icons in Inhalten, Überschriften oder Seiteneigenschaften gesetzt hat, installiert jetzt EXT:iconpack und EXT:iconpack_fontawesome. Ohne sie migrieren die drei Iconpack-Wizards ins Leere.
Paket aktualisieren und Datenbank
composer require t3sbs/t3sbootstrap
vendor/bin/typo3 extension:setup
vendor/bin/typo3 database:updateschema
vendor/bin/typo3 cache:flushDie Datenbankanalyse muss laufen, bevor ein Wizard startet — die Wizards schreiben in Spalten, die es sonst noch nicht gibt.
Neu im Konfigurations-Datensatz: record_type, custom_scss, custom_variables_scss, page_titlenavtitle, navbar_image_width/height/alt und die jumbotron_bgvideo_*-Felder. Bei den Inhaltselementen tx_t3sbootstrap_anchor, _supraheader, _header_vertical, _no_indent; bei den Seiten tx_t3sbootstrap_indent und die Opt-out-Schalter für Navbar, Breadcrumb, Meta, Jumbotron, Seitentitel und Footer.
Alte Spalten erst am Ende löschen. Die Datenbankanalyse bietet das Löschen an. Lass es stehen, bis die Iconpack-Wizards durch sind und das Frontend geprüft ist — tx_t3sbootstrap_fontawesome_icon und tx_t3sbootstrap_header_fontawesome sind die Quelle der Migration. Einmal gelöscht, sind die Icons nicht wiederherstellbar.
Die neun Upgrade-Wizards
Install Tool → Upgrade → Upgrade Wizard, oder einzeln auf der Kommandozeile. Die Reihenfolge unten ist die empfohlene: erst Struktur, dann Icons, dann Einstellungen.
vendor/bin/typo3 upgrade:list
vendor/bin/typo3 upgrade:run t3sbootstrap_backendlayoutUpgradeWizard| Wizard | Was er tut |
|---|---|
| backendlayout | Entfernt den Suffix _Extra aus backend_layout und backend_layout_next_level. Zuerst ausführen. |
| legacyAssetLocation | Holt die erzeugten Dateien einmalig aus EXT:t3sb_package nach typo3temp/assets/t3sbootstrap/. Danach kann das Sitepackage aus dem Projekt. |
| iconpackTitle | FontAwesome-Icons aus pages:tx_t3sbootstrap_fontawesome_icon nach Iconpack. |
| iconpackHeader | Dasselbe für tt_content:tx_t3sbootstrap_header_fontawesome. |
| iconpackBodytext | Dasselbe für Icons im bodytext, inklusive fa-fw, Größe und Drehung. |
| navbarBrandImage | Zieht die Navbar-Logo-Einstellungen aus jeder Site-Konfiguration in den Konfigurations-Datensatz. |
| rteBadgeSetting | Benennt rteStyleBadges in rteBadge um. |
| rteColorSetting | Dasselbe für rteStyleColors → rteColor. |
| anchor | Erzeugt die fehlenden Speaking IDs aus den Überschriften. Läuft nur, wenn speakingID vorher eingeschaltet ist. Als letzter Schritt gedacht. |
Extension-Konfiguration
Entfallen — jetzt woanders:customScss und bootswatch sind Site Settings geworden (bootstrap.cdn.*), editScss entfällt (bearbeitet wird im Datensatz), und keepVariables ist mit 5.3.57 ersatzlos gestrichen — es hat sein Versprechen nie gehalten, der Datensatz hat die Datei bei jedem Speichern überschrieben.
Neu — alle ab Werk aus:supraheader, headerVertical, speakingID, allowReferences, titlecolor, pageOptOut, contentIndent und contentIndentInherit, dazu flexformDir und pageInfo. Diese Schalter blenden nur Felder ein; solange sie aus sind, ändert sich an bestehenden Seiten nichts.
Eigenes SCSS und erzeugte Dateien
Die wichtigste Änderung für alle, die eigenes SCSS pflegen: Quelle ist der Konfigurations-Datensatz, nicht mehr die Datei. Die Datei in typo3temp ist nur noch das Erzeugnis.
vendor/bin/typo3 t3sbootstrap:cdnToLocal
vendor/bin/typo3 t3sbootstrap:customScss <Rootseiten-ID>Beides gibt es auch als Scheduler-Aufgaben. cdnToLocal braucht einen ausgehenden Internetzugang des Webservers — nicht des Browsers — zu github.com, cdn.jsdelivr.net, cdnjs.cloudflare.com, unpkg.com, code.jquery.com, gwfh.mranftl.com und bootswatch.com.
typo3temp ist Wegwerfware. Jedes Update, jedes Deployment und jedes Cache-Leeren darf das Verzeichnis ausräumen. Was daraus neu gebaut werden kann, kommt wieder; die heruntergeladenen Bootstrap-Quellen kommen nur mit Internetzugang wieder.
Konfigurations-Datensatz
Der Datensatz hat Typen bekommen (record_type) — statt eines langen Formulars wählst du oben die Bootstrap-Komponente und bekommst nur deren Felder. Bestehende Datensätze landen im Typ general.
Zum Abschluss: Datensatz öffnen, Navbar-Logo, Seitentitel, Jumbotron und Footer prüfen, einmal speichern — auch ohne Änderung, denn erst dabei werden die Konstanten nach t3sbconstants.typoscript geschrieben — und Cache leeren.
Was danach zu prüfen ist
- Eine Seite je Backend-Layout — der Layout-Wizard hat Schlüssel umgeschrieben.
- Eine Seite mit Icons in Seitentitel, Überschrift und Fließtext.
- Navbar mit Logo — Pfad, Breite, Höhe und Alt-Text sitzen jetzt im Datensatz.
- Ein Text im RTE öffnen und speichern, danach
bodytextvergleichen. - Container-Elemente nach dem Sprung auf
b13/container4. - Eine Lightbox mit zugeschnittenem Bild — seit 5.3.51 öffnet sie den Ausschnitt statt des Originals. Das volle Bild gibt es über die Option Originalbild für Lightbox verwenden. Geändertes Verhalten, kein Fehler.
- Das Stylesheet — wenn die Seite unformatiert ist, fehlen die erzeugten Dateien.
Zum Abhaken: Die vollständige Checkliste — Pflicht, „nur wenn es dich betrifft“ und Prüfschritte — steht im PDF unten.