White-Label / Branding

NoxPanel soporta personalización completa de marca (white-label) por tenant, permitiendo que cada organización tenga su propio branding en el panel.

Funcionalidades

  • Nombre de marca personalizado (reemplaza «NoxPanel» en todo el UI)

  • Logo y favicon personalizados via URL

  • Colores del tema: primario, secundario, sidebar fondo, sidebar texto

  • CSS personalizado inyectado globalmente

  • Footer con texto y URL personalizados

  • Configuración de email remitente (nombre y dirección)

  • Dominio de panel personalizado

  • Toggle de activación/desactivación

Cómo Funciona

  1. El modelo WhiteLabelConfig almacena la configuración por tenant (relación OneToOne con HostingTenant).

  2. El context processor hosting.context_processors.whitelabel_context carga la configuración activa del tenant del usuario en cada petición.

  3. base.html inyecta los estilos CSS personalizados cuando whitelabel.is_active es True:

    • Variables CSS (--brand-400 a --brand-700)

    • Color de fondo y texto del sidebar

    • CSS personalizado (campo custom_css)

    • Logo, favicon, nombre de marca, footer

  4. La página de configuración (/hosting/whitelabel/) incluye una vista previa en vivo que se actualiza al cambiar los colores.

Campos del Modelo

Campo

Tipo

Descripción

brand_name

CharField

Nombre de la marca (default: «NoxPanel»)

logo_url

URLField

URL del logo de la marca

favicon_url

URLField

URL del favicon

primary_color

CharField

Color principal en hex (default: #4F46E5)

secondary_color

CharField

Color secundario en hex (default: #10B981)

sidebar_bg_color

CharField

Color de fondo del sidebar (default: #1e1e2e)

sidebar_text_color

CharField

Color de texto del sidebar (default: #cdd6f4)

custom_css

TextField

CSS personalizado inyectado globalmente

footer_text

CharField

Texto del footer

footer_url

URLField

URL del footer (enlace)

email_from_name

CharField

Nombre del remitente de emails

email_from_address

EmailField

Dirección de email del remitente

custom_panel_domain

CharField

Dominio personalizado del panel

is_active

BooleanField

Activa/desactiva el branding personalizado

Acceso

La configuración de white-label está disponible para superusuarios en:

Sidebar → Administración → White-Label

URL: /hosting/whitelabel/