Documentation KSIDol > Modules KSIDol > Thème Moderne (ModernTemplate)

Notice du module Thème Moderne (ModernTemplate)

Guide d'utilisation non technique : à quoi sert le module, comment l'utiliser et comment il s'articule avec Dolibarr.

Compatibilité Dolibarr18 à 24

Langues fournies14

Onglets de paramétrage8

Vue classiqueRéversible à tout moment

1. Presentation du module

Le Thème Moderne habille Dolibarr d'une interface plein écran pensée pour le tactile et le mobile. Il remplace la navigation habituelle par un « shell » : Dolibarr s'affiche à l'intérieur de la page, les menus natifs laissent place à une barre d'outils unique, à un panneau droit « Menu principal » composé de tuiles colorées et à un panneau gauche de sous-menus contextuels. Le module s'appuie exclusivement sur les mécanismes d'extension de Dolibarr (hooks) : aucun fichier du cœur n'est modifié, et l'on peut revenir à l'interface classique à tout moment.

Une interface plein écran à tuiles qui remplace la navigation de Dolibarr sans toucher au cœur du logiciel.
Une barre d'outils unique regroupe l'essentiel : aide, navigation (précédent, suivant), accueil, recherche, impression, plein écran, assistance, paramétrage, vue classique et déconnexion.
Le panneau droit « Menu principal » présente les domaines de gestion sous forme de tuiles colorées ; le panneau gauche affiche les sous-menus contextuels de la page ouverte.
Chaque écran de Dolibarr reste accessible et fonctionne à l'identique : seul l'habillage et la navigation changent.
Le retour au Dolibarr classique est possible à tout moment grâce à une icône dédiée.

2. Installation et activation

Le module s'installe comme tout module Dolibarr, avec quelques contrôles automatiques qui garantissent un démarrage sans surprise.

Installer le module dans le répertoire htdocs/custom/moderntemplate : cet emplacement est imposé et l'activation est refusée ailleurs.
L'activation vérifie la version de PHP (8.1 minimum) et la version de Dolibarr (branches 18 à 24).
Deux tables de préférences et de tuiles sont créées automatiquement, aussi bien sur MySQL/MariaDB que sur PostgreSQL.
Une entrée « Thème Moderne » est ajoutée au menu du haut de Dolibarr.
Des valeurs par défaut prêtes à l'emploi sont posées : plein écran, redirection après connexion et modale de présentation.
La désactivation du module n'est pas destructive : les tuiles et les réglages sont conservés. La purge complète des données est une action explicite distincte (onglet Désinstallation).

3. Après la connexion

Une fois le module activé, l'utilisateur arrive directement dans la nouvelle interface et se voit proposer les repères essentiels.

La connexion mène directement au shell plein écran du Thème Moderne.
Une modale de bienvenue présente les raccourcis clés : menu principal en tuiles, sous-menus, recherche rapide et paramétrage.
Cette présentation peut être désactivée d'un clic (« Ne plus afficher cette présentation après la connexion »).
Le passage en plein écran du navigateur est proposé si celui-ci le permet.

4. Le menu principal en tuiles

Le panneau droit affiche une grille de tuiles colorées, une par domaine de gestion : tiers, produits, factures, banque, comptabilité, projets, agenda, GED, tickets et bien d'autres.

Une tuile n'apparaît que si le module Dolibarr correspondant est actif et que les droits natifs de l'utilisateur le permettent.
Les tuiles se réorganisent par simple glisser-déposer ; l'ordre est mémorisé.
Chaque tuile ouvre l'écran Dolibarr correspondant à l'intérieur du shell.
Une option permet d'inclure les modules externes (répertoire custom) dans les tuiles du menu principal.
Le panneau gauche « Sous-menus » déroule les entrées contextuelles de la tuile ou de la page ouverte.

5. La recherche rapide

La loupe de la barre d'outils lance une recherche transverse qui couvre les principaux objets de gestion.

La recherche interroge d'abord les références exactes : si un seul résultat correspond, la fiche s'ouvre directement.
Elle poursuit ensuite par libellé ou par contact : nom, e-mail ou téléphone.
Périmètre couvert : factures clients et fournisseurs, devis, commandes clients et fournisseurs, projets, produits, tickets, tiers, contacts et agenda.
Les résultats sont toujours filtrés par les droits de l'utilisateur connecté : chacun ne voit que ce que ses permissions autorisent.

6. Le paramétrage (8 onglets, réservé aux administrateurs)

L'icône outils de la barre ouvre la page de paramétrage du module, organisée en huit onglets.

