Para ownCloud Server Classic 10, cree su marca como una aplicación de tema y colóquela en un directorio de aplicaciones personalizado para que sea menos probable que las actualizaciones la reemplacen. Use ese tema para reemplazar los logotipos y definir los colores CSS; no existe un selector de color integrado que aplique colores de marca arbitrarios en toda la interfaz web. Los pasos que se describen a continuación corresponden a la interfaz web de Classic Server, no a ownCloud Infinite Scale.
Primero, separe las tres rutas de marca.
Verificado: ownCloud Classic 10 admite temas como aplicaciones. Un tema puede sobrescribir CSS, imágenes, plantillas y traducciones. El manual oficial para desarrolladores también indica que la themeconfiguración anterior config.phpestá obsoleta en Classic 10. Acción: identifique su producto y versión antes de modificar los archivos; este procedimiento es para ownCloud Server Classic 10.
Depende de tu edición: el servicio ownBrander de ownCloud es una opción de personalización gráfica para clientes Enterprise. Permite crear temas web y clientes personalizados; el acceso depende de una suscripción Enterprise y de la elegibilidad de la cuenta. Acción: si tienes acceso Enterprise, consulta con tu administrador de ownCloud o con tu contacto de cuenta para saber si ownBrander está habilitado. De lo contrario, utiliza una aplicación de tema y valídala en una instancia de prueba.
Error común: Infinite Scale (oCIS) utiliza un modelo de personalización web diferente, que incluye sus propios archivos de configuración y temas. Las instrucciones para oCIS theme.jsonno se aplican a los temas de Classic Server. Acción: no copie archivos ni configuración de una guía de oCIS en una instalación de Classic Server.
Otra suposición común es que cambiar el logotipo en la pantalla de configuración modifica automáticamente todos los logotipos, colores y clientes. El manual para desarrolladores de Classic Server describe las anulaciones de temas basadas en el sistema de archivos; la disponibilidad de funciones y la personalización de la marca del cliente dependen de la edición y el método. Acción: planifique la página de inicio de sesión, el encabezado de sesión iniciada, el favicon y cualquier cliente de escritorio o móvil como comprobaciones independientes.
Prepara una aplicación de tema de forma segura
Primero, realiza una copia de seguridad de tu instancia y pruébala en un entorno de prueba. Registra la versión de ownCloud, el empaquetado de PHP/tiempo de ejecución, los directorios de la aplicación, el usuario del servidor web y la configuración actual relacionada con el tema. El manual oficial recomienda almacenar los temas personalizados en un directorio de aplicación personalizado para reducir la posibilidad de perderlos durante las actualizaciones. Acción: localiza el directorio de aplicación personalizado configurado o utiliza el apps-externaldirectorio documentado cuando esté disponible; no asumas que todos los paquetes utilizan la misma ruta.
Una aplicación de tema necesita un appinfo/info.xmlarchivo con un ID de aplicación que coincida con su carpeta, un <theme/>tipo y un rango de dependencias de ownCloud. El ejemplo del manual del desarrollador usa Classic 10 como versión mínima y máxima. Ajuste esto según las versiones que realmente admita, en lugar de copiar un rango sin más. Acción: comience con el ejemplo de tema oficial de ownCloud y revise sus archivos actuales antes de adaptarlo.
Por ejemplo, un directorio de tema podría llamarse theme-acmey contener appinfo/info.xmlarchivos core/css/styles.cssde personalización de imágenes y archivos de personalización en rutas que reflejen las rutas correspondientes de ownCloud. El nombre del directorio y el <id>valor deben coincidir. Acción: mantenga el tema bajo control de versiones y utilice un ID único para evitar conflictos con las aplicaciones instaladas.
Cambiar logotipos y colores del tema
Para sobrescribir una imagen, conserve su ruta relativa dentro del tema. Por ejemplo, la ruta predeterminada del logotipo de inicio de sesión es core/img/logo-icon.svg, por lo que la sobrescritura del tema debe estar en theme-acme/core/img/logo-icon.svg. El manual enumera otras rutas de imagen y señala que el manejo del favicon debe incluir sobrescrituras tanto de SVG como de PNG. Acción: inspeccione los recursos de la instalación actual y reproduzca las rutas relevantes dentro de su tema en lugar de reemplazar los archivos principales.
Para anular los colores, créelos core/css/styles.cssen el tema. El manual oficial documenta selectores como #body-loginel del fondo de inicio de sesión y #body-public #headerel del encabezado de sesión iniciada. Un ejemplo mínimo es:
#body-login {
background: #17324d;
}
#body-public #header {
background-color: #17324d;
}
Esto modifica las áreas documentadas; no se trata de una paleta de colores completa para cada aplicación, diálogo o interfaz de terceros. Acción: utilice las herramientas para desarrolladores del navegador en su propia instancia para identificar el componente deseado y, a continuación, añada reglas CSS específicas a la hoja de estilos del tema. Evite los selectores amplios que pueden dificultar la lectura del texto, los botones o los estados de enfoque.
Utilice una variante del logotipo que se ajuste al espacio disponible y compruebe el contraste para texto normal, enlaces, controles y el foco del teclado. Los selectores y las dimensiones de los recursos pueden variar según la versión instalada, el tema y las aplicaciones. Acción: compare sus modificaciones con el DOM y los recursos actuales en el entorno de pruebas, en lugar de asumir que un selector antiguo sigue siendo válido.
Habilita el tema y la cuenta para realizar comprobaciones de integridad.
Tras colocar el tema en el directorio de la aplicación correcto y establecer los permisos para que el servidor web pueda leerlo, actívelo con el occcomando de instalación. El manual oficial proporciona docker compose exec owncloud occ app:enable theme-acmeun ejemplo para Docker; las instalaciones que no utilicen Docker deben usar su propio contexto de comandos compatible. Los temas también se pueden activar desde la pantalla de Aplicaciones de administración, donde aparecen entre las aplicaciones deshabilitadas. Acción: siga el formulario de comandos correspondiente a su implementación y confirme que el ID de la aplicación coincide con el directorio y los metadatos.
Un tema privado puede no tener una firma de Marketplace. ownCloud documenta cómo agregar su ID de aplicación integrity.ignore.missing.app.signaturecuando sea necesario para evitar la advertencia de firma faltante. Esta excepción es específica para los temas privados sin firmar; no significa que la verificación de integridad deba deshabilitarse globalmente. Acción: agregue solo el ID del tema a la lista de permitidos documentada si su instalación muestra esa advertencia y conserve todas las demás protecciones de integridad.
Los permisos de archivo de la aplicación de tema deben permitir que el servidor web lea los archivos. Los nombres exactos de usuario y grupo varían según el paquete y el host; el www-dataejemplo de la documentación no es universal. Acción: verifique la cuenta real del servicio en ejecución y establezca permisos de propiedad restringidos para el directorio del tema.
Verificar el resultado y mantenerlo
Abra la página de inicio de sesión en una ventana de incógnito, inicie sesión e inspeccione el encabezado, la navegación, la lista de archivos, las páginas de configuración y los tamaños de ventana más pequeños. Confirme que el logotipo se vea nítido, que el texto sea legible, que los indicadores de enfoque permanezcan visibles y que ningún control desaparezca en segundo plano. El manual recomienda realizar pruebas en un entorno de desarrollo real y utilizar las herramientas de inspección del navegador para probar los cambios de CSS. Acción: pruebe primero esas rutas en el entorno de pruebas y luego repita el proceso tras la implementación con la caché del navegador limpia.
Si no hay cambios, compruebe que la aplicación de temas esté habilitada, que el directorio se encuentre dentro de una ruta de aplicación escaneada, que los nombres de archivo relativos coincidan con los predeterminados y que el selector CSS siga coincidiendo con la página. Revise los registros de ownCloud y del servidor web en busca de errores de carga o permisos. El CSS en caché o los recursos del navegador pueden retrasar las actualizaciones visibles. Acción: borre la caché del navegador o utilice una ventana privada después de confirmar el estado de los archivos y la aplicación; no elimine los datos de producción ni desactive las comprobaciones de integridad como solución rápida.
Finalmente, vuelva a probar el tema después de cada actualización de ownCloud. El marcado principal y las rutas de los recursos pueden cambiar, por lo que el CSS personalizado puede volverse ineficaz o entrar en conflicto con la nueva interfaz. El manual establece el enfoque de la aplicación de tema, pero no garantiza que todas las modificaciones sigan siendo compatibles entre versiones. Acción: conserve una copia de reversión, compare su tema con la versión a la que está actualizando y elimine las modificaciones obsoletas solo después de realizar las pruebas.
Referencias oficiales