===== 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: - User TSconfig (Benutzer) - User TSconfig (Gruppe - die __letzte__ in der Gruppenliste des Benutzers; __nicht__ die Hauptgruppe!) - Page TSconfig (Unterseite) - Page TSconfig (root) Nachfolgend ist eine Auswahl von Eigenschaften aufgeführt, die ich persönlich für sinnvoll halte. ==== User TSconfig - Top Level Objects ==== ^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| ==== Page TSconfig - Top Level Objects ==== ^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| ---- ===== User TSconfig ===== ==== admPanel ==== ^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 } | ==== options ==== ^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 leeren\\ ''options.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 ausgeblendet\\ ''deactivated'' -> 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''.| ==== setup ==== ^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.| ==== 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. ^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 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.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 ausgeblendet\\ ''deactivated'' -> 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''.| ==== RTE ==== Dem Rich Text Editor ist [[typo3:about:rte|hier]] eine eigene Seite gewidmet. ==== TCEMAIN ==== ^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:| ==== TCEFORM ==== 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 = || ^[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| [[typo3:about:tsconfig:dbfelder|Änderbare Datenbankfelder von pages und tt_content]] ==== TSFE ==== ^Eigenschaft^Datentyp^Beschreibung^ ^ | | | ---- ==== Eigene Elemente im Inhaltsassistenten ==== Die folgenden Einstellungen müssen noch einsortiert werden. [[http://buzz.typo3.org/people/steffen-kamper/article/the-new-content-element-wizard-in-version-43/|Den Inhaltsassistenten mit neuen Elementen oder sogar eigenen Reitern anpassen]] ---- ==== TSconfig Beispiele ==== [[typo3:about:tsconfig:tsconfig-sammlung|Sammlung von TSconfig-Einstellungen]]