Couleurs : l'éditeur de couleurs natif de Dolibarr est intégré dans l'onglet, complété par le fond et le texte de la barre haute ; un champ laissé vide hérite du thème Dolibarr.
Tuiles : ajouter, renommer et ordonner les tuiles, leurs sous-menus et leurs liens ; sauvegarde SQL téléchargeable et restaurable ; réinstallation du menu de base livré avec le module.
Droits ACL : matrice tuiles × utilisateurs ; tout est autorisé par défaut, décocher une case retire l'accès à l'élément correspondant.
Langues (« Langues & Préférences ») : l'éditeur de traductions natif est intégré et les libellés des tuiles sont modifiables.
Outils : titre de l'onglet du navigateur, redirections après connexion réglables utilisateur par utilisateur, réparation des tables et diagnostic.
Droits natifs : le gestionnaire d'utilisateurs natif de Dolibarr est intégré pour ajuster les permissions sans quitter la page.
Désinstallation : suppression complète des données du module avec rapport détaillé ; cette action est irréversible.
Accès : choix des onglets de paramétrage visibles.

7. Sécurité et robustesse

Le module est conçu pour qu'aucune manipulation de l'interface ne puisse provoquer d'action involontaire, et pour se réparer facilement.

Aucune action destructrice ne peut être déclenchée par un simple lien de tuile : les paramètres sensibles sont neutralisés au passage.
Le cycle de session natif de Dolibarr est respecté : à l'expiration de la session, l'écran de connexion reprend la main normalement.
Un outil « Réparer les tables » vérifie et remet en état les tables du module.
Une page de secours, réservée aux administrateurs, restaure l'accueil natif de Dolibarr en cas de besoin.

8. Retour à la vue classique

Le Thème Moderne ne remplace jamais Dolibarr définitivement : l'interface d'origine reste accessible.

Une icône dédiée de la barre d'outils ramène au Dolibarr natif, avec ses menus habituels.
L'administrateur peut masquer cette icône aux utilisateurs pour les maintenir dans l'interface moderne.
Les administrateurs conservent dans tous les cas l'accès à la vue classique.

9. Questions fréquentes

Les réponses aux questions les plus courantes sur le fonctionnement du module.

Le module modifie-t-il le cœur de Dolibarr ? Non : il s'appuie uniquement sur les hooks, aucun fichier du cœur n'est touché.
Peut-on revenir en arrière ? Oui, à tout moment, grâce à l'icône Vue classique ou en désactivant le module.
La désactivation fait-elle perdre les réglages ? Non : les tuiles et les préférences sont conservées ; seule la désinstallation explicite les supprime.
Tous les utilisateurs voient-ils les mêmes tuiles ? Non : l'affichage dépend des modules actifs, des droits natifs de chacun et des droits ACL définis dans le paramétrage.
Les modules externes apparaissent-ils dans les tuiles ? Oui, si l'option correspondante est activée.

10. Prérequis

Les conditions à réunir avant l'installation.

Dolibarr version 18 à 24 (l'activation est refusée au-delà).
PHP 8.1 au minimum.
Base de données MySQL/MariaDB ou PostgreSQL.
JavaScript activé dans le navigateur.
Installation dans le répertoire htdocs/custom/moderntemplate.

11. Liaisons avec Dolibarr

Le module ne fonctionne pas en vase clos : il s'articule avec les briques natives de Dolibarr.

Menus natifs : Les tuiles et les sous-menus sont construits à partir des menus de Dolibarr : les entrées des modules actifs se retrouvent dans l'interface moderne, et le module ajoute sa propre entrée « Thème Moderne » au menu du haut.
Thème et couleurs : Le module s'appuie sur le thème de Dolibarr : les couleurs non personnalisées héritent du thème en place, et l'éditeur de couleurs natif est intégré directement dans l'onglet Couleurs du paramétrage.
Traductions : Les libellés utilisent le mécanisme de traduction de Dolibarr ; l'éditeur de traductions natif est intégré au paramétrage pour adapter les libellés des tuiles et des menus dans chaque langue.
Utilisateurs et droits : L'affichage des tuiles respecte les droits natifs de chaque utilisateur, complétés par la matrice ACL du module ; le gestionnaire d'utilisateurs natif est accessible depuis l'onglet Droits natifs.
Préférences par utilisateur : La redirection après connexion se règle utilisateur par utilisateur en s'appuyant sur les préférences individuelles de Dolibarr.
Multi-sociétés : Les réglages, les tuiles et les préférences du module sont enregistrés par entité : chaque société d'une installation multi-sociétés dispose de sa propre configuration.