Module Modern Template FR

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search

Retour index
Documentation développeur

File Doc dev.png

Retour index
Documentation Utilisateur
File Doc user.png

Informations

Module name Modern Template
Editor / Editeur KSI - https://www.ksi30.fr
Download or buy page / Page achat ou téléchargement External module - https://www.dolistore.com/product.php?id=2526&title=modern-template-v22&l=fr
Status / Statut / Estado
Prerequisites / Prérequis

Dolibarr min version: See on Dolistore    Dolibarr max version: See on Dolistore

Last update date / Date mise à jour fiche / Fecha última actualización 2025-10-31
Note / Nota


ModernTemplate — Interface modernisée pour Dolibarr

Version : 1.9.2 · Licence : GPL v3 · Auteur : KSI 30

Sommaire
  1. Aperçu
  2. Prérequis
  3. Installation
  4. Configuration
  5. Utilisation
  6. Administration & maintenance
  7. Sécurité & droits
  8. Désinstallation
  9. FAQ

Aperçu

ModernTemplate fournit un shell plein écran pour Dolibarr : barre d’outils compacte, colonne de tuiles réordonnables, panneau latéral de sous‑menus et recherche intelligente. Le module se greffe via hooks (menuTop, menuLeft, toprightmenu, login, global) et un trigger (USER_LOGIN) pour la redirection après connexion si souhaité.

DEMO/ https://dolibarr.ksi30.fr

Points forts

  • Navigation centralisée par tuiles + sous‑menus synchronisés.
  • Glisser‑déposer (D&D) des tuiles, sauvegarde globale ou par utilisateur.
  • Recherche multi‑objets (refs exactes + tiers/contacts + fallback recherche globale).
  • Personnalisation rapide : couleurs, page de démarrage, aide, visibilité des onglets.
  • ModernTemplate intégrées.

Traductions

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

Prérequis

  • Dolibarr 22.x (recommandé).
  • PHP 7.4+.
  • Accès écriture base/fichiers pour /custom/moderntemplate.

Installation

  1. Copiez le dossier moderntemplate/ dans htdocs/custom/.
  2. Dans Dolibarr : Configuration › Modules/Applications → activez ModernTemplate.
  3. Allez sur /custom/moderntemplate/admin/setup.php puis lancez Installer/Réparer si proposé.
Astuce : un menu « ModernTemplate » est ajouté en haut et ouvre le shell (/custom/moderntemplate/shell.php).

Configuration

Onglet Outils

  • Page de démarrage (MODERNTEMPLATE_START_PAGE) : URL ouverte par défaut (ex. /custom/moderntemplate/home.php?fs=1).
  • Redirection après login (MODERNTEMPLATE_AUTO_REDIRECT, MODERNTEMPLATE_REDIRECT_SCOPE) : toujours ou seulement si aucun urlfrom.
  • Plein écran auto (MODERNTEMPLATE_AUTO_FULLSCREEN) et masque d’autorisation (MODERNTEMPLATE_HIDE_FS_OVERLAY).
  • URL d’aide (MODERNTEMPLATE_HELP_URL) et bugreport (MODERNTEMPLATE_BUGREPORT_URL).
  • Tuiles externes (MODERNTEMPLATE_INCLUDE_EXT_TILES) : inclure des liens hors Dolibarr.

Onglet Couleurs

  • Bannière : MODERNTEMPLATE_COLOR_BANNER_BG / …FG
  • UI primaire/accent : MODERNTEMPLATE_COLOR_UI_PRIMARY, …ACCENT
  • Tuiles : MODERNTEMPLATE_COLOR_TILE_BG, …TEXT

Onglet Tuiles

  • Réordonner par D&D, ajouter sections/liens, suggestions auto depuis les menus.
  • Sauvegarde/Restore SQL (tiles-backup.sql) + import/export.
  • Mode par utilisateur (MODERNTEMPLATE_TILES_PERUSER), ACL tuiles/sections.

Onglet ACL

Tableau croisé par utilisateur : visibilité des tuiles et sections, avec sauvegarde dans la base.

Onglet Langues

Clés i18n scannées depuis les menus, ajout et édition. Option de forçage de langue (MODERNTEMPLATE_FORCE_LANG).

Onglet Accès

Autoriser/masquer l’accès aux onglets de configuration selon profil (admins vs utilisateurs).

Utilisation

  1. Cliquez sur le menu ModernTemplate pour ouvrir le shell.
  2. Ouvrez une tuile : le contenu s’affiche au centre ; le bouton « Sous‑menus » déroule le panneau gauche contextuel.
  3. Glissez‑déposez les tuiles pour les réordonner (persistant).
  4. Utilisez la recherche (icône loupe) : tapez une référence exacte (fac‑xxx, cmd‑xxx, prop‑xxx, prod‑xxx…) ou un nom/numéro de tiers/contact.
  5. Bouton « Aide » : ouvre l’URL d’aide définie.
  6. Bouton « Quitter le shell » : /custom/moderntemplate/shell/exit.php (restaure les menus natifs).

Administration & maintenance

  • Tables : llx_moderntemplate_pref, llx_moderntemplate_tiles (migration depuis modernui_* gérée automatiquement).
  • Endpoints : router/tiles_order.php (ordre tuiles), router/left_order.php, router/search.php.
  • Fichiers clés : shell.php, shell/layout.php, js/shell.js, core/triggers/interface_99_moderntemplate_redirect.class.php, core/modules/modModernTemplate.class.php.
  • Sauvegarde : onglet Tuiles → export SQL ; restauration depuis un fichier .sql.

Sécurité & droits

  • Droit principal : Utiliser ModernTemplate (rights_class = moderntemplate, permission use).
  • Respect des droits Dolibarr pour l’affichage des tuiles et l’accès aux liens.
  • Protection CSRF sur les routes d’écriture.

Désinstallation

  1. Désactivez le module dans Configuration › Modules/Applications.
  2. Optionnel : onglet Désinstallation pour purger constantes/données ModernTemplate.
  3. Supprimez le dossier /custom/moderntemplate.
Attention : si vous avez activé la redirection post‑login, pensez à la désactiver avant suppression.

FAQ

Après login, je suis redirigé vers le shell — normal ?
Oui si MODERNTEMPLATE_AUTO_REDIRECT est activé. Désactivez‑le dans l’onglet Outils ou modifiez MODERNTEMPLATE_REDIRECT_SCOPE.

Je perds mes sous‑menus Dolibarr
Dans le shell, les menus natifs sont masqués par conception ; utilisez le panneau gauche ou le bouton « Quitter le shell ».

Compatibilité modules tiers
Les liens/tuiles se basent sur les menus/URL des modules actifs. En cas d’URL personnalisées, ajoutez des tuiles manuelles.

[1]

Retrieved from "https://wiki.dolibarr.org/index.php?title=Module_Modern_Template_FR&oldid=64632"