Documentacion KSIDol > Modulos KSIDol > Tema Moderno (ModernTemplate)

Guia del modulo: Tema Moderno (ModernTemplate)

Guía de uso no técnica: para qué sirve el módulo, cómo utilizarlo y cómo se articula con Dolibarr.

Compatibilidad Dolibarr18 a 24

Idiomas incluidos14

Pestañas de configuración8

Vista clásicaReversible en cualquier momento

1. Descripcion del modulo

El Tema Moderno viste Dolibarr con una interfaz a pantalla completa pensada para el uso táctil y el móvil. Sustituye la navegación habitual por un « shell »: Dolibarr se muestra dentro de la página, los menús nativos dejan paso a una barra de herramientas única, a un panel derecho « Menú principal » compuesto de mosaicos de colores y a un panel izquierdo de submenús contextuales. El módulo se apoya exclusivamente en los mecanismos de extensión de Dolibarr (hooks): no se modifica ningún archivo del núcleo, y se puede volver a la interfaz clásica en cualquier momento.

Una interfaz a pantalla completa con mosaicos que sustituye la navegación de Dolibarr sin tocar el núcleo del programa.
Una barra de herramientas única agrupa lo esencial: ayuda, navegación (anterior, siguiente), inicio, búsqueda, impresión, pantalla completa, asistencia, configuración, vista clásica y desconexión.
El panel derecho « Menú principal » presenta los dominios de gestión en forma de mosaicos de colores; el panel izquierdo muestra los submenús contextuales de la página abierta.
Cada pantalla de Dolibarr sigue siendo accesible y funciona de forma idéntica: solo cambian el aspecto y la navegación.
La vuelta al Dolibarr clásico es posible en cualquier momento gracias a un icono dedicado.

2. Instalación y activación

El módulo se instala como cualquier módulo Dolibarr, con algunos controles automáticos que garantizan un arranque sin sorpresas.

Instalar el módulo en el directorio htdocs/custom/moderntemplate: esta ubicación es obligatoria y la activación se rechaza en otro lugar.
La activación verifica la versión de PHP (8.1 como mínimo) y la versión de Dolibarr (ramas 18 a 24).
Dos tablas de preferencias y de mosaicos se crean automáticamente, tanto en MySQL/MariaDB como en PostgreSQL.
Se añade una entrada « Tema Moderno » al menú superior de Dolibarr.
Se establecen valores por defecto listos para usar: pantalla completa, redirección tras la conexión y ventana modal de presentación.
La desactivación del módulo no es destructiva: los mosaicos y los ajustes se conservan. La purga completa de los datos es una acción explícita distinta (pestaña Desinstalación).

3. Tras la conexión

Una vez activado el módulo, el usuario llega directamente a la nueva interfaz y se le proponen las referencias esenciales.

La conexión lleva directamente al shell a pantalla completa del Tema Moderno.
Una ventana modal de bienvenida presenta los atajos clave: menú principal en mosaicos, submenús, búsqueda rápida y configuración.
Esta presentación puede desactivarse con un clic (« No volver a mostrar esta presentación después de la conexión »).
El paso a pantalla completa del navegador se propone si este lo permite.

4. El menú principal en mosaicos

El panel derecho muestra una cuadrícula de mosaicos de colores, uno por dominio de gestión: terceros, productos, facturas, banco, contabilidad, proyectos, agenda, GED, tickets y muchos más.

Un mosaico solo aparece si el módulo Dolibarr correspondiente está activo y los permisos nativos del usuario lo autorizan.
Los mosaicos se reorganizan con un simple arrastrar y soltar; el orden se memoriza.
Cada mosaico abre la pantalla Dolibarr correspondiente dentro del shell.
Una opción permite incluir los módulos externos (directorio custom) en los mosaicos del menú principal.
El panel izquierdo « Submenús » despliega las entradas contextuales del mosaico o de la página abierta.

5. La búsqueda rápida

La lupa de la barra de herramientas lanza una búsqueda transversal que cubre los principales objetos de gestión.

La búsqueda consulta primero las referencias exactas: si un solo resultado corresponde, la ficha se abre directamente.
Continúa después por nombre o por contacto: nombre, correo electrónico o teléfono.
Perímetro cubierto: facturas de clientes y de proveedores, presupuestos, pedidos de clientes y de proveedores, proyectos, productos, tickets, terceros, contactos y agenda.
Los resultados se filtran siempre por los permisos del usuario conectado: cada uno solo ve lo que sus permisos autorizan.

6. La configuración (8 pestañas, reservada a los administradores)

