Module Modern Template DE

ModernTemplate — Modernisierte Benutzeroberfläche für Dolibarr

Version: 1.9.2 · Lizenz: GPL v3 · Autor: KSI 30

Übersicht

ModernTemplate bietet eine Vollbild-Shell für Dolibarr: kompakte Symbolleiste, verschiebbare Kacheln, linke Seitenleiste mit synchronisierten Untermenüs und intelligente Suche.

Das Modul wird über Hooks (menuTop, menuLeft, toprightmenu, login, global) und einen Trigger (USER_LOGIN) integriert, um eine optionale Weiterleitung nach dem Login zu ermöglichen.

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

Verfügbar in:

ar_SA, de_DE, en_US, es_ES, fr_FR, it_IT, ja_JP, nl_NL, pl_PL, pt_BR, pt_PT, ru_RU, tr_TR, zh_CN

Voraussetzungen

Dolibarr 22.x (empfohlen)
PHP 7.4+
Schreibzugriff auf die Datenbank und den Ordner /custom/moderntemplate

Installation

Kopieren Sie den Ordner moderntemplate/ nach htdocs/custom/
In Dolibarr: Setup → Module/Anwendungen → aktivieren Sie ModernTemplate
Öffnen Sie /custom/moderntemplate/admin/setup.php und klicken Sie auf Installieren/Reparieren, falls angeboten
Tipp: Ein „ModernTemplate“-Menü wird oben hinzugefügt und öffnet die Shell unter /custom/moderntemplate/shell.php

Konfiguration

Tab Werkzeuge

Startseite (MODERNTEMPLATE_START_PAGE): Standard-URL, die beim Öffnen geladen wird (z. B. /custom/moderntemplate/home.php?fs=1)
Weiterleitung nach Login (MODERNTEMPLATE_AUTO_REDIRECT, MODERNTEMPLATE_REDIRECT_SCOPE): immer oder nur, wenn keine urlfrom vorhanden ist
Automatischer Vollbildmodus (MODERNTEMPLATE_AUTO_FULLSCREEN) und Berechtigungsmaske (MODERNTEMPLATE_HIDE_FS_OVERLAY)
Hilfe- und Bugreport-URLs (MODERNTEMPLATE_HELP_URL, MODERNTEMPLATE_BUGREPORT_URL)
Externe Kacheln (MODERNTEMPLATE_INCLUDE_EXT_TILES): externe Links außerhalb von Dolibarr einbinden

Tab Farben

Banner: MODERNTEMPLATE_COLOR_BANNER_BG, …FG
Primäre/akzentuierte UI: MODERNTEMPLATE_COLOR_UI_PRIMARY, …ACCENT
Kacheln: MODERNTEMPLATE_COLOR_TILE_BG, …TEXT

Tab Kacheln

Kacheln per Drag & Drop neu anordnen, Abschnitte/Links hinzufügen, automatische Vorschläge aus Menüs
SQL-Backup/Wiederherstellung (tiles-backup.sql), Import/Export
Benutzerdefinierter Modus (MODERNTEMPLATE_TILES_PERUSER), 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 (MODERNTEMPLATE_FORCE_LANG)

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 (fac-xxx, cmd-xxx, prop-xxx, prod-xxx, …) oder den Namen/die Nummer eines Drittanbieters/Kontakts
Hilfe-Schaltfläche: öffnet die definierte Hilfe-URL
Shell verlassen: /custom/moderntemplate/shell/exit.php (stellt native Dolibarr-Menüs wieder her)

Administration & Wartung

Tabellen: llx_moderntemplate_pref, llx_moderntemplate_tiles (automatische Migration von modernui_*)
Endpoints:
- router/tiles_order.php (Kachelreihenfolge)
- router/left_order.php
- router/search.php
Wichtige Dateien:
- shell.php, shell/layout.php, js/shell.js
- core/triggers/interface_99_moderntemplate_redirect.class.php
- core/modules/modModernTemplate.class.php
Backup: im Tab Kacheln → SQL exportieren; Wiederherstellung aus .sql-Datei

Sicherheit & Berechtigungen

Hauptrecht: ModernTemplate verwenden (rights_class = moderntemplate, Recht: use)
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 /custom/moderntemplate löschen ⚠️ Hinweis: Wenn eine Login-Weiterleitung aktiviert war, vorher deaktivieren!

FAQ

Nach dem Login werde ich zur Shell weitergeleitet — ist das normal?

Ja, wenn MODERNTEMPLATE_AUTO_REDIRECT aktiviert ist. Sie können dies im Tab Werkzeuge deaktivieren oder den Wert von MODERNTEMPLATE_REDIRECT_SCOPE anpassen.

Ich sehe keine Dolibarr-Untermenüs mehr.

In der Shell sind native Menüs standardmäßig ausgeblendet. Verwenden Sie das linke Panel oder klicken Sie auf Shell verlassen, um zur Standardnavigation zurückzukehren.

Sind Drittanbieter-Module kompatibel?

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

[1]