Systemkonfiguration

Die Systemkonfiguration ist das Herz der Admin-Anpassung. Hier richten Sie Logo, Farben, Schrift, CSS-Erweiterungen, Login-Verfahren, URLs, Speicher-Limits, Feature-Schalter, UI-Begriffe und Lernort-Typen ein.

Überblick

Die Konfiguration ist auf vier Sub-Bereiche verteilt, die jeweils eigene Berechtigungen tragen:

Sub-Bereich	URL	Berechtigung	Schwerpunkt
Konfiguration (Design)	`/administration/config`	`edit_config`	Logo, Farben, Schrift, CSS, Footer-Bilder
Einstellungen (Funktion)	`/administration/settings`	`edit_settings`	Login-Verfahren, URLs, Limits, Feature-Flags, DSGVO-Text
Begriffe umbenennen (Renaming)	`/administration/renamings`	`edit_renamings`	UI-Texte instanzweit anpassen
Lernort-Typen	`/administration/locations`	`edit_settings`	Kategorien für Lernorte

In diesem Abschnitt sind alle vier Bereiche gemeinsam dokumentiert. Verwandte Themen sind in eigenen Abschnitten:

Profilfelder → Profil
Berichtsheft-Export-Layout → Portfolio-Bericht
Stack-Vorlagen → Templates
Ausbildungsbetriebe → Administration

Für wen ist dieser Bereich?

⚙️ Admin / 🛡️ Superadmin

Zugang zur jeweiligen Sub-Seite hängt von der konkreten Permission ab:

edit_config → Konfiguration (Design)
edit_settings → Einstellungen, Lernort-Typen
edit_renamings → Renaming
view_administration → grundsätzlicher Zugang zum Admin-Bereich

In der Standardkonfiguration besitzt der Superadmin alle vier Berechtigungen. Admins sehen den Admin-Bereich, haben aber nicht automatisch edit_settings/edit_config/edit_renamings. Vergeben Sie diese Permissions gezielt, wenn Admins eigenständig konfigurieren sollen — siehe Rechte & Rollen.

1) Konfiguration (Design)

⚙️ Admin / 🛡️ Superadmin mit edit_config

Menü: Administration → Konfiguration
URL: /administration/config

In diesem Bereich werden visuelle Aspekte gesteuert.

Bilder

Schlüssel	Bedeutung
`system_logo`	Logo, das im Header und in der Mobile-Navigation angezeigt wird
`system_footer_1` … `system_footer_5`	Bis zu fünf Footer-Bilder (Partnerlogos, Förderhinweise)

Erlaubte Formate: PNG, JPEG, GIF. Speicherort: media/tenant/{tenantId}/config/.

Pro Bild lassen sich:

Hochladen (neue Datei wählen)
Löschen (Aktion <key>_delete setzen)

Farben

14 Theme-Farben sind konfigurierbar:

Schlüssel	Standardwert	Bedeutung
`primary_light`	`#95C11F`	Primärfarbe Hell
`primary_dark`	`#056336`	Primärfarbe Dunkel
`secondary_light`	`#5A84C3`	Sekundärfarbe Hell
`secondary_medium`	`#124E9B`	Sekundärfarbe Medium
`secondary_dark`	`#00336A`	Sekundärfarbe Dunkel
`highlighting`	`#6D4F9B`	Highlights / Akzent
`black`	`#000`	Schwarz
`main_back`	`#0F0F0F`	Schwarz – Hell
`gray_dark`	`#6B6A6A`	Grau – Dunkel
`gray_medium`	`#B2B2B2`	Grau – Medium
`gray_light`	`#ECECEC`	Grau – Hell
`white`	`#fff`	Weiß
`warning`	`#F0A73A`	Warn-Orange
`error`	`#DD5234`	Fehler-Rot

Die Auswahl erfolgt mit dem Color-Picker (iro.js). Die SCSS-Variablen werden aus diesen Werten neu kompiliert.

⚠️ Hinweis: Das Skript zum Generieren der neuen Style-Datei kann je nach Server-Setup fehlschlagen. In dem Fall lässt sich die Datei manuell mit npm run prod neu bauen oder per Cronjob mit checkColorsFileForRecompiling.php minütlich prüfen (Beispiel: * * * * * php /var/www/html/checkColorsFileForRecompiling.php). Details siehe Server-Installations-Dokumentation Ihrer Instanz.

