T3SB Config
Hier 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.
Die Konstanten (Konfiguration) aus der “Root-Page” können wie gewohnt für Unterseiten überschrieben werden - z.B.:
Konstanten:
[traverse(page, "uid") in [99,159,160]]
bootstrap.config.navbarColor = warning
bootstrap.config.jumbotronEnable = 0
[END]5.3.50 Die generierten Dateien landen nicht mehr in EXT:t3sb_package, sondern unter typo3temp/assets/t3sbootstrap/ – das TypoScript in TypoScript/, die SCSS-Dateien in T3SB-SCSS/. Werden sie gelöscht, schreibt t3sbootstrap sie beim nächsten Frontend-Aufruf aus der Datenbank neu.
Neu ist außerdem der Export & Import der Konfiguration direkt im Modul, im Akkordeon unter „Ausgelagerte Konstanten“. Damit lässt sich eine Konfiguration von einem Server auf einen anderen übertragen. Beim Import stehen drei Modi zur Verfügung: Update (Datensatz wird geleert und neu befüllt, die uid bleibt erhalten), Replace und Add.
Die ausgelagerten Konstanten können im BE Modul eingesehen werden:
Edit Konfiguration
Im Tab-Element “Allgemein” oder “General” kann eine T3SB-Komponete (Configuration Type) zum editieren ausgewählt werden.
Hier eine Übersicht der Optionen:
General Settings
Meta Navigation
Navbar
5.3.51 Der Tab Brand (Logo) hat drei neue Felder: Bildbreite, Bildhöhe und Alternativtext. Sie erscheinen nur, wenn unter „make your selection“ ein Logo gewählt ist. Bis dahin kamen diese drei Werte ausschließlich aus den Site-Settings – ein abweichendes Logo im Datensatz bekam dadurch die Maße des Site-Logos verpasst.
Es gilt jetzt für alle vier Werte dieselbe Rangfolge wie zuvor schon für den Pfad: der Datensatz gewinnt, das Site-Setting ist der Rückfall. Leer bzw. 0 bedeutet „nimm den Wert aus der Site“ (bootstrap.navbar.image.defaultPath, …width, …height, …altText).
Nach dem Update – drei Schritte
- Datenbankanalyse ausführen. Die Version bringt drei neue Spalten in
tx_t3sbootstrap_domain_model_configmit:navbar_image_width,navbar_image_heightundnavbar_image_alt. Install-Tool → Analyze Database Structure, oder auf der Konsolevendor/bin/typo3 extension:setup. Ohne diesen Schritt lässt sich der Konfigurations-Datensatz nicht speichern. - Upgrade Wizard ausführen (optional): „Move the navbar brand image settings into the configuration record“. Er holt alle vier Werte – also auch den Pfad aus
bootstrap.navbar.image.defaultPath– je Siteroot in den Datensatz, und zwar nur dort, wo das jeweilige Feld dort noch leer bzw. 0 ist. Ohne ihn ändert sich nichts, weil die Site-Settings als Rückfall weiter greifen; mit ihm steht das Logo an einer Stelle statt an zweien. - Caches leeren.
Jumbotron
Page Title
Breadcrumb
Die Brotkrümelnavigation zeigt, wo im Seitenbaum die aktuelle Seite liegt. Sie wird im Konfigurations-Datensatz im Reiter Breadcrumb eingestellt und ist ab Werk aktiv – nur auf der Startseite nicht.
| Einstellung | Feld | Bedeutung |
|---|---|---|
| Enable | breadcrumb_enable | Schaltet die Breadcrumb ein. Vorgabe: an. |
| Not on rootpage | breadcrumb_notonrootpage | Auf der Startseite ausblenden – dort bestünde sie ohnehin nur aus einem Eintrag. Vorgabe: an. |
| Container | breadcrumb_container | Von none über container bis container-fluid – dieselbe Auswahl wie an anderer Stelle auch. Vorgabe: container. |
| Container position | breadcrumb_containerposition | inside legt den Container in das <nav>, outside legt das <nav>in den Container. Ohne Auswahl steht das <nav> blank da. |
| Breadcrumb position | breadcrumb_position | Vier Plätze: über oder unter der Navbar, über oder unter dem Jumbotron. Vorgabe: unter dem Jumbotron. |
| Below the content | breadcrumb_bottom | Zusätzlich – oder ausschließlich – unter dem Inhalt. Siehe Hinweis unten. |
| Extra class | breadcrumb_class | Klasse am <nav>, etwa mb-0 für margin-bottom: 0. |
| Icon | breadcrumb_faicon | Statt des Titels ein Icon – nur beim ersten Eintrag. Siehe Hinweis unten. |
| No rounded corner | breadcrumb_corner | Hängt rounded-0 an die <ol>. |
„Below the content“ ist unabhängig von „Enable“
Das Partial rendert, sobald eine der beiden Optionen gesetzt ist. Beide zusammen ergeben also eine Breadcrumb oben und unten. Willst du sie nur unter dem Inhalt, schaltest du „Enable“ ab und „Below the content“ an – das meint die Beschreibung mit „only or also“. Die untere Ausgabe liegt in einem <div class="breadcrumb-bottom"> und ignoriert die Positionsauswahl.
Nur der erste Eintrag ist verlinkt
Das ist Absicht und hängt an einer Einstellung, die woanders steht: Erst wenn unter Navbar → Various Settings die Option Clickable parent aktiv ist, werden auch die Zwischenstufen zu Links. Ohne sie sind es reine Textstufen – sinnvoll, wenn die übergeordneten Seiten Verweise oder Ordner ohne eigenen Inhalt sind.
Das Icon braucht zwei Voraussetzungen
Die Option ersetzt den Text nur beim ersten Eintrag, und nur wenn die Seite unter Erscheinungsbild ein Seiten-Icon trägt und EXT:iconpack geladen ist. Fehlt eines von beidem, steht dort weiterhin der Seitentitel – ohne Fehlermeldung.
Zwei Dinge, die die Breadcrumb mitbenutzen
Auf einer News-Detailseite hängt lib.newsTitle den Titel der Meldung als letzten, aktiven Eintrag an. Und im Reiter Page Title gibt es die Position „above the Breadcrumb“ – dann wird der Seitentitel in den Container der Breadcrumb gesetzt, teilt sich also deren Breite. Wer das Bootstrap-CSS ausdünnt: im Site-Set Optimize entscheidet bootstrap.optimize.breadcrumb, ob die Komponente überhaupt mitkompiliert wird.