Module Modern Template DE: Difference between revisions

=== '''ModernTemplate — Modernisierte Benutzeroberfläche für Dolibarr''' ===

=== '''Übersicht''' ===

=== '''Hauptfunktionen''' ===

* Zentrale Navigation über Kacheln + synchronisierte Untermenüs

* Drag & Drop der Kacheln mit globaler oder benutzerspezifischer Speicherung

* Multi-Objekt-Suche (exakte Referenzen + Drittparteien/Kontakte + Fallback auf globale Suche)

* Schnelle Personalisierung: Farben, Startseite, Hilfe-URL, Sichtbarkeit von Tabs

* Eingebaute ModernTemplate-Seiten

=== '''Übersetzungen''' ===

=== '''Voraussetzungen''' ===

* Dolibarr 22.x (empfohlen)

* PHP 7.4+

* Schreibzugriff auf die Datenbank und den Ordner <code>/custom/moderntemplate</code>

=== '''Installation''' ===

# Kopieren Sie den Ordner <code>moderntemplate/</code> nach <code>htdocs/custom/</code>

# In Dolibarr: '''Setup → Module/Anwendungen''' → aktivieren Sie '''ModernTemplate'''

# Öffnen Sie <code>/custom/moderntemplate/admin/setup.php</code> und klicken Sie auf '''Installieren/Reparieren''', falls angeboten

# Tipp: Ein „ModernTemplate“-Menü wird oben hinzugefügt und öffnet die Shell unter <code>/custom/moderntemplate/shell.php</code>

=== '''Konfiguration''' ===

==== '''Tab Werkzeuge''' ====

* '''Startseite''' (<code>MODERNTEMPLATE_START_PAGE</code>): Standard-URL, die beim Öffnen geladen wird (z. B. <code>/custom/moderntemplate/home.php?fs=1</code>)

* '''Weiterleitung nach Login''' (<code>MODERNTEMPLATE_AUTO_REDIRECT</code>, <code>MODERNTEMPLATE_REDIRECT_SCOPE</code>): immer oder nur, wenn keine <code>urlfrom</code> vorhanden ist

* '''Automatischer Vollbildmodus''' (<code>MODERNTEMPLATE_AUTO_FULLSCREEN</code>) und Berechtigungsmaske (<code>MODERNTEMPLATE_HIDE_FS_OVERLAY</code>)

* '''Hilfe- und Bugreport-URLs''' (<code>MODERNTEMPLATE_HELP_URL</code>, <code>MODERNTEMPLATE_BUGREPORT_URL</code>)

* '''Externe Kacheln''' (<code>MODERNTEMPLATE_INCLUDE_EXT_TILES</code>): externe Links außerhalb von Dolibarr einbinden

==== '''Tab Farben''' ====

* '''Banner''': <code>MODERNTEMPLATE_COLOR_BANNER_BG</code>, <code>…FG</code>

* '''Primäre/akzentuierte UI''': <code>MODERNTEMPLATE_COLOR_UI_PRIMARY</code>, <code>…ACCENT</code>

* '''Kacheln''': <code>MODERNTEMPLATE_COLOR_TILE_BG</code>, <code>…TEXT</code>

==== '''Tab Kacheln''' ====

* Kacheln per Drag & Drop neu anordnen, Abschnitte/Links hinzufügen, automatische Vorschläge aus Menüs

* SQL-Backup/Wiederherstellung (<code>tiles-backup.sql</code>), Import/Export

* Benutzerdefinierter Modus (<code>MODERNTEMPLATE_TILES_PERUSER</code>), Kachel- und Abschnitts-ACLs

==== '''Tab ACL''' ====

* Benutzerbasiertes Matrix-Layout: Sichtbarkeit von Kacheln und Abschnitten mit Speicherung in der Datenbank

==== '''Tab Sprachen''' ====

* i18n-Schlüssel aus Menüs automatisch gescannt; manuelles Hinzufügen/Bearbeiten

* Sprachzwang-Option (<code>MODERNTEMPLATE_FORCE_LANG</code>)

==== '''Tab Zugriff''' ====

* Zugriffssteuerung auf Konfigurations-Tabs nach Profil (Admins vs. normale Nutzer)

=== '''Verwendung''' ===

* Klicken Sie auf das Menü '''ModernTemplate''', um die Shell zu öffnen

* Öffnen Sie eine Kachel: der Inhalt wird zentriert angezeigt; die Schaltfläche '''Untermenüs''' öffnet das kontextabhängige linke Panel

* Ziehen Sie Kacheln, um die Reihenfolge zu ändern (wird gespeichert)

* Nutzen Sie die Suche (Lupensymbol): geben Sie eine exakte Referenz ein (<code>fac-xxx</code>, <code>cmd-xxx</code>, <code>prop-xxx</code>, <code>prod-xxx</code>, …) oder den Namen/die Nummer eines Drittanbieters/Kontakts

* '''Hilfe-Schaltfläche''': öffnet die definierte Hilfe-URL

* '''Shell verlassen''': <code>/custom/moderntemplate/shell/exit.php</code> (stellt native Dolibarr-Menüs wieder her)

=== '''Administration & Wartung''' ===

* '''Tabellen''': <code>llx_moderntemplate_pref</code>, <code>llx_moderntemplate_tiles</code> (automatische Migration von <code>modernui_*</code>)

* '''Endpoints''':

** <code>router/tiles_order.php</code> (Kachelreihenfolge)

** <code>router/left_order.php</code>

** <code>router/search.php</code>

* '''Wichtige Dateien''':

** <code>shell.php</code>, <code>shell/layout.php</code>, <code>js/shell.js</code>

** <code>core/triggers/interface_99_moderntemplate_redirect.class.php</code>

** <code>core/modules/modModernTemplate.class.php</code>

* '''Backup''': im Tab '''Kacheln''' → SQL exportieren; Wiederherstellung aus <code>.sql</code>-Datei

=== '''Sicherheit & Berechtigungen''' ===

* '''Hauptrecht''': ModernTemplate verwenden (<code>rights_class = moderntemplate</code>, Recht: <code>use</code>)

* Berücksichtigt Dolibarr-Berechtigungen für Kachel-Sichtbarkeit und Linkzugriff

* CSRF-Schutz auf allen Schreibrouten

=== '''Deinstallation''' ===

# Modul in '''Setup → Module/Anwendungen''' deaktivieren

# (Optional) Im Tab '''Deinstallation''' die ModernTemplate-Daten/Konstanten löschen

# Ordner <code>/custom/moderntemplate</code> löschen  ⚠️ Hinweis: Wenn eine Login-Weiterleitung aktiviert war, vorher deaktivieren!

=== '''FAQ''' ===

Kacheln/Links basieren auf aktiven Modulmenüs und URLs. Für benutzerdefinierte URLs können manuell Kacheln hinzugefügt werden.