Schriftart

system_font — wählbar aus den in config('settings.fonts') hinterlegten Schriftarten. Default: Lato.

Eigene CSS-Erweiterung

system_extended_css_file — Sie können eine .css-Datei hochladen, deren Inhalt zusätzlich geladen wird. Damit lassen sich Detailanpassungen umsetzen, ohne den Quellcode zu ändern.

Info-Text

info_content — frei formulierbarer Text, der z. B. im globalen Hilfe-/Info-Bereich angezeigt wird.

2) Einstellungen (Funktion)

⚙️ Admin / 🛡️ Superadmin mit edit_settings

Menü: Administration → Einstellungen
URL: /administration/settings

Funktionale Steuerung der Instanz.

Allgemeines

Feld	Schlüssel	Wirkung
Seitentitel	`page_title`	Browser-Tab-Titel; Default: `APP_NAME` aus `.env`
Design-Variante	`design_variant`	`default` oder `leando` (siehe `Config::DESIGN_*`)

Login & Anmeldung

Feld	Schlüssel	Wirkung
Login-Typ	`login_type`	`registration`, `creation`, `ldap`, `keycloak` (siehe Login & Registrierung)

Hilfe

Feld	Schlüssel	Wirkung
Hilfe aktiv	`help_active`	Schaltet die Hilfe-Sidebar an/aus
Hilfe-URL	`help_url`	Externer Link, der aus der Sidebar geöffnet wird
Hilfe-Selektor	`help_selector`	CSS-Selektor (global) für kontextbezogene Hilfe-Anker

Externe URLs (Footer)

Feld	Schlüssel	Wirkung
Impressum	`url_impressum`	Footer-Link
Datenschutz	`url_data_protection`	Footer-Link
Konzept	`url_concept`	Footer-Link „Zum Konzept“
Feedback	`url_feedback`	Externer Feedback-Kanal

Speicher- und Upload-Limits

Feld	Schlüssel	Wirkung
Speicher pro User limitieren	`limit_data_size`	Aktiviert die Limit-Logik
Speicher pro User in MB	`data_size_limit`	Limit-Größe (Default 100)
Maximale Upload-Größe in MB	`max_upload_size`	Pro-Datei-Größenlimit
Standard-Ablauffrist Link-Freigaben	`publish_expiration_days`	Default-Ablauf in Tagen (Default 30)

Feature-Schalter

Feld	Schlüssel	Wirkung
Berichtsheft-Tab anzeigen	`exports_show_ausbildungsnachweis`	Tab „Ausbildungsnachweise“ im Teilen-Bereich
Digitales Berichtsheft aktiv	`digital_education_report_enabled`	Aktiviert den ganzen Berichtsheft-Workflow inkl. Trainer-/Kammer-Dashboards
Autor:innenname anzeigen	`show_author_name`	Zeigt in Link-Freigaben ggf. den Namen des Erstellers

Datenschutz-Inhalt

Feld	Schlüssel	Wirkung
Datenschutz-Text	`data_protection_content`	Wird Nutzer:innen beim ersten Login zur Zustimmung präsentiert (siehe Erste Schritte)

⚠️ Pflicht: Geben Sie einen eigenen Datenschutz-Text vor — er ist nicht vorgeloggt und wird bei jeder Erstanmeldung angezeigt.

3) Begriffe umbenennen (Renaming)

🛡️ Superadmin mit edit_renamings

Menü: Administration → Begriffe
URL: /administration/renamings

Hier passen Sie die UI-Texte instanzweit an. Die Liste umfasst alle in der Future-Box verwendeten Renaming-Schlüssel (siehe Terminologie für eine Übersicht).

Funktionsweise

Auf der Seite sehen Sie alle Schlüssel mit ihrem aktuellen Wert.
Wert ändern → „Speichern“.
Die Future-Box aktualisiert die Datenbank-Tabelle und löscht den Cache (renaming_<key> wird neu gesetzt mit 1 Monat TTL).
Der neue Begriff ist sofort instanzweit sichtbar.

