04-13-backendlayouts-erstellen-und-zuweisen
meine Notizen
Für die Anzeige der Seiten gibt es mehrere Layouts (html-Templates), z.b. Jumbotron, Zweispaltig, Einspaltig.
Diese Layouts können in den Seiteneigenschaften unter Erscheinungsbild / Backend-Layout ... zur Auswahl angeboten werden.
Idealerweise sollte die Struktur des Frontend-Layouts auch im Backend zur Inhaltseingabe abgebildet sein, das macht es leichter die Seiten zu pflegen, dafür gibt es die Backend-Layouts.
- Zur Darstellung dieser BackendLayouts sind kleine Symbolbilder erforderlich, welche dann im BE das Layout symbolisieren, diese gehören in den Ordner der Design-Extension in den Unterorder / Resources / Public / Icons / BackendLayouts / .
- Es gibt einen Assistenten, der diese BE-Layouts erstellt und automatisch das TSconfig generiert.
Dazu in das Listenmodul wechseln und irgendeine Seite auswählen.
Im oberen Bereich auf das Seitensymbol mit dem + klicken und als Typ Systemdatensätze / Backend-Layout auswählen.
Es geht hier nur um das Generieren des TSconfig, dieser neue Datensatz muss zum Ende nicht gespeichert werden, stattdessen wird der erzeugte Code in eine Datei kopiert.
- Hier jetzt nur folgende Angaben machen
- Konfiguration
in diesem Bereich kann das zu verwendende Layout zusammengeklickt werden,
dabei den Spalten auch Namen und Spaltenpositionen ( s. unten ) geben.
- Wenn die Konfiguration dem Layout entspricht, dann auf die Schaltfläche Seiten-TSconfig anzeigen klicken und den Code kopieren.
- Im Ordner der Design-Extension / Configuration / TSconfig / eine Datei namens BackendLayouts.txt anlegen und den Code dort hintereinander einfügen.
Nun sind an der Stelle noch jeweils Anpassungen erforderlich und zuletzt muss gespeichert werden.
- exampleKey mit dem Namen des Backend-Layouts versehen ( Zweispaltig, Einspaltig )
- title = Name des Backend-Layouts
- icon = URL des Icons
- Nun muss TYPO3 darüber informiert werden, dass es diese TSconfig-Datei einbinden soll.
Dafür die Datei ext_tables.php im Design-Extension-Hauptverzeichnis editieren.
\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addPageTSconfig('<INCLUDE_TYPOSCRIPT: source="FILE:EXT:'.$_EXTKEY.'/Configuration/TSconfig/BackendLayouts.txt">');
Leider werden mir in der weiteren Domain, für die ich diese Design-Extension erstelle, auch die Backend-Layouts der übergeordneten Hauptdomäne meiner TYPO3-Installation angezeigt.
Spaltenpositionen
- 0 entspricht Normal
- 1 entspricht linker Spalte
- 2 entspricht rechter Spalte
- 3 entspricht Rand oder Border