El icono de herramientas de la barra abre la página de configuración del módulo, organizada en ocho pestañas.

Colores: el editor de colores nativo de Dolibarr está integrado en la pestaña, completado por el fondo y el texto de la barra superior; un campo dejado vacío hereda del tema Dolibarr.
Mosaicos: añadir, renombrar y ordenar los mosaicos, sus submenús y sus enlaces; copia de seguridad SQL descargable y restaurable; reinstalación del menú base incluido con el módulo.
Derechos ACL: matriz mosaicos × usuarios; todo está autorizado por defecto, y desmarcar una casilla retira el acceso al elemento correspondiente.
Idiomas (« Idiomas y preferencias »): el editor de traducciones nativo está integrado y las etiquetas de los mosaicos son modificables.
Herramientas: título de la pestaña del navegador, redirecciones tras la conexión ajustables usuario por usuario, reparación de las tablas y diagnóstico.
Derechos nativos: el gestor de usuarios nativo de Dolibarr está integrado para ajustar los permisos sin salir de la página.
Desinstalación: eliminación completa de los datos del módulo con informe detallado; esta acción es irreversible.
Accesos: elección de las pestañas de configuración visibles.

7. Seguridad y robustez

El módulo está concebido para que ninguna manipulación de la interfaz pueda provocar una acción involuntaria, y para repararse fácilmente.

Ninguna acción destructiva puede desencadenarse con un simple enlace de mosaico: los parámetros sensibles se neutralizan al pasar.
El ciclo de sesión nativo de Dolibarr se respeta: al expirar la sesión, la pantalla de conexión retoma el control con normalidad.
Una herramienta « Reparar las tablas » verifica y pone en orden las tablas del módulo.
Una página de emergencia, reservada a los administradores, restaura la página de inicio nativa de Dolibarr en caso de necesidad.

8. Vuelta a la vista clásica

El Tema Moderno nunca sustituye Dolibarr definitivamente: la interfaz de origen sigue siendo accesible.

Un icono dedicado de la barra de herramientas devuelve al Dolibarr nativo, con sus menús habituales.
El administrador puede ocultar este icono a los usuarios para mantenerlos en la interfaz moderna.
Los administradores conservan en todos los casos el acceso a la vista clásica.

9. Preguntas frecuentes

Las respuestas a las preguntas más habituales sobre el funcionamiento del módulo.

¿El módulo modifica el núcleo de Dolibarr? No: se apoya únicamente en los hooks, no se toca ningún archivo del núcleo.
¿Se puede volver atrás? Sí, en cualquier momento, gracias al icono Vista clásica o desactivando el módulo.
¿La desactivación hace perder los ajustes? No: los mosaicos y las preferencias se conservan; solo la desinstalación explícita los elimina.
¿Todos los usuarios ven los mismos mosaicos? No: la visualización depende de los módulos activos, de los permisos nativos de cada uno y de los derechos ACL definidos en la configuración.
¿Los módulos externos aparecen en los mosaicos? Sí, si la opción correspondiente está activada.

10. Requisitos previos

Las condiciones que reunir antes de la instalación.

Dolibarr versión 18 a 24 (la activación se rechaza más allá).
PHP 8.1 como mínimo.
Base de datos MySQL/MariaDB o PostgreSQL.
JavaScript activado en el navegador.
Instalación en el directorio htdocs/custom/moderntemplate.

11. Vinculos con Dolibarr

El modulo no funciona de forma aislada: se integra con los bloques nativos de Dolibarr.

Menús nativos : Los mosaicos y los submenús se construyen a partir de los menús de Dolibarr: las entradas de los módulos activos se encuentran en la interfaz moderna, y el módulo añade su propia entrada « Tema Moderno » al menú superior.
Tema y colores : El módulo se apoya en el tema de Dolibarr: los colores no personalizados heredan del tema vigente, y el editor de colores nativo está integrado directamente en la pestaña Colores de la configuración.
Traducciones : Las etiquetas utilizan el mecanismo de traducción de Dolibarr; el editor de traducciones nativo está integrado en la configuración para adaptar las etiquetas de los mosaicos y de los menús en cada idioma.
Usuarios y permisos : La visualización de los mosaicos respeta los permisos nativos de cada usuario, completados por la matriz ACL del módulo; el gestor de usuarios nativo es accesible desde la pestaña Derechos nativos.
Preferencias por usuario : La redirección tras la conexión se ajusta usuario por usuario apoyándose en las preferencias individuales de Dolibarr.
Multiempresa : Los ajustes, los mosaicos y las preferencias del módulo se registran por entidad: cada empresa de una instalación multiempresa dispone de su propia configuración.