Personaliza ONLYOFFICE Docs con tu logotipo y colores de tema.

Para personalizar un editor de ONLYOFFICE Docs integrado, asígnele un tema de color de marca e incluya las URL de su logotipo en la configuración de inicialización. El tema es un archivo JSON que se instala en el servidor de Docs; el logotipo lo configura la aplicación que integra el editor. La opción de logotipo en el encabezado, documentada en la documentación, solo está disponible en ONLYOFFICE Docs Developer, así que confirme su edición antes de preparar los recursos.

Esto se aplica a la integración de Docs autoalojada, no a la marca DocSpace ni al selector de temas locales de los editores de escritorio. ONLYOFFICE documenta los temas personalizados de Docs v7.0. Estos ajustes afectan a la interfaz del editor integrado, no al contenido del documento ni a la navegación de su sitio web.

¿Qué debes preparar primero?

Reúna dos archivos para el logotipo: una versión que se vea claramente sobre un encabezado claro y una versión invertida para un encabezado oscuro o de color. La API de Docs especifica una imagen de 300 × 20 píxeles para el logotipo del encabezado del editor. Si su diseño lo permite, utilice un PNG transparente y mantenga un alto contraste con pocos detalles finos, ya que la imagen aparece en una franja estrecha. Aloje ambos archivos en direcciones HTTPS estables que el navegador del usuario del editor pueda cargar.

También necesitas permisos de escritura en el servidor, el código que configura el editor y un documento de prueba. Para Docker, identifica el nombre o ID del contenedor en ejecución. Prueba primero el cambio en un entorno que no sea de producción.

Dos logotipos horizontales etiquetados para encabezados claros y oscuros, cada uno mostrado a 300 por 20 píxeles.
Prepare un logotipo para encabezado claro y una versión para encabezado oscuro en el tamaño de 300 × 20 píxeles documentado para el encabezado del editor.

1. Crea un archivo JSON de tema para tus colores.

Un archivo JSON de tema es un archivo de configuración que asigna tokens de color de interfaz con nombre a valores de color. idDebe ser único y comenzar con theme-; es namelo que los usuarios ven en el selector de temas. Elija una base clara u oscura que coincida con la interfaz general que desea, luego reemplace los colores del encabezado y los acentos seleccionados. El ejemplo a continuación mantiene el fondo del editor claro, usa índigo para cada encabezado del editor y usa coral para el botón de acento del editor de documentos.

{
  "name": "Acme Brand Light",
  "id": "theme-acme-brand-light",
  "type": "light",
  "colors": {
    "toolbar-header-document": "#263B67",
    "toolbar-header-spreadsheet": "#263B67",
    "toolbar-header-presentation": "#263B67",
    "toolbar-header-pdf": "#263B67",
    "text-toolbar-header": "#fff",
    "background-accent-button": "#D8613C"
  }
}

Guárdalo como acme-brand-light.json. Los tokens de color del encabezado son independientes para documentos, hojas de cálculo, presentaciones y PDF; configura cada uno si deseas una marca coherente en todos los tipos de archivo. El token de acento que se muestra aquí afecta al botón de acento del editor de documentos de texto, no a todos los elementos de color en Docs. ONLYOFFICE documenta tokens de color adicionales para fondos, bordes, estados de desplazamiento, iconos, texto y el lienzo de edición, así que amplía la paleta solo cuando necesites esas áreas. Comprueba el contraste del texto y los iconos con los fondos elegidos antes de la publicación; un color de marca por sí solo no garantiza controles legibles.

Un editor de código que muestra un archivo JSON con el tema Brand Light, encabezados de editor en color índigo y un color de acento coral.
El archivo de tema asigna los tokens de color denominados ONLYOFFICE a los colores que desee en la interfaz.

Para consultar la lista completa de tokens compatibles y los campos JSON necesarios, utilice la referencia oficial de temas personalizados de ONLYOFFICE .

2. Instala el tema en el servidor de Docs.

Copia el archivo JSON en el directorio de temas del servidor. La documentación oficial de Linux y Docker indica esta ruta:

/var/www/onlyoffice/documentserver/web-apps/apps/common/main/resources/themes

Para una implementación de Docker, coloque el archivo en el directorio desde el que ejecutará el comando y luego reemplácelo CONTAINER_IDcon el nombre o ID del contenedor Docs en ejecución:

docker cp ./acme-brand-light.json CONTAINER_ID:/var/www/onlyoffice/documentserver/web-apps/apps/common/main/resources/themes/

En Linux, copie el archivo a esa ruta con una cuenta con permisos de escritura. En Windows, use el directorio de temas en %ProgramFiles%\ONLYOFFICE\DocumentServer; consulte la guía de instalación para conocer su ruta completa. Un tema personalizado es un archivo JSON añadido, no una modificación de los archivos de la aplicación.

Un comando de terminal que copia acme-brand-light.json al directorio de temas de ONLYOFFICE Docs dentro de un contenedor.
Copie el archivo JSON del tema en el directorio de temas del servidor; el identificador del contenedor debe coincidir con el servicio Docs en ejecución.

ONLYOFFICE indica que la caché de temas se actualiza cada cinco minutos. Actualice el editor después de copiar el archivo; si aún no aparece, siga las instrucciones de solución de problemas de caché de Docker o Linux y reinicie los servicios solo si es necesario. Para contenedores de producción, incluya el archivo en su imagen o automatización de implementación para que al reemplazar un contenedor no se elimine.

3. Aplica el tema y configura el logotipo del editor.

Una vez descubierto el tema, los usuarios pueden seleccionarlo en Ver > Tema de interfaz . Para que el editor integrado se inicie con ese tema, añada su ID al objeto de configuración que su aplicación pasa a la API de Docs. Configure el logotipo dentro del mismo editorConfig.customizationobjeto:

editorConfig: {
  customization: {
    uiTheme: "theme-acme-brand-light",
    logo: {
      image: "https://assets.example.com/logo-light.png",
      imageDark: "https://assets.example.com/logo-dark.png",
      imageLight: "https://assets.example.com/logo-light.png",
      url: "https://www.example.com"
    }
  }
}

Reemplace las URL de ejemplo con sus URL de destino y recursos públicos reales. logo.imagees la ruta estándar del logotipo para los modos de editor comunes; los campos oscuro y claro separados le permiten elegir la imagen para un encabezado oscuro o claro. La URL es a dónde debe dirigirse un clic en el logotipo. La API enumera esta configuración de logotipo de encabezado como una característica de Docs Developer y especifica el tamaño 300 × 20. No lo confunda con customer.logo, que es una imagen más grande utilizada en la información Acerca de del editor.

La pestaña Vista del editor de documentos con el tema de interfaz abierto y la opción Brand Light seleccionada.
En la pestaña Vista, el selector de tema de interfaz es donde se puede seleccionar el tema personalizado instalado.

Si su integración firma las configuraciones del editor con JWT, vuelva a generar la firma después de agregar o modificar estos campos firmados y mantenga el secreto de firma en el servidor. El ejemplo oficial de integración de ONLYOFFICE explica que el token debe coincidir con la configuración y regenerarse cuando cambien los parámetros firmados. Tenga en cuenta también que el tema seleccionado previamente por el usuario puede tener prioridad uiTheme; pruebe con un perfil de navegador nuevo o restablezca la preferencia de tema guardada del usuario si no se muestra el tema predeterminado solicitado.

Para conocer los tamaños de las propiedades del logotipo y la disponibilidad de ediciones, consulte la referencia oficial de configuración de marca estándar .

Verifica el resultado antes del lanzamiento.

Abra los tipos de archivo que sus usuarios necesitan. Confirme los colores del encabezado, el texto legible y los iconos, el logotipo correcto en los encabezados claros y oscuros, y el destino del clic del logotipo. Verifique los modos de edición y visualización en el diseño incrustado.

Si falta el tema, valide el JSON y el ID, revise el directorio de temas del servidor activo y espere a que se actualice la caché. Si falta el logotipo, verifique el requisito de la edición para desarrolladores, el acceso del navegador a la URL de la imagen y si la configuración de inicialización incluye logo. Regenere el JWT en el backend si modificó los campos firmados.

Dejar un comentario

Personaliza el tema y la imagen de marca de Element Web.

Define un nombre de marca, colores personalizados y elementos de inicio de sesión para tu implementación de Element Web, teniendo en cuenta qué partes conservarán la marca Element.

Aumenta el límite de archivos de Systemd de Synapse sin tener que adivinar.

Aumenta el límite de archivos de Systemd de Synapse sin tener que adivinar.

Diagnostique si Synapse alcanzó su límite de archivos abiertos por proceso, configure un archivo de configuración de systemd para el servicio o trabajador adecuado y verifique el límite en tiempo real.

¿El elemento muestra "Error al descifrar"? Recupere la llave de la habitación que falta.

¿El elemento muestra "Error al descifrar"? Recupere la llave de la habitación que falta.

Averigua si el error se limita a un navegador o a un evento específico y, a continuación, utiliza la clave de recuperación de Element o un dispositivo de confianza sin poner en riesgo el historial cifrado restante.

Limpia los mensajes y archivos multimedia antiguos de Synapse sin perder datos.

Utilice las API de historial y eliminación de medios de Synapse o la configuración de retención para eliminar datos obsoletos de forma segura y, a continuación, verifique que el proceso se haya completado y que se haya recuperado el espacio en disco.

Crea un bot de eco de matriz en Python con Simple-Matrix-Bot-Lib.

Crea un bot de eco de matriz en Python con Simple-Matrix-Bot-Lib.

Instala la biblioteca actual, conecta una cuenta Matrix dedicada y ejecuta un pequeño bot !echo con un manejo de credenciales más seguro y una prueba clara.

Conecta Matrix con WhatsApp, Telegram y Discord mediante puentes separados.

Conecta Matrix con WhatsApp, Telegram y Discord mediante puentes separados.

Configure tres puentes mautrix con registros, inicios de sesión y pruebas independientes, y evite sorpresas con la red, la política de cuentas y la sincronización de Docker.

Recupera espacio en disco de Synapse Media sin dañar los archivos compartidos.

Descubre qué está llenando el almacenamiento de Synapse, configura la retención segura de medios y purga la caché remota sin eliminar archivos directamente del disco.

Desactivar usuarios inactivos de Matrix sin borrar el historial de la sala.

Desactivar usuarios inactivos de Matrix sin borrar el historial de la sala.

Revise la actividad del dispositivo, desactive las cuentas de Synapse inactivas confirmadas a través de la API de administración y descubra qué elimina realmente la opción de borrado.

Reduzca la presión de memoria de PostgreSQL en Matrix Synapse.

Determine si la memoria de PostgreSQL proviene del trabajo de consultas, búferes compartidos, conexiones o mantenimiento, y luego realice los cambios necesarios de forma segura para Synapse.

¿Por qué las conexiones de sala de Matrix Synapse son lentas y qué revisar?

¿Por qué las conexiones de sala de Matrix Synapse son lentas y qué revisar?

Antes de cambiar la configuración de Synapse, analice si hay problemas con las conexiones lentas de salas Matrix a un servidor remoto, el retroceso de la federación, la carga de la base de datos local o una cola de envío saliente.