Module Modern Template IT

ModernTemplate — Interfaccia modernizzata per Dolibarr

Versione: 1.9.2 · Licenza: GPL v3 · Autore: KSI 30

Panoramica

ModernTemplate fornisce una shell a schermo intero per Dolibarr: barra degli strumenti compatta, colonna di riquadri (tiles) riordinabili, pannello laterale con sottomenu e ricerca intelligente.

Il modulo si integra tramite hook (menuTop, menuLeft, toprightmenu, login, global) e un trigger (USER_LOGIN) per reindirizzare automaticamente dopo il login, se desiderato.

Punti di forza

Navigazione centralizzata con riquadri + sottomenu sincronizzati
Drag & Drop dei riquadri, con salvataggio globale o per utente
Ricerca multi-oggetto (riferimenti esatti + terze parti/contatti + fallback sulla ricerca globale)
Personalizzazione rapida: colori, pagina di avvio, URL di aiuto, visibilità delle schede
Pagine ModernTemplate integrate

Traduzioni disponibili

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

Prerequisiti

Dolibarr 22.x (raccomandato)
PHP 7.4+
Permessi di scrittura su database e cartella /custom/moderntemplate

Installazione

Copia la cartella moderntemplate/ in htdocs/custom/
In Dolibarr: vai su Configurazione → Moduli/Applicazioni e attiva ModernTemplate
Accedi a /custom/moderntemplate/admin/setup.php e clicca su Installa/Ripara se richiesto
Suggerimento: un menu “ModernTemplate” verrà aggiunto in alto e aprirà la shell in /custom/moderntemplate/shell.php

Configurazione

Scheda Strumenti

Pagina iniziale (MODERNTEMPLATE_START_PAGE): URL predefinito da aprire (es. /custom/moderntemplate/home.php?fs=1)
Reindirizzamento post-login (MODERNTEMPLATE_AUTO_REDIRECT, MODERNTEMPLATE_REDIRECT_SCOPE): sempre o solo se non è presente urlfrom
Schermo intero automatico (MODERNTEMPLATE_AUTO_FULLSCREEN) e maschera di autorizzazione (MODERNTEMPLATE_HIDE_FS_OVERLAY)
URL di aiuto e bugreport (MODERNTEMPLATE_HELP_URL, MODERNTEMPLATE_BUGREPORT_URL)
Riquadri esterni (MODERNTEMPLATE_INCLUDE_EXT_TILES): includi link esterni a Dolibarr

Scheda Colori

Banner: MODERNTEMPLATE_COLOR_BANNER_BG, …FG
UI primaria/accento: MODERNTEMPLATE_COLOR_UI_PRIMARY, …ACCENT
Riquadri: MODERNTEMPLATE_COLOR_TILE_BG, …TEXT

Scheda Riquadri

Riordino tramite drag & drop, aggiunta di sezioni/link, suggerimenti automatici dai menu
Backup/Ripristino SQL (tiles-backup.sql), import/export
Modalità per utente (MODERNTEMPLATE_TILES_PERUSER), ACL per riquadri e sezioni

Scheda ACL

Tabella incrociata per utente: visibilità di riquadri e sezioni, con salvataggio su database

Scheda Lingue

Chiavi i18n scansionate dai menu; aggiunta e modifica manuale
Opzione forzatura lingua (MODERNTEMPLATE_FORCE_LANG)

Scheda Accesso

Autorizzazioni per accedere alle schede di configurazione in base al profilo (admin vs utenti)

Utilizzo

Clicca sul menu ModernTemplate per aprire la shell
Apri un riquadro: il contenuto appare al centro; il pulsante Sottomenu mostra il pannello sinistro contestuale
Trascina i riquadri per riordinarli (i cambiamenti sono salvati)
Usa la ricerca (icona lente): digita un riferimento esatto (fac-xxx, cmd-xxx, prop-xxx, prod-xxx, ecc.) o il nome/numero di una terza parte/contatto
Il pulsante Aiuto apre l’URL di aiuto configurato
Il pulsante Esci dalla shell (/custom/moderntemplate/shell/exit.php) ripristina i menu nativi

Amministrazione e manutenzione

Tabelle: llx_moderntemplate_pref, llx_moderntemplate_tiles (migrazione automatica da modernui_*)
Endpoint:
- router/tiles_order.php (ordine riquadri)
- router/left_order.php
- router/search.php
File chiave:
- shell.php, shell/layout.php, js/shell.js
- core/triggers/interface_99_moderntemplate_redirect.class.php
- core/modules/modModernTemplate.class.php
Backup: dalla scheda Riquadri → esporta SQL; ripristina da file .sql

Sicurezza e permessi

Permesso principale: Utilizzare ModernTemplate (rights_class = moderntemplate, permesso use)
Rispetto dei permessi Dolibarr per visibilità riquadri e accesso link
Protezione CSRF su tutte le rotte di scrittura

Disinstallazione

Disattiva il modulo in Configurazione → Moduli/Applicazioni
(Opzionale) Usa la scheda Disinstallazione per cancellare i dati/costanti di ModernTemplate
Elimina la cartella /custom/moderntemplate ⚠️ Attenzione: se è attivo il reindirizzamento post-login, disattivalo prima di rimuovere il modulo

FAQ

Dopo il login vengo reindirizzato alla shell — è normale?

Sì, se MODERNTEMPLATE_AUTO_REDIRECT è attivo. Puoi disattivarlo nella scheda Strumenti o modificare MODERNTEMPLATE_REDIRECT_SCOPE.

I sottomenu di Dolibarr sono scomparsi

Nella shell i menu nativi sono nascosti per design. Usa il pannello a sinistra o clicca su Esci dalla shell per tornare alla navigazione standard.

I moduli di terze parti sono compatibili?

I riquadri/link si basano sui menu e URL dei moduli attivi. Per URL personalizzati, aggiungi riquadri manuali.

[1]