Lernseite · Backend-Benutzer und TSconfig
Wer darf was im Backend? Benutzer, Rechte, TSconfig und Redaktionswerkzeuge
Ein gutes Backend zeigt jeder Person genau das, was sie braucht, und schützt den Rest. Du richtest die Redaktion einer Musikschule ein: Gruppen, Seitenrechte, Mounts und User TSconfig. Danach lernst du ihre Werkzeuge kennen: Rich-Text-Editor, Seitenbaum, Dashboard und interne Notizen.
Das Beispiel: die Musikschule Lindenau
Die Integratorin Mara baut die Website der Musikschule Lindenau mit TYPO3 14.3. Ihr Sitepackage heißt lindenau_site. Mara selbst ist Administratorin. Im Backend sollen außerdem arbeiten:
- Das Sekretariat pflegt alle Seiten, die News und die Termine.
- Die Lehrkräfte pflegen nur die Seiten ihres Fachbereichs, etwa Klavier oder Streicher.
- Die Schulleitung soll alles sehen, aber niemand außer Mara bekommt Admin-Rechte.
Alle Konfiguration, die sich als Datei ablegen lässt, landet im Sitepackage und damit in Git.
Benutzer, Gruppen und Administratoren
Hier geht es nur um Backend-Benutzer, nicht um die Frontend-Benutzer der Website.
Du verwaltest Backend-Benutzer und -Gruppen im Modul Administration > Users. Bis TYPO3 13 hieß es „System > Backend Users“. Dort listest, filterst, legst an und bearbeitest du Benutzer und Gruppen. Mit „Switch to user“ meldest du dich zum Testen als ein anderer Benutzer an. Das Modul ist nur für Administratoren zugänglich.
Die Datensätze liegen auf der obersten Ebene des Seitenbaums, dem Root Node mit der ID 0. Dort dürfen nur Administratoren Datensätze bearbeiten.
Rechte gehören an Gruppen. Eine Backend-Gruppe bündelt, was ihre Mitglieder dürfen. Ein neuer Benutzer bekommt dann nur noch seine Gruppen zugewiesen. Änderst du eine Gruppe, wirkt das sofort für alle Mitglieder.
Mehrere Gruppen addieren sich. Gehört ein Benutzer mehreren Gruppen an, bekommt er die Rechte aller Gruppen zusammen. Eine Gruppe kann einer anderen keine Rechte wegnehmen. Wer etwas nicht darf, dem gibt man das Recht gar nicht erst.
Untergruppen helfen beim Bündeln. Im Reiter General einer Gruppe trägst du unter „Inherit settings from groups“ andere Gruppen ein. Deren Rechte erbt die Gruppe und kann eigene hinzufügen. Mara legt so eine Basisgruppe „Grundrechte“ an, die Sekretariat und Lehrkräfte einbinden.
Vergleichen: Im Modul Users markierst du zwei oder mehr Benutzer oder Gruppen und vergleichst sie nebeneinander. Du siehst dann Rechte, Mounts und TSconfig auf einen Blick. So findest du, warum eine Lehrerin etwas darf und ihr Kollege nicht.
Administratoren dürfen im Backend alles. Für sie gelten weder Gruppen noch Seitenrechte noch Mounts. Sie sehen alle Module, alle Felder und den ganzen Seitenbaum.
Was eine Gruppe erlauben kann
TYPO3 kennt vier Mittel für Rechte im Backend: Access Lists, Mounts, Seitenrechte und User TSconfig. Alle setzt du an Gruppen, und alle werden über mehrere Gruppen addiert.
Die Access Lists verteilt das Gruppenformular in TYPO3 14 auf zwei Reiter. Der Reiter Record Permissions enthält:
- Unter „Table permissions“ wählst du je Tabelle kein Recht, Lesen oder Lesen und Schreiben.
- Unter „Allowed fields“ gibst du Exclude-Felder frei. Das sind Felder, die in der TCA als exclude markiert sind. Nicht-Admins sehen sie erst nach dieser Freigabe. Früher hieß die Liste „Allowed excludefields“.
- Unter „Allowed page types“ legst du fest, welche Seitentypen die Gruppe anlegen darf. Fehlt „Standard“, kann die Gruppe keine normalen Seiten anlegen.
- Unter „Explicitly allow field values“ erlaubst du zum Beispiel einzelne Inhaltstypen.
- Unter „Limit to languages“ beschränkst du die Gruppe auf bestimmte Sprachen.
Der Reiter Module Permissions enthält die „Allowed modules“, also die Backend-Module, die die Gruppe sieht. Dazu kommen die „Allowed dashboard widgets“ und weitere Moduloptionen. Farben des Backends oder Server regeln die Access Lists nicht.
Seitenrechte
Jede Seite hat drei Beteiligte mit eigenen Rechten, ähnlich wie Dateien unter Unix:
- den Besitzer, einen Backend-Benutzer,
- die Gruppe, eine Backend-Gruppe,
- und alle übrigen Backend-Benutzer.
Für jeden der drei gibt es fünf Rechte: Seite anzeigen, Seite bearbeiten, Seite löschen, neue Unterseiten anlegen und Inhalte bearbeiten. Übersetzen oder Verstecken im Frontend sind keine Seitenrechte, das regeln Sprachrechte und die Felder der Seite.
Du setzt Seitenrechte im Modul Administration > Permissions, bis TYPO3 13 „System > Permissions“. Es zeigt je Seite Besitzer, Gruppe und Rechte. Über die Tiefe änderst du sie auch rekursiv für ganze Teilbäume. Auch dieses Modul ist nur für Administratoren da.
Für neue Seiten gibt es in Page TSconfig TCEMAIN.permissions. Damit legst du Besitzer, Gruppe und deren Rechte für jede neu angelegte Seite fest.
TCEMAIN.permissions {
groupid = 3
user = show, edit, delete, new, editcontent
group = show, edit, new, editcontent
everybody = show
}Ohne diese Angabe gehört eine neue Seite dem Benutzer, der sie anlegt, und seiner ersten Gruppe. Die Gruppe darf dann standardmäßig alles außer Löschen.
DB Mounts: welcher Teil des Baums sichtbar ist
Ein DB Mount ist ein Startpunkt im Seitenbaum. Der Benutzer sieht nur diese Seite und ihre Unterseiten, der Rest bleibt ausgeblendet. Im Gruppenformular steht das Feld im Reiter Mounts, in TYPO3 14 heißt es dort „Page Tree Entry Points“. Ohne mindestens einen DB Mount kann ein Benutzer mit keiner Seite arbeiten.
Mara gibt der Gruppe „Lehrkräfte Klavier“ einen DB Mount auf die Seite „Fachbereich Klavier“. Die Klavierlehrer sehen so einen kleinen Baum statt der ganzen Website.
DB Mounts pflegst du üblicherweise an der Gruppe. Am Benutzer kannst du weitere Mounts eintragen. Ob er zusätzlich die Mounts seiner Gruppen bekommt, regelt am Benutzer die Option „Mount from groups“. Sie gibt es getrennt für DB Mounts und Datei-Mounts. Ist sie aus, gelten nur die Mounts am Benutzer selbst.
Ein Mount allein ist keine Sicherheit. Er vereinfacht den Baum, entscheidet aber nicht, was jemand darf. Zusätzlich muss das Seitenrecht „Seite anzeigen“ vorhanden sein. Fehlt es, erscheint die Seite trotz Mount nicht im Baum. Die Sicherheitsrichtlinien empfehlen deshalb, immer auch die Seitenrechte sauber zu setzen.
User TSconfig: das Backend je Benutzer anpassen
User TSconfig nutzt dieselbe Syntax wie TypoScript. Es steuert aber nicht das Frontend, sondern das Backend eines Benutzers oder einer Gruppe: Optionen, Voreinstellungen und erlaubte Funktionen. Frontend-Benutzer haben kein User TSconfig.
Wo es steht: Im Datensatz von Gruppe oder Benutzer gibt es im Reiter Options das Feld TSconfig. Was du dort an einer Gruppe einträgst, gilt für alle Mitglieder. Besser als langer Text im Feld ist ein Import einer Datei aus dem Sitepackage.
@import 'EXT:lindenau_site/Configuration/TsConfig/User/sekretariat.tsconfig'Seit TYPO3 14.2 geht es ohne Importzeile. Eine Extension registriert vorbereitete Dateien in den TCA-Overrides über die Klasse ExtensionManagementUtility. Die Methode registerUserTSConfigFile() ist für Benutzer, registerUserGroupTSConfigFile() für Gruppen. Die Dateien erscheinen dann im Reiter Options unter „Include static TSconfig“ zur Auswahl.
Für alle Benutzer lädt TYPO3 seit Version 13 automatisch die Datei user.tsconfig im Ordner Configuration jeder Extension. Dort setzt Mara Vorgaben, die Gruppen und Benutzer weiter anpassen.
Die Reihenfolge entscheidet, wer gewinnt:
- Zuerst kommen die Dateien
user.tsconfigder Extensions. - Dann folgen die Gruppen in der Reihenfolge, in der sie am Benutzer im Feld Group stehen, von oben nach unten.
- Zuletzt kommt das TSconfig am Benutzer selbst.
Spätere Werte überschreiben frühere. Eine Gruppe weiter unten schlägt also eine Gruppe weiter oben, und der Benutzer schlägt alle Gruppen.
Die wichtigsten Top-Level-Objekte im User TSconfig sind:
- Mit options steuerst du Backend-Funktionen, etwa den Seitenbaum oder die Suche.
- Mit setup setzt du Werte der Benutzereinstellungen vor oder legst sie fest.
- Mit admPanel konfigurierst du das Admin Panel.
- Mit auth steuerst du die Anmeldung, zum Beispiel Pflicht zur Multi-Faktor-Authentifizierung.
- Mit page überschreibst du Werte aus dem Page TSconfig.
- Mit TCAdefaults setzt du Vorgabewerte für neue Datensätze.
Die Namen config und plugin gehören dagegen ins Frontend-TypoScript.
Page TSconfig je Gruppe überschreiben: Eine Eigenschaft mit dem Vorsatz page und einem Punkt ersetzt den Wert aus dem Page TSconfig. So legt nur die Gruppe Lehrkräfte neue Seiten versteckt an:
page.TCAdefaults.pages.hidden = 1So erreichst du alles im Page TSconfig, etwa page.TCEFORM oder page.mod. Werte kannst du dabei nur ersetzen, nicht erweitern.
Prüfen: Das fertige User TSconfig des angemeldeten Benutzers zeigt das Modul System > Configuration der Extension lowlevel. Das Modul steht nur Admins zur Verfügung. Kombiniert mit „Switch to user“ prüft Mara so das TSconfig einer Lehrkraft.
Benutzereinstellungen und Live-Suche
Jeder Backend-Benutzer hat persönliche Benutzereinstellungen, etwa Sprache oder Startmodul. Mit dem Top-Level-Objekt setup greifst du darin ein:
- Mit setup.default setzt du Vorgaben, die der Benutzer selbst ändern darf.
- Mit setup.override erzwingst du einen Wert, den der Benutzer nicht ändern kann.
- Mit setup.fields blendest du einzelne Felder der Benutzereinstellungen aus oder sperrst sie.
setup.default.startModule = dashboard
setup.override.emailMeAtLogin = 1Beide haben eine Tücke: Die Werte landen in den gespeicherten Benutzereinstellungen.
setup.default wirkt nur bei leeren Einstellungen. TYPO3 übernimmt die Vorgaben nur, wenn ein Benutzer noch keine Einstellungen hat, also bei seiner ersten Anmeldung. Ein neues Startmodul per setup.default bemerken bestehende Lehrkräfte deshalb nicht. Mara erreicht sie mit setup.override oder indem sie die Einstellungen zurücksetzt, im Install Tool unter Maintenance mit „Reset Backend User Preferences“.
setup.override bleibt kleben. TYPO3 schreibt den erzwungenen Wert in die Benutzereinstellungen. Entfernt Mara die Zeile wieder, bleibt der Wert dort stehen. Er ändert sich erst, wenn der Benutzer ihn selbst ändert oder die Einstellungen zurückgesetzt werden.
Die Live-Suche oben im Backend findet Seiten und Datensätze. Seit TYPO3 14.2 legst du mit options.liveSearch.actions fest, was ein Klick auf einen Treffer tut. Erlaubt sind edit für das Bearbeitungsformular, layout für das Modul Layout, list für die Datensatzliste und preview für die Vorschau im Frontend. Die Aktion layout gibt es nur für pages und tt_content.
options.liveSearch.actions.tt_content.default = layoutDer Rich-Text-Editor
Der Standard-Editor für formatierten Text ist in TYPO3 14 CKEditor 5, eingebunden durch die System-Extension rte_ckeditor. Seine Konfiguration liegt in YAML-Dateien, den Presets.
Die Konfiguration hat drei Ebenen, die unabhängig voneinander wirken.
- Der Editor zeigt Werkzeugleiste und Plugins und lässt nur bestimmte Inhalte zu. Das regelt das YAML-Preset.
- Die Transformationen gehören zum TYPO3 Core. Sie bereinigen das HTML beim Speichern in die Datenbank und beim Laden in den Editor.
- Die Ausgabe im Frontend steuert die TypoScript-Funktion parseFunc. Sie ändert das gespeicherte HTML nicht.
Wann der Editor erscheint: Ein Textfeld bekommt den Editor nur, wenn in seiner TCA die Option enableRichtext auf true steht. Der Feldname spielt keine Rolle.
Presets: Mitgeliefert sind die Presets default, minimal und full. Ein eigenes Preset ist eine YAML-Datei, die du unter einem Namen registrierst. Das geschieht in der Datei ext_localconf.php des Sitepackages:
$GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets']['lindenau']
= 'EXT:lindenau_site/Configuration/RTE/Lindenau.yaml';Preset auswählen kannst du per Page TSconfig. RTE.default.preset gilt für alle Felder, die in der TCA kein eigenes Preset festlegen. Mit RTE.config, Tabelle und Feld wählst du ein Preset für ein einzelnes Feld. Mit dem Zusatz types und dem Inhaltstyp sogar nur für einen Typ. Der genauere Wert gewinnt.
RTE.default.preset = minimal
RTE.config.tt_content.bodytext.preset = lindenau
RTE.config.tt_content.bodytext.types.textmedia.preset = fullEigene Plugins: CKEditor-5-Plugins sind JavaScript-Module. Das Preset lädt sie in der Liste importModules. Danach stellst du ihre Werkzeuge in der Werkzeugleiste ein.
editor:
config:
importModules:
- { module: '@lindenau/site/notenzeichen.js', exports: ['Notenzeichen'] }
toolbar:
items: [bold, italic, link, '|', notenzeichen]Der Seitenbaum
Der Seitenbaum links im Backend zeigt die Struktur aller Seiten. Aus dieser Struktur entstehen meist auch die Menüs im Frontend: Der MenuProcessor oder das TypoScript-Objekt HMENU liest Seiten und Reihenfolge aus dem Baum. Seiten mit der Option „In Menüs verbergen“ fehlen dort.
Im Baum arbeitest du so:
- Kontextmenü: Ein Klick auf das Symbol einer Seite oder ein Rechtsklick öffnet das Kontextmenü. Dort findest du zum Beispiel Bearbeiten, Kopieren, Ausblenden oder den Verlauf.
- Neue Seite: Über dem Baum steht eine Leiste mit Seitentypen. Du ziehst einen Typ mit der Maus an die gewünschte Stelle im Baum.
- Verschieben und Kopieren: Auch vorhandene Seiten ziehst du per Drag and Drop an eine neue Position.
- Filter: Das Suchfeld filtert den Baum nach Titel, Navigationstitel oder Seiten-ID.
Seit TYPO3 14.1 findet der Filter Seiten auch über ihre Übersetzungen. Sucht das Sekretariat nach dem englischen Titel „Piano lessons“, zeigt der Baum die deutsche Seite „Klavierunterricht“. Mit der User-TSconfig-Option options.pageTree.searchInTranslatedPages schaltest du das für einzelne Gruppen ab.
Das Dashboard
Das Dashboard ist ein Backend-Modul aus Widgets, kleinen Kacheln mit Informationen. Beispiele sind Sicherheitshinweise, zuletzt geänderte Seiten oder Nachrichten aus einem RSS-Feed. Es steht als erstes Modul im Menü und öffnet sich deshalb nach der Anmeldung, wenn kein anderes Startmodul gewählt ist.
Eigene Dashboards: Jeder Benutzer kann mehrere Dashboards haben. Ein neues legt er mit dem Plus-Zeichen an und wählt dabei ein Preset, also eine Vorlage mit vorgegebenen Widgets. Zwischen den Dashboards wechselt er über Reiter.
Welche Widgets erlaubt sind: Administratoren haben Zugriff auf alle Widgets. Andere Benutzer sehen nur die Widgets, die eine ihrer Gruppen im Reiter Module Permissions unter „Allowed dashboard widgets“ freigibt. Manche Widgets, etwa die letzten Backend-Anmeldungen, sind ganz Admins vorbehalten.
Dashboards für neue Benutzer: Welche Dashboards ein neuer Benutzer beim ersten Öffnen bekommt, legst du per User TSconfig fest. Die Option nennt eine oder mehrere Preset-Kennungen. Ohne Angabe gilt das Preset default.
options.dashboard.dashboardPresetsForNewUsers = default, lindenauLehrkraefteWidgets für Entwickler: Widgets werden als Services in YAML registriert, in der Service-Konfiguration einer Extension. Dort stehen Kennung, Titel, Widget-Gruppe, Größe und Optionen. So stellen Entwickler eigene Widgets bereit.
Seit TYPO3 14 können Widgets zudem je Instanz eigene Einstellungen haben. Ein Zahnrad am Widget öffnet sie. Mara legt so dasselbe RSS-Widget zweimal an, einmal mit dem Feed des Musikverbands, einmal mit dem Feed der Stadt.
Interne Notizen
Die System-Extension sys_note erlaubt Backend-Benutzern interne Notizen. Damit hinterlässt Mara zum Beispiel auf der Seite „Anmeldung“ einen Hinweis für das Sekretariat. Besucher der Website sehen diese Notizen nie.
- Kategorie und Farbe: Jede Notiz hat eine Kategorie: Default, Instructions, Template, Notes oder To-do. Je nach Kategorie erscheint sie in einer anderen Farbe.
- Persönlich: Ohne diese Option sehen alle Backend-Benutzer mit Zugriff auf die Seite die Notiz. Mit der Option sieht sie nur der Verfasser.
- Position: Du wählst, ob die Notiz oben oder unten im Inhaltsbereich erscheint, zum Beispiel im Modul Layout.
- Widget: sys_note bringt ein Dashboard-Widget mit. Es listet Seiten mit internen Notizen und lässt sich auf eine Kategorie einschränken.
Das Wichtigste in Kürze
- Benutzer und Gruppen verwaltest du in Administration > Users. Rechte gehören an Gruppen und addieren sich, keine Gruppe nimmt Rechte weg.
- Exclude-Felder sehen Nicht-Admins nur nach Freigabe unter „Allowed fields“.
- Seitenrechte gibt es für Besitzer, Gruppe und alle, gesetzt in Administration > Permissions. Vorgaben für neue Seiten setzt TCEMAIN.permissions.
- Ein DB Mount macht einen Teil des Baums sichtbar. Ohne das Seitenrecht „Seite anzeigen“ bleibt die Seite trotzdem unsichtbar.
- User TSconfig gilt in der Reihenfolge Extensions, Gruppen von oben nach unten, Benutzer. Der letzte Wert gewinnt.
- Mit page. überschreibt User TSconfig das Page TSconfig. Das Ergebnis zeigt System > Configuration.
- setup.default wirkt nur bei leeren Benutzereinstellungen, setup.override bleibt nach dem Entfernen gespeichert.
- CKEditor 5 hat drei Ebenen: YAML-Preset, Transformation, parseFunc. Der genauere Preset-Wert im Page TSconfig gewinnt.
- Widgets brauchen eine Freigabe in der Gruppe und haben seit TYPO3 14 eigene Einstellungen.
Begriffe
- Backend-Benutzergruppe
- Datensatz, der Rechte für seine Mitglieder bündelt und andere Gruppen als Untergruppen erben kann.
- Access Lists
- Rechte einer Gruppe für Module, Tabellen, Felder, Seitentypen, Feldwerte, Sprachen und Widgets.
- Exclude-Feld
- Feld, das in der TCA als exclude markiert ist und für Nicht-Admins erst nach Freigabe sichtbar wird.
- DB Mount
- Startpunkt im Seitenbaum, ab dem ein Benutzer Seiten sieht.
- User TSconfig
- Konfiguration in TypoScript-Syntax, die das Backend für Benutzer und Gruppen steuert.
- Preset
- Benannte YAML-Konfiguration für den Rich-Text-Editor.
- Widget
- Kachel im Dashboard mit Informationen, registriert als Service.
- Interne Notiz
- Hinweis aus der Extension sys_note, den nur Backend-Benutzer sehen.