Häufig angepasste Schlüssel

Schlüssel	Default	Häufige Anpassung
`entry_singular` / `entry_plural`	Memo / Memos	„Eintrag“ / „Einträge“, „Lerntagebuch-Eintrag“
`category_singular` / `category_plural`	Aufgabenbereich / Aufgabenbereiche	„Stack“ / „Stacks“, „Lernfeld“ / „Lernfelder“
`share_singular` / `share_plural`	Vorlage / Vorlagen	„Geteilte Sammlung“
`education_singular` / `education_plural`	Ausbildungsnachweis / Ausbildungsnachweise	„Praxisbericht“, „Lernbericht“
`company_singular` / `company_plural`	Betrieb / Betriebe	„Praxispartner“ / „Praxispartner“
`role_apprentice`, `role_teacher` …	Auszubildender, Lehrperson …	Rollen-Bezeichnungen
`navigation_*`	siehe Hauptmenü	Menü-Beschriftungen

💡 Tipp: Nehmen Sie sich vor dem Produktivstart 30 Minuten Zeit, alle Renamings einmal durchzugehen. Eine konsistente Sprache in der Oberfläche zahlt sich pädagogisch und kommunikativ aus.

⚠️ Hinweis: Renamings ändern nur die UI-Beschriftungen. Bestehende Inhalte (Memo-Texte, Stack-Titel) bleiben unangetastet. Sicherheits- und Permission-Logik basiert weiterhin auf den festen Code-Schlüsseln.

4) Lernort-Typen

⚙️ Admin / 🛡️ Superadmin mit edit_settings

Menü: Administration → Lernort-Typen
URL: /administration/locations

Lernort-Typen sind übergreifende Kategorien für die individuellen Lernorte der Lernenden. Beispiele: „Schule“, „Betrieb“, „Praktikum“, „Online-Lernen“, „Selbststudium“.

Lernort-Typ anlegen

Auf „Hinzufügen“ klicken.
Felder ausfüllen:

Anzeigename (value) — wie der Typ den Nutzer:innen angezeigt wird.
Schlüssel (key) — technischer Bezeichner; wird beim Speichern automatisch in Kleinbuchstaben überführt.

„Speichern“.

Lernort-Typ bearbeiten oder löschen

In der Liste stehen Stift- und Lösch-Symbole zur Verfügung. Beim Löschen werden zugehörige Lernorte (Location) ggf. ihre Typ-Zuordnung verlieren — prüfen Sie vor dem Löschen, ob bereits Lernende den Typ verwenden.

💡 Tipp: Lernort-Typen wirken in PDF-Exporten und Berichtshefts als Gruppierungs-Kategorie. Eine durchdachte Liste verbessert die Lesbarkeit der Berichte.

Hinweise & Tipps

Reihenfolge der Erstkonfiguration: Login-Typ → URLs → Limits → Feature-Schalter → Renamings → Design (siehe Administration, Abschnitt „Erste Schritte für eine neue Instanz“).
Renamings vor Templates: Wenn Sie sowohl Renamings als auch Stack-Vorlagen einrichten, beginnen Sie mit den Renamings — Vorlagen-Beschreibungen können dann gleich die neue Sprache verwenden.
Datenschutz-Text gewissenhaft pflegen: Dieser Text ist Teil der DSGVO-Compliance Ihrer Instanz. Lassen Sie ihn ggf. von der Datenschutzbeauftragten Ihrer Einrichtung prüfen.
Footer-Bilder zur Förder-Anerkennung: Die fünf Footer-Bilder eignen sich gut, um Förderlogos (z. B. BMBF, ESF) sichtbar einzubinden.
Eigene CSS für Feinschliff: Statt am Quellcode zu arbeiten, hinterlegen Sie kleine Anpassungen (Schrift-Optionen, Abstände) als CSS-Datei in system_extended_css_file.
Test-Instanz: Wenn Sie größere Konfigurationsänderungen planen, probieren Sie sie in einer Test-Instanz aus — Renaming-Änderungen wirken sofort, sind aber bei laufenden Schulungen verwirrend.