Mainter Dark Admin
Un plugin ligero y modular que transforma la interfaz de administración de WordPress en un elegante entorno oscuro.
by Framber Silva · github.com/frambersilva/wordpress-dark-mode
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/frambersilva/wordpress-dark-mode/archive/refs/heads/main.zip🌙 Mainter Dark Admin - Modo Oscuro para WordPress
Un plugin ligero y modular que transforma la interfaz de administración de WordPress en un elegante entorno oscuro. Diseñado con una arquitectura inteligente que protege los colores originales de tus medios visuales.
📖 Descripción del Proyecto
Mainter Dark Admin no es un simple inyector de CSS. Utiliza un sistema de "Filtro Mágico" (invert y hue-rotate) cuidadosamente calibrado para oscurecer la interfaz de WordPress sin romper el layout (position fixed) y, lo más importante, sin invertir los colores de las fotografías, videos o selectores de color.
Está diseñado para ofrecer un descanso visual a los administradores y creadores de contenido que pasan horas en el backend de WordPress.
✨ Características Principales
- 🎛️ Interruptor Maestro Rápido: Activa o desactiva el modo oscuro al instante desde la barra de administración superior (Admin Bar) sin tener que ir a los ajustes.
- 🧩 Control por Zonas: Permite elegir qué partes de WordPress se oscurecen de forma independiente:
- Escritorio General (Dashboard, Plugins, Temas).
- Editor de Bloques (Gutenberg).
- Personalizador en Vivo (Customizer).
- 🛡️ Protección Visual Inteligente: Los elementos visuales (
img,video,iframe,.wp-color-picker) están protegidos mediante doble inversión para mantener sus colores 100% reales. - ⚡ Rendimiento Óptimo: Inyección de estilos pura y directa. No utiliza librerías externas pesadas ni scripts complejos que ralenticen la carga del panel.
- 🏗️ Arquitectura Modular: Código estrictamente dividido por funcionalidades para facilitar su escalabilidad.
📂 Arquitectura del Plugin
El código está estructurado bajo principios de desarrollo modular, separando la lógica de configuración de la inyección de diseño:
mainter-dark-admin/
├── mainter-dark-admin.php # Archivo raíz y cargador de clases
└── includes/
├── class-settings.php # Registro de opciones y UI del panel de ajustes
├── class-core-css.php # Motor de renderizado del CSS y "Filtros Mágicos"
└── class-admin-bar.php # Lógica del botón de la barra superior de WP
🚀 Instalación
- Descarga el código fuente de este repositorio en formato .zip.
- Dirígete a tu panel de WordPress: Plugins > Añadir nuevo > Subir plugin.
- Selecciona el archivo .zip y haz clic en Instalar ahora.
- Activa el plugin Mainter Dark Admin.
⚙️ Uso y Configuración
Una vez activado, tienes dos formas de interactuar con el plugin:
La Vía Rápida: En la barra negra superior de WordPress, verás un nuevo botón con el icono de un ojo que dice "Oscuro: OFF" o "Oscuro: ON". Haz clic para cambiar el estado general de la web al instante.
La Configuración Detallada: Ve a Ajustes > Modo Oscuro en el menú lateral izquierdo. Aquí encontrarás un panel con interruptores estilo "iOS" donde podrás decidir exactamente qué zonas (Dashboard, Gutenberg, Customizer) quieres que adopten el tono oscuro.
👨💻 Créditos y Autoría
Diseñado y desarrollado por Framber Silva. 🌐 Web: frambersilva.com