Warum funktioniert die Extension nach der Installation nicht?

Häufige Ursache: Im Root-TypoScript-Setup ist noch ein PAGE-Objekt definiert (z. B. ein „HELLO WORLD“-Default). Dieses Page-Objekt muss entfernt werden, sonst funktioniert t3sbootstrap nicht.

Werden die JS- und CSS-Dateien per CDN geladen oder lokal?

Standardmäßig werden die Assets per CDN eingebunden. Es wird jedoch empfohlen, sie lokal auszuliefern. Dafür gibt es den Console Command bzw. Scheduler-Task t3sbootstrap:cdnToLocal, der die Dateien automatisch nach fileadmin oder ins Sitepackage t3sb_package kopiert. Die genutzten Versionen lassen sich in den Site Settings unter „T3S Bootstrap – VERSION“ anpassen.

Was ist der Unterschied zwischen EM-Konfiguration und BE-Modul „T3SB Config“?

  • EM-Konfiguration (Extension Manager): grundsätzliche Schalter wie Aktivierung von Spacing-Feldern, Lazy Load, Animate CSS, Font Awesome 5/6, Custom SCSS, Copyright-Feld im FAL, Sitepackage-Nutzung etc.
  • BE-Modul „T3SB Config“: alle layoutrelevanten Konfigurationen (Navbar, Breadcrumb, Footer, Lightbox, Section-Menu usw.). Diese Settings lassen sich bei Bedarf per TypoScript-Konstanten oder Conditions überschreiben.

Kann ich eigenes SCSS einbinden?

Ja. In der EM-Konfiguration die Option Custom SCSS aktivieren. Die Kompilierung erfolgt über den Console Command t3sbootstrap:customScss bzw. den passenden Scheduler-Task. Voraussetzung ist die Extension ws_scss.

Wie kann ich nicht benötigte Bootstrap-Komponenten deaktivieren (Performance)?

In der Site-Konfiguration gibt es den Bereich „T3S Bootstrap – BOOTSTRAP OPTIMIZE“, in dem sich nicht genutzte Bootstrap-Komponenten gezielt deaktivieren lassen, um die CSS-/JS-Auslieferung zu verschlanken.

Wie überschreibe ich Settings nur für eine bestimmte Seite?

Über TypoScript-Conditions (Symfony Expression Language) in den Konstanten, z. B.:

[traverse(page, "uid") == 11]
bootstrap.config.sectionmenuScrollspyOffset = 90
[END]

Achtung: Einige Settings lassen sich laut Doku nur im Setup, nicht in den Konstanten überschreiben.

Wie funktioniert das Pagebrowser-/Section-Menü?

Der Pagebrowser nutzt das TYPO3-HMENU und lässt sich per Konstanten konfigurieren, u. a. bootstrap.pagebrowser.enable, prevItem, nextItem und entryLevel. Für ein Section-Menü gibt es zusätzlich bootstrap.config.sectionMenuClass, womit jedem Inhaltselement die Klasse section-index zugewiesen wird.

Funktioniert t3sbootstrap mit EXT:news?

Ja. Es werden eigene Template Layouts für EXT:news mitgeliefert (z. B. Card Decks, Card Groups, Card Columns in der List View). Die Partials liegen unter Resources/Private/Extensions/News/.

Muss nach einem Extension-Update etwas getan werden?

Ja: Nach einem Update der Extension muss das BE-Modul einmalig gespeichert werden, damit die Konstanten-Datei (z. B. fileadmin/T3SB/Configuration/TypoScript/t3sbconstants-x.typoscript) neu geschrieben wird. Außerdem ggf. „Analyze Database Structure“ ausführen, falls neue DB-Felder hinzugekommen sind.

Welche TYPO3-Versionen werden unterstützt?

Die aktuelle v5-Reihe unterstützt TYPO3 v11–v13. Für ältere TYPO3-Versionen gibt es ältere Branches (z. B. v4 für TYPO3 8–10, v3 noch mit Bootstrap 3 auf Basis von gridelements).

Wo finde ich die offizielle Dokumentation und den Quellcode?

Sag Bescheid, falls du die FAQ für ein bestimmtes Szenario brauchst (Redakteur-Schulung, interne Doku, Kundenhandover etc.) – ich kann sie dann gezielt zuschneiden oder als Word-/Markdown-Datei ausgeben.