Readme
facturaScriptsThemeCustomizer Plugin para FacturaScripts que permite personalizar los colores principales del tema visual desde la pantalla de configuracion.
Autor MDAM Plus - Martin Arnedo
Web: martinarnedo.com
Repositorio: github.com/mdamplus/facturaScriptsThemeCustomizer
Descripcion ThemeCustomizer agrega una seccion llamada Estilos dentro del panel de configuracion de FacturaScripts. Desde esa pantalla se pueden modificar colores del header, menu lateral, submenus, enlaces, botones, fondos, titulos, textos informativos y pantalla de login sin editar plantillas manualmente.
El plugin inyecta CSS en la plantilla principal de FacturaScripts usando una extension de vista, por lo que mantiene los cambios separados del nucleo de la aplicacion.
Funcionalidades Cambio del color de fondo del menu principal. Cambio del color del texto del menu principal. Cambio del color hover del texto del menu principal. Bloque especifico para el menu lateral. Cambio del color de fondo del menu lateral. Cambio del color del texto del menu lateral. Cambio del color hover del menu lateral. Cambio del fondo activo del menu lateral. Cambio del color de fondo del submenu/dropdown. Cambio del color del texto del submenu/dropdown. Cambio del color hover del texto del submenu/dropdown. Cambio del color de enlaces generales. Cambio del color hover de enlaces generales. Cambio del color de titulos. Cambio del color de textos informativos, incluyendo .text-info y legend.text-info. Cambio del fondo general de la pagina. Cambio del fondo de tarjetas, modales y elementos de lista. Cambio de colores del boton principal. Cambio del color de foco de campos de formulario. Aplicacion de los mismos estilos al menu lateral basado en nav-pills. Configuracion de colores y opacidades del login. Configuracion de imagen de fondo, logo, favicon y pie del login. Plantilla de login Daruba con fondo oscuro, imagen corporativa, logo dorado e inputs con borde dorado. Botones visibles en la pantalla de plugins hacia GitHub y la web de MDAM Plus. Instalacion Copiar la carpeta ThemeCustomizer dentro de la carpeta Plugins de FacturaScripts. Entrar en FacturaScripts como administrador. Ir a Administrador > Plugins. Activar el plugin ThemeCustomizer. Reconstruir la cache si FacturaScripts lo solicita. Configuracion La configuracion esta disponible en:
EditSettings?activetab=SettingsThemeCustomizer En desarrollo local con Docker, normalmente:
http://127.0.0.1:8081/EditSettings?activetab=SettingsThemeCustomizer En desarrollo con el servidor PHP simple, normalmente:
http://127.0.0.1:8080/EditSettings?activetab=SettingsThemeCustomizer Zonas configurables La pantalla Estilos esta dividida en bloques para que el usuario pueda identificar facilmente que zona esta modificando:
Header: color de fondo del menu superior, texto y hover. Menu lateral: color de fondo, texto, hover y estado activo del menu lateral. Submenus: color de fondo, texto y hover de los dropdown. Encabezados y contenido: enlaces, titulos, textos informativos, fondo general, tarjetas, botones y foco de formularios. Login - Color: color principal, opacidad principal, color secundario y opacidad secundaria. Login - Imagen y favicon: logo del login, imagen de fondo y favicon. Login - Pie de pagina: contenido mostrado en el pie del login.
Login
El bloque de login sincroniza sus valores con el plugin LoginScreen, que es el encargado de renderizar la pantalla de acceso.
El plugin tambien incluye una plantilla propia para View/Login/Login.html.twig. Al reconstruir plugins, FacturaScripts puede desplegar esta vista sobre la plantilla base para mostrar directamente el login.
Colores por defecto Menu principal: #d5a52a Texto del menu: #ffffff Hover del menu: #343a40 Menu lateral: #d5a52a Texto del menu lateral: #ffffff Hover del menu lateral: #343a40 Activo del menu lateral: #d5a52a Submenu: #d5a52a Texto del submenu: #ffffff Hover del submenu: #343a40 Enlaces: #d5a52a Hover de enlaces: #ffe293 Titulos: #343a40 Textos informativos: #343a40 Fondo general: #f8f9fa Fondo de tarjetas: #ffffff Boton principal: #d5a52a Texto del boton principal: #ffffff Foco de campos: #d5a52a
Compatibilidad FacturaScripts 2025 o superior. PHP 8 o superior.
Estructura
ThemeCustomizer/ ├── Assets/ │ └── Images/ │ └── favicon.ico ├── Extension/ │ ├── Controller/ │ │ └── EditSettings.php │ └── View/ │ ├── MenuTemplate_BodyEnd.html.twig │ └── MenuTemplate_CssAfter.html.twig ├── Translation/ │ ├── en_EN.json │ └── es_ES.json ├── XMLView/ │ └── SettingsThemeCustomizer.xml ├── View/ │ └── Login/ │ └── Login.html.twig ├── Init.php ├── README.md └── facturascripts.ini
