Benutzer-Werkzeuge

Webseiten-Werkzeuge


typo3:about:tsconfig

TSconfig

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.

Hierarchie

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:

  1. User TSconfig (Benutzer)
  2. User TSconfig (Gruppe - die letzte in der Gruppenliste des Benutzers; nicht die Hauptgruppe!)
  3. Page TSconfig (Unterseite)
  4. Page TSconfig (root)

Nachfolgend ist eine Auswahl von Eigenschaften aufgeführt, die ich persönlich für sinnvoll halte.

User TSconfig - Top Level Objects

EigenschaftDatentypBeschreibung
admPanelADMPANELDas FE Admin Panel lässt sich für BE-Benutzer anpassen.
optionsOPTIONSVerschiedene Benutzer-Anpassungen des TYPO3-Kerns, z.B. Cache-Buttons, Bookmark- und Seitenbaumeinstellungen.
modMODOptionen für die Backend-Module. Deprecated! Stattdessen page.mod verwenden.
setup.default / setup.overrideSETUPWerte 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]stringSetzt 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.
pageAlle Page TSconfig-EigenschaftenAlle 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

Page TSconfig - Top Level Objects

EigenschaftDatentypBeschreibung
modMODOptionen für die Backend-Module. page.mod. in der User TSconfig hat Vorrang.
RTERTEEinstellungen für den Rich Text Editor
TCEMAINTCEMAINKonfiguration der TYPO3 Core Engine
TCEFORMTCEFORMZusätzliche Konfiguration für Formularfelder
TSFETSFEOptionen für das TSFE Frontend-Objekt
user Deprecated! Stattdessen tx_* bei Extensions verwenden
tx_[Extension-Key ohne weiteren Unterstrich] Reserviert für Extensions

User TSconfig

admPanel

EigenschaftDatentypBeschreibung
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
}
hidebooleanWenn 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
}

options

EigenschaftDatentypBeschreibung
clearCachebooleanErmö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 leeren
options.clearCache.clearRTECache = 1 → RTE-Cache leeren
saveClipboardbooleanWenn aktiviert, wird der Inhalt der gesamten Zwischenablage über den Logout hinaus gespeichert.
clipboardNumberPadsinteger (0-20)Ermöglicht das Anlegen von Zwischenablagen von 0 bis 20.
Array von integern/ integer, stringsErmö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.backgroundColorstringab 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.showPageIdWithTitlebooleanWenn aktiviert, werden im Seitenbaum die UIDs der Seiten in eckigen Klammern vor die Namen gesetzt.
pageTree.showDomainNameWithTitlebooleanWenn aktiviert, wird die erste der angegebenen Domains neben dem Seitentitel angegeben. Voraussetzung ist neben einer Domain die Seiteneigenschaft Use as Root Page.
pageTree.showNavTitlebooleanWenn aktiviert, wird statt dem Seitennamen der Navigationstitel im Seitenbaum angezeigt.
pageTree.showPathAboveMounts = 1booleanWenn aktiviert, werden bei DB Mounts die Pfade zum betreffenden Mount angezeigt.
folderTree.hideCreateFolderbooleanWenn aktiviert, kann der Benutzer keine neuen Ordner im filadmin anlegen.
file_list.enableDisplayBigControlPanelbooleanErmöglicht das Aktivieren der erweiterten Ansicht im fileadmin.
Mögliche Werte:
selectable → Eigenschaft deaktiviert und Checkbox eingeblendet (Standard)
activated → Eigenschaft aktiviert und Checkbox ausgeblendet
deactivated → Eigenschaft deaktiviert und Checkbox ausgeblendet.
file_list.enableDisplayThumbnailsbooleanErmöglicht das Aktivieren der Vorschaubilder im fileadmin. Mögliche Werte siehe enableDisplayBigControlPanel.
file_list.enableClipBoardbooleanErmöglicht das Aktivieren der Zwischenablage im fileadmin. Mögliche Werte siehe enableDisplayBigControlPanel.

setup

EigenschaftDatentypBeschreibung
thumbnailsByDefaultbooleanZeigt die Vorschaubilder an.
titleLenpositive integerGibt die angezeigte Länge der Datensatz-Titel an.
edit_wideDocumentbooleanErweitert die Breite der Eingabeformulare um ca. 50%.
edit_RTEbooleanAktiviert den Rich Text Editor.
langSprachschlüsselSetzt die Backendsprache des Benutzers, z.B. setup.default.lang = de.
resizeTextareasbooleanErmöglicht die Größenanpassung von Textfeldern.
resizeTextareas_MaxHeightpositive integerGibt die maximale Höhe von Textfeldern an.
startModulestringStellt die Startseite im Backend ein, z.B. setup.default.startModule = web_list.
[Eigenschaft].disabledbooleanBlendet die genannte Eigenschaft in den Benutzereinstellungen aus.

