Docs
Docs
Allesda
DE | EN
Plugins
Allesda
DE | EN
Plugins

ROLLEN

Dokumentation
Zurück

ROLLEN

Wofür ist das?

Das ROLLEN-Plugin steuert:

  • Benutzer des Mandanten (Login-Konten)
  • Rollen (z.B. „Admin“, „Verwaltung“, „Helfer“)
  • Berechtigungen je Rolle (z.B. „Tickets sehen“, „Verträge bearbeiten“)
  • Sektionen im Menü (welche Plugins/Items für welche Rolle sichtbar sind)
  • allgemeine Einstellungen des Mandanten (Logo, Branding, UI-Präferenzen)
  • das eigene Profil (Sprache, Anzeige, Passwort)

Es ist die zentrale Stelle für „Wer darf was?“ und gleichzeitig für globale Mandanten-Einstellungen.

Typische Aufgaben (Alltag)

  • Neuen Benutzer anlegen
  • Benutzer einer Rolle zuordnen
  • Rollen anlegen / umbenennen / löschen
  • Berechtigungen einer Rolle pflegen
  • Menü-Struktur (Sektionen) konfigurieren
  • Mandanten-Logo hochladen
  • Eigenes Profil pflegen

Schritt-für-Schritt

1) Benutzer verwalten

#### Liste & neuer Benutzer
1. Admin → Benutzer (/settings/admin/users).
2. „Neu“ (/settings/admin/users/new).
3. Benutzername, Anzeigename, E-Mail, Passwort, Rolle wählen.
4. Speichern (POST /settings/admin/users).

#### Bearbeiten / Passwort zurücksetzen

  • GET /settings/admin/users/{username}/edit → Felder ändern → POST /settings/admin/users/{username}.

2) Rollen verwalten

1. Admin → Rollen (/settings/admin/roles).
2. „Neu“ (/settings/admin/roles/new) oder bestehende Rolle bearbeiten.
3. POST /settings/admin/roles zum Anlegen, POST /settings/admin/roles/{name} zum Speichern, POST /settings/admin/roles/{name}/delete zum Löschen.

3) Berechtigungen einer Rolle

1. Admin → Berechtigungen (/settings/admin/permissions/{roleName}).
2. Sie sehen alle bekannten Berechtigungen, jeweils mit Stufe:

  • NONE – nicht sichtbar / kein Zugriff
  • VIEW – darf sehen
  • EDIT – darf bearbeiten

3. Werte anpassen → speichern (POST /settings/admin/permissions/{roleName}).

4) Menü-Sektionen

Sektionen bestimmen, was im linken Menü erscheint und in welcher Gruppierung.

Wichtige Pfade:

  • GET /settings/admin/sections – Übersicht
  • Plugins-Block: /settings/admin/sections/plugins
  • User-Block: /settings/admin/sections/user
  • Administrations-Untergruppen:
  • /settings/admin/sections/administration/content
  • /settings/admin/sections/administration/contracts
  • /settings/admin/sections/administration/users
  • /settings/admin/sections/administration/mail
  • /settings/admin/sections/administration/system

Pro Block können Sie Items aktivieren / deaktivieren, sortieren und Rollen zuweisen, die das Item sehen dürfen.

5) Allgemeine Einstellungen (Branding, Logo, UI)

1. Admin → Allgemein (/settings/admin/general).
2. Optionen:

  • Logo hochladen → POST /settings/admin/general/logo/upload
  • Logo ausliefern → GET /settings/admin/general/logo/serve
  • Logo entfernen → POST /settings/admin/general/logo/delete
  • Sonstige Einstellungen → POST /settings/admin/general/save

3. UI-Präferenzen einzelner Nutzer (z.B. ein-/ausgeklappte Sidebar, Seitenbreite) werden über kleine Endpunkte gespeichert:

  • /settings/admin/general/ui/pref
  • /settings/admin/general/ui/pref/pageWidth

6) Eigenes Profil

1. Profil im Menü (üblicherweise unter dem eigenen Namen).
2. Anzeigename, Passwort, Sprache, optionale Einstellungen pflegen.

Häufige Fragen / Probleme

„Ich sehe ein Plugin nicht“

  • Prüfen Sie, ob das Plugin für den Mandanten aktiviert ist.
  • In den Sektionen ist es ggf. nicht der Rolle zugeordnet.
  • Berechtigungen prüfen.

„Niemand kann sich mehr anmelden“

  • Eventuell wurde die Admin-Rolle entfernt. Stellen Sie sicher, dass mindestens ein Benutzer Vollzugriff hat. Im Notfall hilft nur ein DB-Eingriff durch den Hoster.

„Logo wird nicht angezeigt“

  • Datei korrekt hochgeladen?
  • Browser-Cache leeren.

Technische URLs (Kurzreferenz)

Allgemein (/settings/admin/general):

  • GET /settings/admin/general
  • POST /settings/admin/general/save
  • POST /settings/admin/general/logo/upload
  • GET /settings/admin/general/logo/serve
  • POST /settings/admin/general/logo/delete
  • GET /settings/admin/general/ui/pref
  • POST /settings/admin/general/ui/pref
  • GET /settings/admin/general/ui/pref/pageWidth
  • POST /settings/admin/general/ui/pref/pageWidth

Benutzer (/settings/admin/users):

  • GET /settings/admin/users
  • GET /settings/admin/users/new
  • POST /settings/admin/users
  • GET /settings/admin/users/{username}/edit
  • POST /settings/admin/users/{username}

Rollen (/settings/admin/roles):

  • GET /settings/admin/roles
  • GET /settings/admin/roles/new
  • POST /settings/admin/roles
  • GET /settings/admin/roles/{name}/edit
  • POST /settings/admin/roles/{name}
  • POST /settings/admin/roles/{name}/delete

Berechtigungen (/settings/admin/permissions):

  • GET /settings/admin/permissions/{roleName}
  • POST /settings/admin/permissions/{roleName}

Sektionen (/settings/admin/sections):

  • GET/POST /settings/admin/sections
  • GET/POST /settings/admin/sections/plugins
  • GET/POST /settings/admin/sections/user
  • GET/POST /settings/admin/sections/administration/content
  • GET/POST /settings/admin/sections/administration/contracts
  • GET/POST /settings/admin/sections/administration/users
  • GET/POST /settings/admin/sections/administration/mail
  • GET /settings/admin/sections/administration/system

Hinweise

  • ROLLEN ist Voraussetzung für die Rechte-Prüfungen (@RequirePermission) in anderen Plugins.
  • Vergeben Sie Berechtigungen so eng wie möglich – sicherer als „alle dürfen alles“.
  • Ändern Sie Sektionen vorsichtig: Sie steuern damit das Menü für alle Nutzer dieses Mandanten.