Module Modern Template ES

ModernTemplate — Interfaz modernizada para Dolibarr

Versión: 1.9.2 · Licencia: GPL v3 · Autor: KSI 30

Resumen

ModernTemplate proporciona una shell a pantalla completa para Dolibarr: barra de herramientas compacta, columna de mosaicos (tiles) reordenables, panel lateral con submenús y búsqueda inteligente.

El módulo se integra mediante hooks (menuTop, menuLeft, toprightmenu, login, global) y un trigger (USER_LOGIN) para permitir una redirección opcional tras el inicio de sesión.

Puntos destacados

Navegación centralizada con mosaicos y submenús sincronizados
Arrastrar y soltar (drag & drop) para ordenar mosaicos, guardado global o por usuario
Búsqueda multiobjeto (referencias exactas + terceros/contactos + búsqueda global de respaldo)
Personalización rápida: colores, página de inicio, URL de ayuda, visibilidad de pestañas
Páginas internas ModernTemplate incluidas

Traducciones disponibles

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

Requisitos

Dolibarr 22.x (recomendado)
PHP 7.4+
Acceso de escritura a la base de datos y a la carpeta /custom/moderntemplate

Instalación

Copia la carpeta moderntemplate/ en htdocs/custom/
En Dolibarr: ve a Configuración → Módulos/Aplicaciones y activa ModernTemplate
Abre /custom/moderntemplate/admin/setup.php y haz clic en Instalar/Reparar si se te solicita
Consejo: se añadirá un menú “ModernTemplate” en la parte superior que abre la shell en /custom/moderntemplate/shell.php

Configuración

Pestaña Herramientas

Página de inicio (MODERNTEMPLATE_START_PAGE): URL predeterminada al abrir (por ejemplo, /custom/moderntemplate/home.php?fs=1)
Redirección tras login (MODERNTEMPLATE_AUTO_REDIRECT, MODERNTEMPLATE_REDIRECT_SCOPE): siempre o solo si no hay urlfrom
Pantalla completa automática (MODERNTEMPLATE_AUTO_FULLSCREEN) y máscara de permisos (MODERNTEMPLATE_HIDE_FS_OVERLAY)
URL de ayuda y reporte de errores (MODERNTEMPLATE_HELP_URL, MODERNTEMPLATE_BUGREPORT_URL)
Mosaicos externos (MODERNTEMPLATE_INCLUDE_EXT_TILES): incluir enlaces fuera de Dolibarr

Pestaña Colores

Banner: MODERNTEMPLATE_COLOR_BANNER_BG, …FG
UI principal/acento: MODERNTEMPLATE_COLOR_UI_PRIMARY, …ACCENT
Mosaicos: MODERNTEMPLATE_COLOR_TILE_BG, …TEXT

Pestaña Mosaicos

Reordenar con drag & drop, agregar secciones/enlaces, sugerencias automáticas desde los menús
Copia de seguridad y restauración SQL (tiles-backup.sql), importación/exportación
Modo por usuario (MODERNTEMPLATE_TILES_PERUSER), permisos (ACL) para mosaicos y secciones

Pestaña ACL

Matriz por usuario: visibilidad de mosaicos y secciones, con guardado en base de datos

Pestaña Idiomas

Claves i18n escaneadas desde los menús, con opción de añadir y editar
Opción de forzar idioma (MODERNTEMPLATE_FORCE_LANG)

Pestaña Acceso

Controlar el acceso a las pestañas de configuración según perfil (admins vs usuarios)

Uso

Haz clic en el menú ModernTemplate para abrir la shell
Abre un mosaico: el contenido aparece centrado; el botón Submenús despliega el panel lateral contextual
Arrastra los mosaicos para reorganizarlos (se guarda automáticamente)
Usa la búsqueda (icono de lupa): escribe una referencia exacta (fac-xxx, cmd-xxx, prop-xxx, prod-xxx, etc.) o el nombre/número de un tercero/contacto
El botón Ayuda abre la URL de ayuda configurada
El botón Salir de la shell (/custom/moderntemplate/shell/exit.php) restaura los menús nativos

Administración y mantenimiento

Tablas: llx_moderntemplate_pref, llx_moderntemplate_tiles (migración automática desde modernui_*)
Endpoints:
- router/tiles_order.php (orden de mosaicos)
- router/left_order.php
- router/search.php
Archivos clave:
- shell.php, shell/layout.php, js/shell.js
- core/triggers/interface_99_moderntemplate_redirect.class.php
- core/modules/modModernTemplate.class.php
Copia de seguridad: en la pestaña Mosaicos → exportación SQL; restauración desde archivo .sql

Seguridad y permisos

Permiso principal: Usar ModernTemplate (rights_class = moderntemplate, permiso use)
Respeta los derechos de Dolibarr para mostrar mosaicos y controlar el acceso a los enlaces
Protección CSRF en todas las rutas de escritura

Desinstalación

Desactiva el módulo en Configuración → Módulos/Aplicaciones
(Opcional) Usa la pestaña Desinstalación para eliminar constantes/datos de ModernTemplate
Elimina la carpeta /custom/moderntemplate ⚠️ Atención: si habilitaste la redirección tras login, asegúrate de desactivarla antes de eliminar el módulo

Preguntas frecuentes

Después de iniciar sesión, me redirige a la shell. ¿Es normal?

Sí, si MODERNTEMPLATE_AUTO_REDIRECT está activado. Puedes desactivarlo desde la pestaña Herramientas o modificar MODERNTEMPLATE_REDIRECT_SCOPE.

He perdido los submenús de Dolibarr

En la shell, los menús nativos están ocultos por diseño. Usa el panel izquierdo o haz clic en Salir de la shell para volver a la navegación clásica.

¿Es compatible con módulos de terceros?

Los enlaces y mosaicos se basan en los menús y URLs de los módulos activos. Para URLs personalizadas, puedes añadir mosaicos manualmente.

[1]