TCAdefaults

# 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

Page TSconfig

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.

mod

Die Eigenschaften von mod können auch direkt in der User TSconfig verwendet werden, ohne dass page. vorangestellt werden muss.

EigenschaftDatentypBeschreibung
[Modulname].menu.[Name]booleanViele 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.defaultLanguageFlagstringDie 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.listOnlyInSingleTableViewbooleanWenn aktiviert, werden in der Listenansicht nur noch die Tabellennamen angezeigt. Die Inhalte erreicht man über den Single Table View (Plus-Button).
web_list.itemsLimitPerTablepositive integerMax. Anzahl der Einträge pro Tabelle in der Listenansicht. Standard: 20.
web_list.itemsLimitSingleTable positive integerMax. Anzahl der Einträge im Single Table View. Mehr Einträge verteilen sich auf weitere Seiten. Standard: 100.
web_list.noExportRecordsLinksbooleanSeit 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.hideTablesListe von TabellennamenErmöglicht das Ausblenden von Tabellen in der Listenansicht.
mod.web_list.hideTables = pages
web_list.disableSearchBoxbooleanWenn aktiviert, wird die Suche unterhalb der Zwischenablage ausgeblendet.
mod.web_list.disableSearchBox = 1
web_list.allowedNewTablesListe von TabellennamenNur 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.deniedNewTablesListe von TabellennamenDas 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.clickTitleModestringSteuert 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 bearbeiten
info → Neues Fenster mit Informationen
show → Zeigt den Datensatz im Frontend
Bei 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.enableDisplayBigControlPanelbooleanErmöglicht das Aktivieren der erweiterten Ansicht in der Listenansicht.
Mögliche Werte:
selectable → Eigenschaft deaktiviert und Checkbox eingeblendet (Standard)
activated → Eigenschaft aktiviert und Checkbox ausgeblendet
deactivated → Eigenschaft deaktiviert und Checkbox ausgeblendet.
web_list.enableClipBoardbooleanErmöglicht das Aktivieren der Zwischenablage in der Listenansicht. Mögliche Werte siehe enableDisplayBigControlPanel.
web_list.enableLocalizationViewbooleanErmöglicht das Aktivieren der Lokalisierungsansicht in der Listenansicht. Mögliche Werte siehe enableDisplayBigControlPanel.

RTE

Dem Rich Text Editor ist hier eine eigene Seite gewidmet.

TCEMAIN

EigenschaftDatentypBeschreibung
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.groupidIntegerEinstellung 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.everybodyInteger, StringRegelt 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
} 
clearCacheCmdInteger, StringBeim 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
translateToMessageStringErsetzt bei zu übersetzendem Inhaltselement den vorangesetzten String Translate to [Sprache]: . %s wird durch den Sprachnamen ersetzt.
TCEMAIN.translateToMessage = Bitte in "%s" übersetzen:

TCEFORM

Formularfelder bearbeiten:

EigenschaftDatentypBeschreibung
[Tabelle].[Feld]. disabledbooleanFeld im Formular entfernen.
TCEFORM.tt_content.subheader.disabled = 1
[Tabelle].[Feld]. removeItemsWertelisteOptionen aus select-Liste entfernen.
# Beispiel Überschriften (0 = 'Standard'; 100 = 'Versteckt')
TCEFORM.tt_content.header_layout.removeItems = 1,3,4,5,100
[Tabelle].[Feld]. keepItemsWertelisteOptionen 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]. addItemsStringOptionen 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].labelStringFeldnamen 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]. altLabelsStringOptionen aus select-Liste umbenennen.
TCEFORM.tt_content.header_layout.altLabels.1 = LLL:EXT:basetemplate8/Resources/Private/Language/locallang_be.xlf:header_layout.altLabels.1

Änderbare Datenbankfelder von pages und tt_content

TSFE

EigenschaftDatentypBeschreibung

Eigene Elemente im Inhaltsassistenten

Die folgenden Einstellungen müssen noch einsortiert werden.

Den Inhaltsassistenten mit neuen Elementen oder sogar eigenen Reitern anpassen


TSconfig Beispiele

typo3/about/tsconfig.txt · Zuletzt geändert: 2017/12/14 21:19 von admin