Dies ist eine alte Version des Dokuments!
Auch das Backend kann mittels Typoscript konfiguriert werden. Unterschieden wird zwischen Page TSconfig und User TSconfig. Beide Einstellungen werden vererbt und können überschrieben werden. Conditions wie z.B. [loginUser = 3] sind möglich.
Manche Einstellungen können in beiden TSconfig gesetzt werden: TCAdefaults ist seit TYPO3 4.3 auch in der Page TSconfig verwendbar. Zudem können alle Eigenschaften der Page TSconfig in der User TSconfig verwendet werden, wenn diesen page. vorangestellt wird.
Im folgenden die Hierarchie, nach der TYPO3 die Konfigurationen verwendet. Der oberste Punkt hat Vorrang gegenüber den nachfolgenden:
Nachfolgend ist eine Auswahl von Eigenschaften aufgeführt, die ich persönlich für sinnvoll halte.
| Eigenschaft | Datentyp | Beschreibung |
|---|---|---|
| admPanel | ADMPANEL | Das FE Admin Panel lässt sich für BE-Benutzer anpassen. |
| options | OPTIONS | Verschiedene Benutzer-Anpassungen des TYPO3-Kerns, z.B. Cache-Buttons, Bookmark- und Seitenbaumeinstellungen. |
| mod | MOD | Optionen für die Backend-Module. Deprecated! Stattdessen page.mod verwenden. |
| setup.default / setup.override | SETUP | Werte für USER TOOLS → User settings. Während setup.default lediglich Standardwerte vorgibt, erzwingt setup.override diese Einstellungen. Änderungen im BE-Formular werden bei letzterem ignoriert bzw. überschrieben. Vorsicht bei override: Wenn ein Wert überschrieben wurde, bleibt er auch nach dem Löschen der TSconfig-Einstellung bestehen! Stattdessen muss der Wert der Einstellung geändert werden. |
| TCAdefaults.[tablename].[field] | string | Setzt Standardwerte für Datensätze. Felder in pages, tt_content, tt_news usw. können zentral vorbelegt werden, z.B. das Feld 'Autor' mit dem Namen des BE-Benutzers. Auch das sofortige Sichtbarschalten neuer Seiten ist hier möglich. Seit TYPO3 4.3 auch direkt in der Page TSconfig verwendbar! |
| user | Deprecated! Stattdessen tx_* bei Extensions verwenden | |
| auth | Aktuell existiert nur eine Konfiguration: auth.BE.redirectToURL = zur Weiterleitung des Benutzers nach dem Login zu einem bestimmten BE-Modul. |
|
| page | Alle Page TSconfig-Eigenschaften | Alle Page TSconfig-Eigenschaften können überschrieben werden, wenn man sie in die User TSconfig schreibt und mit page. beginnt. |
| tx_[Extension-Key ohne weiteren Unterstrich] | Reserviert für Extensions |
| Eigenschaft | Datentyp | Beschreibung |
|---|---|---|
| mod | MOD | Optionen für die Backend-Module. page.mod. in der User TSconfig hat Vorrang. |
| RTE | RTE | Einstellungen für den Rich Text Editor |
| TCEMAIN | TCEMAIN | Konfiguration der TYPO3 Core Engine |
| TCEFORM | TCEFORM | Zusätzliche Konfiguration für Formularfelder |
| TSFE | TSFE | Optionen für das TSFE Frontend-Objekt |
| user | Deprecated! Stattdessen tx_* bei Extensions verwenden | |
| tx_[Extension-Key ohne weiteren Unterstrich] | Reserviert für Extensions |
| Eigenschaft | Datentyp | Beschreibung |
|---|---|---|
| enable | Ermöglicht das Aktivieren des Admin Panels bzw. einzelner Bestandteile für Backendbenutzer ohne Adminrechte.# Gesamtes Admin Panel aktivieren admPanel.enable.all = 1 # Einzelne Bestandteile aktivieren admPanel.enable { preview = 1 cache = 1 publish = 1 edit = 1 tsdebug = 1 info = 1 } |
|
| hide | boolean | Wenn aktiviert, wird das Admin Panel im Frontend nicht angezeigt. Dennoch können die Funktionen des Admin Panels ggf. benutzt werden (siehe nächster Punkt). admPanel.hide = 1 |
| override | Erzwingt die gewünschten Einstellungen des Admin Panels. Hinweis: Dies hat Auswirkung auf die Funktion; die Checkbox im Admin Panel wird hierbei nicht als gewählt markiert und ist nutzlos. admPanel.override { edit.displayIcons = 1 cache.noCache = 1 preview.showHiddenRecords = 1 } |
| Eigenschaft | Datentyp | Beschreibung |
|---|---|---|
| clearCache | boolean | Ermöglicht das Leeren des Caches für Nicht-Admins. Mögliche Optionen:options.clearCache.all = 1 → Alle Caches löschen (inkl. Templates)options.clearCache.pages = 1 → Seiteninhalts-Cache leerenoptions.clearCache.clearRTECache = 1 → RTE-Cache leeren |
| saveClipboard | boolean | Wenn aktiviert, wird der Inhalt der gesamten Zwischenablage über den Logout hinaus gespeichert. |
| clipboardNumberPads | integer (0-20) | Ermöglicht das Anlegen von Zwischenablagen von 0 bis 20. |
| Array von integern/ integer, strings | Ermöglicht das Anlegen, Entfernen und Umbenennen von Lesezeichengruppen. 0 deaktiviert eine Gruppe, 1 aktiviert sie. Mit einem String kann ein eigener Name vergeben werden. Voreingestellt sind folgende fünf Gruppen: options.bookmarkGroups { # Standard: 1 = Seiten 2 = Datensätze 3 = Dateien 4 = Werkzeuge 5 = Verschiedenes 6 = TypoScripts 7 = TSconfigs } |
|
| pageTree.backgroundColor | string | ab TYPO3 6.0 Ermöglicht Hintergrundfarben im Seitenbaum. Betrifft die mit UID angegebene Seite sowie alle Unterseiten. Die Farben können in allen üblichen Formaten definiert werden. options.pageTree.backgroundColor.4 = #FF0000 options.pageTree.backgroundColor.17 = rgba(255, 0, 0, 0.5); options.pageTree.backgroundColor.25 = red |
| pageTree.showPageIdWithTitle | boolean | Wenn aktiviert, werden im Seitenbaum die UIDs der Seiten in eckigen Klammern vor die Namen gesetzt. |
| pageTree.showDomainNameWithTitle | boolean | Wenn aktiviert, wird die erste der angegebenen Domains neben dem Seitentitel angegeben. Voraussetzung ist neben einer Domain die Seiteneigenschaft Use as Root Page. |
| pageTree.showNavTitle | boolean | Wenn aktiviert, wird statt dem Seitennamen der Navigationstitel im Seitenbaum angezeigt. |
| pageTree.showPathAboveMounts = 1 | boolean | Wenn aktiviert, werden bei DB Mounts die Pfade zum betreffenden Mount angezeigt. |
| folderTree.hideCreateFolder | boolean | Wenn aktiviert, kann der Benutzer keine neuen Ordner im filadmin anlegen. |
| file_list.enableDisplayBigControlPanel | boolean | Ermöglicht das Aktivieren der erweiterten Ansicht im fileadmin. Mögliche Werte: selectable → Eigenschaft deaktiviert und Checkbox eingeblendet (Standard)activated → Eigenschaft aktiviert und Checkbox ausgeblendetdeactivated → Eigenschaft deaktiviert und Checkbox ausgeblendet. |
| file_list.enableDisplayThumbnails | boolean | Ermöglicht das Aktivieren der Vorschaubilder im fileadmin. Mögliche Werte siehe enableDisplayBigControlPanel. |
| file_list.enableClipBoard | boolean | Ermöglicht das Aktivieren der Zwischenablage im fileadmin. Mögliche Werte siehe enableDisplayBigControlPanel. |
| Eigenschaft | Datentyp | Beschreibung |
|---|---|---|
| thumbnailsByDefault | boolean | Zeigt die Vorschaubilder an. |
| titleLen | positive integer | Gibt die angezeigte Länge der Datensatz-Titel an. |
| edit_wideDocument | boolean | Erweitert die Breite der Eingabeformulare um ca. 50%. |
| edit_RTE | boolean | Aktiviert den Rich Text Editor. |
| lang | Sprachschlüssel | Setzt die Backendsprache des Benutzers, z.B. setup.default.lang = de. |
| resizeTextareas | boolean | Ermöglicht die Größenanpassung von Textfeldern. |
| resizeTextareas_MaxHeight | positive integer | Gibt die maximale Höhe von Textfeldern an. |
| startModule | string | Stellt die Startseite im Backend ein, z.B. setup.default.startModule = web_list. |
| [Eigenschaft].disabled | boolean | Blendet die genannte Eigenschaft in den Benutzereinstellungen aus. |
# Neue Seiten werden sofort sichtbar geschaltet TCAdefaults.pages.hidden = 0 # Ein neues Inhaltselement wird als "Text und Bilder" geöffnet. Bilder stehen rechts im Text. TCAdefaults.tt_content { CType = textpic imageorient = 17 } # Ein neues Inhaltselement erhält immer eine h2-Überschrift mit diesem Inhalt TCAdefaults.tt_content.header = Überschrift TCAdefaults.tt_content.header_layout = 2
Mit der Page TSconfig können unter anderem Formularfelder von Inhaltselementen umbenannt oder ausgeblendet werden. Für voreingestellte Werte in diesen Feldern ist aber die User TSconfig zuständig.
Die folgenden Tabellen enthalten nicht alle Funktionen, nur die oft benötigten.
| Eigenschaft | Datentyp | Beschreibung |
|---|---|---|
| table.[Tabellenname] | 3 Optionen sind möglich: history.maxAgeDays: Dauer, die ein Element im Verlauf (Tabelle sys_history) gespeichert wird. 0 schaltet die Speicherung ab, 200 ist Maximum. 7 ist Standard.disableHideAtCopy: Kopierten Datensatz ausblenden/anzeigen disablePrependAtCopy: Zusatz (z.B. (Kopie 1)) ein-/ausschalten. # Kopierte Inhaltselemente sofort sichtbar schalten TCEMAIN.table.tt_content.disableHideAtCopy = 1 # Ausschalten von 'Kopie X' beim Kopieren von INHALTEN TCEMAIN.table.tt_content.disablePrependAtCopy = 1 # Ausschalten von 'Kopie X' beim Kopieren von SEITEN TCEMAIN.table.pages.disablePrependAtCopy = 1 |
|
| permissions.userid permissions.groupid | Integer | Einstellung des Standardbesitzers von neu angelegten und kopierten Seiten (keine bestehenden), unabhängig vom erstellenden Benutzer. Ohne diese Einstellung gehört eine Seite immer dem Ersteller und dessen Hauptgruppe. # Neue Seite gehört Gruppe 1 TCEMAIN.permissions.groupid = 1 |
| permissions.user permissions.group permissions.everybody | Integer, String | Regelt die Rechtevergabe von neu angelegten und kopierten Seiten (keine bestehenden). Rechte können als Strings (show, edit, delete, new, editcontent) oder Bitmuster (0(keine Rechte), 1(show), 2(edit), 4(delete), 8(new), 16(editcontent) - durch Addition der Werte) vergeben werden. # Identische Ergebnisse TCEMAIN.permissions { user = show,editcontent,edit,delete,new group = show,editcontent,edit,new everybody = } TCEMAIN.permissions { user = 31 group = 27 everybody = 0 } |
| clearCacheCmd | Integer, String | Beim Speichern eines Inhaltselements auf der Seite, wo diese Einstellung im TSconfig definiert wurde, wird der Cache für die dort angegebenen Seiten gelöscht. Beispiel: Der sysOrdner mit ID 4 enthält die tt_news-Beiträge, die News werden per Plugin auf Seite ID 9 ausgegeben. Setzt man TCEMAIN.clearCacheCmd = 9 im sysOrdner, wird bei jedem Anlegen eines neuen Inhaltselements der Cache auf Seite 9 geleert und die News beim nächsten Seitenaufruf bereits angezeigt. # Bestimmte Seiten TCEMAIN.clearCacheCmd = 9, 23, 45 # Alle Seitencaches TCEMAIN.clearCacheCmd = pages # Sämtliche Caches TCEMAIN.clearCacheCmd = all |
| translateToMessage | String | Ersetzt bei zu übersetzendem Inhaltselement den vorangesetzten String Translate to [Sprache]: . %s wird durch den Sprachnamen ersetzt. TCEMAIN.translateToMessage = Bitte in "%s" übersetzen: |
Formularfelder bearbeiten:
| Eigenschaft | Datentyp | Beschreibung |
|---|---|---|
| [Tabelle].[Feld]. disabled | boolean | Feld im Formular entfernen.TCEFORM.tt_content.subheader.disabled = 1 |
| [Tabelle].[Feld]. removeItems | Werteliste | Optionen aus select-Liste entfernen.# Beispiel Überschriften (0 = 'Standard'; 100 = 'Versteckt') TCEFORM.tt_content.header_layout.removeItems = 1,3,4,5,100 |
| [Tabelle].[Feld]. keepItems | Werteliste | Optionen aus select-Liste behalten, den Rest entfernen.#Entfernt alle Überschriften außer 'Layout 1' und 'Hidden' TCEFORM.tt_content.header_layout.keepItems = 1,100 |
| [Tabelle].[Feld]. addItems | String | Optionen zu select-Feldern hinzufügen.# Fügt die Überschrift 'Layout 6' hinzu. TCEFORM.tt_content.header_layout.addItems.6 = Layout 6 # Das Objekt '6' muss selbstverständlich ebenfalls konfiguriert werden! Z.B.: lib.stdheader.10.6 < lib.stdheader.10.1 lib.stdheader.10.6.dataWrap = <h6{register:headerStyle}{register:headerClass}>|</h6> |
| [Tabelle].[Feld].label | String | Feldnamen umbenennen. Mehrsprachige Angaben mit Länderkürzeln möglich. # default = Englisch. Englisches Länderkürzel hätte nur Einfluss, # wenn als neue Sprache in TYPO3 angelegt und vom User als Backendsprache ausgewählt. TCEFORM.tt_content.header_layout.label.default = Headline style TCEFORM.tt_content.header_layout.label.de = Überschrift-Art |
| [Tabelle].[Feld]. altLabels | String | Optionen aus select-Liste umbenennen. # 0 = Default-Überschrift TCEFORM.tt_content.header_layout.altLabels.0 = Überschrift rot
TCEFORM.tt_content.header_layout.altLabels.0 = Page header || Seitenüberschrift ||||| Opschrift 1
Die einzelnen Sprachlabel werden hierbei mit Pipe-Symbol unterteilt, in fest definierter Reihenfolge: |
# Nur bestimmte neue Datensätze auf einer Seite anlegbar machen mod.web_list.allowedNewTables = tt_news,tt_news_cat
Folgende Einstellungen funktionieren nicht mit TYPO3 6.x (Funktion ersetzt durch BackendLayouts):
# Nur ausgewählte Spalten im Backend anzeigen mod.SHARED.colPos_list = 0,2 # Nur ausgewählte Spalten in Seiteninhalten wählbar TCEFORM.tt_content.colPos.removeItems = 1,3
Die folgenden Einstellungen müssen noch einsortiert werden.
Den Inhaltsassistenten mit neuen Elementen oder sogar eigenen Reitern anpassen
