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. Die Einstellungen von mod
können direkt in der User TSconfig gesetzt werden. 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.
Die Eigenschaften von mod
können auch direkt in der User TSconfig verwendet werden, ohne dass page.
vorangestellt werden muss.
Eigenschaft | Datentyp | Beschreibung |
---|---|---|
[Modulname].menu.[Name] | boolean | Viele der Backendmodule haben eine Auswahlliste, mit der sich verschiedene Funktionen wählen lassen, z.B. der Bereich Log unter Web > Info. Mit dieser Eigenschaft lassen sich einzelne Menüpunkte ausblenden. Die benötigten Modul- und Auswahlnamen lassen sich aus z.B. aus dem Quelltext auslesen. mod.web_info.menu.function { tx_belog_webinfo = 0 } mod.web_func.menu.wiz { tx_wizardsortpages_webfunc_2 = 0 } |
SHARED.defaultLanguageLabel SHARED.defaultLanguageFlag | string | Die Standardsprache wird im Backend (z.B. Web > List mit Localization view) einfach mit Default angegeben. Mit diesen Einstellungen kann stattdessen ein Sprachname und auch eine Flagge angezeigt werden. mod.SHARED { defaultLanguageLabel = Deutsch defaultLanguageFlag = de } |
web_list.listOnlyInSingleTableView | boolean | Wenn aktiviert, werden in der Listenansicht nur noch die Tabellennamen angezeigt. Die Inhalte erreicht man über den Single Table View (Plus-Button). |
web_list.itemsLimitPerTable | positive integer | Max. Anzahl der Einträge pro Tabelle in der Listenansicht. Standard: 20. |
web_list.itemsLimitSingleTable | positive integer | Max. Anzahl der Einträge im Single Table View. Mehr Einträge verteilen sich auf weitere Seiten. Standard: 100. |
web_list.noExportRecordsLinks | boolean | Seit TYPO3 6.1 Wenn aktiviert, werden die Buttons für Download CSV file und Export (T3D/XML) ausgeblendet, die im Single Table View in der oberen Menüleiste zu finden sind. |
web_list.hideTables | Liste von Tabellennamen | Ermöglicht das Ausblenden von Tabellen in der Listenansicht. mod.web_list.hideTables = pages |
web_list.disableSearchBox | boolean | Wenn aktiviert, wird die Suche unterhalb der Zwischenablage ausgeblendet. mod.web_list.disableSearchBox = 1 |
web_list.allowedNewTables | Liste von Tabellennamen | Nur für die hier aufgeführten Tabellen können neue Datensätze angelegt werden. Alle anderen Datensätze werden innerhalb von Create new record ausgeblendet. Hinweis: Über kopieren oder verschieben ist es weiterhin möglich, andere Inhalte auf die Seite zu bringen. mod.web_list.allowedNewTables = tt_content, tt_news |
web_list.deniedNewTables | Liste von Tabellennamen | Das Gegenteil von allowedNewTables : Für alle hier aufgeführten Tabellen können keine neuen Datensätze angelegt werden. Wenn sich Tabellen in beiden Eigenschaften befinden, hat deniedNewTables Vorrang. mod.web_list.deniedNewTables = pages |
web_list.clickTitleMode | string | Steuert die Funktion des Datensatz-Titels in der Listenansicht. Seit TYPO3 6.2 ist edit der Defaultwert für alle Datensätze. Mögliche Werte: edit → Den Datensatz bearbeiteninfo → Neues Fenster mit Informationenshow → Zeigt den Datensatz im FrontendBei der Verwendung von show werden nur Seiten und Datensätze verlinkt, die sinnvoll sind; eine alternative Seitensprache z.B. erhält keine Verlinkung. |
web_list.enableDisplayBigControlPanel | boolean | Ermöglicht das Aktivieren der erweiterten Ansicht in der Listenansicht. Mögliche Werte: selectable → Eigenschaft deaktiviert und Checkbox eingeblendet (Standard)activated → Eigenschaft aktiviert und Checkbox ausgeblendetdeactivated → Eigenschaft deaktiviert und Checkbox ausgeblendet. |
web_list.enableClipBoard | boolean | Ermöglicht das Aktivieren der Zwischenablage in der Listenansicht. Mögliche Werte siehe enableDisplayBigControlPanel . |
web_list.enableLocalizationView | boolean | Ermöglicht das Aktivieren der Lokalisierungsansicht in der Listenansicht. Mögliche Werte siehe enableDisplayBigControlPanel . |
Dem Rich Text Editor ist hier eine eigene Seite gewidmet.
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 wären mit Länderkürzeln (label.de = ) möglich, vernünftiger ist die Verwendung von Sprachdateien. TCEFORM.tt_content.header_layout.label = LLL:EXT:basetemplate8/Resources/Private/Language/locallang_be.xlf:header_layout |
[Tabelle].[Feld]. altLabels | String | Optionen aus select-Liste umbenennen. TCEFORM.tt_content.header_layout.altLabels.1 = LLL:EXT:basetemplate8/Resources/Private/Language/locallang_be.xlf:header_layout.altLabels.1 |
Eigenschaft | Datentyp | Beschreibung |
---|---|---|
Die folgenden Einstellungen müssen noch einsortiert werden.
Den Inhaltsassistenten mit neuen Elementen oder sogar eigenen Reitern anpassen