Personaliza ownCloud Classic 10 con una aplicación de tema y CSS.

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

Dejar un comentario

Personaliza ownCloud Classic 10 con una aplicación de tema y CSS.

Sustituye los logotipos de ownCloud Classic 10 y personaliza los colores de la interfaz web con una aplicación de temas, evitando al mismo tiempo los problemas relacionados con la actualización y la comprobación de integridad.

Establecer cuotas de almacenamiento predeterminadas por rol de usuario en ownCloud oCIS

Establecer cuotas de almacenamiento predeterminadas por rol de usuario en ownCloud oCIS

Asigne límites de almacenamiento basados ​​en bytes a los nuevos usuarios de ownCloud Infinite Scale según su rol, con un ejemplo de proxy.yaml y una lista de verificación de seguridad.

Solucione los errores del certificado de sincronización de ownCloud en el origen TLS.

Solucione los errores del certificado de sincronización de ownCloud en el origen TLS.

Restaure la sincronización de ownCloud Desktop comprobando el nombre de host del servidor, la cadena de certificados, la confianza de la CA privada y los problemas del portal cautivo sin deshabilitar la verificación TLS.

Eliminar una advertencia de integridad de ownCloud después de una actualización

Utilice el informe de archivos no válidos para identificar archivos principales o firmas de aplicaciones que no coincidan, restaurar los archivos de lanzamiento correctos y verificar la integridad de forma segura.

Instala ownCloud Infinite Scale con Docker Compose

Implementa ownCloud Infinite Scale desde su ejemplo oficial de Compose, configura los dominios y el almacenamiento persistente, y luego verifica TLS, los contenedores y el primer inicio de sesión.

Configurar el almacenamiento de blobs S3 para ownCloud Infinite Scale

Configurar el almacenamiento de blobs S3 para ownCloud Infinite Scale

Configure el controlador S3NG, los permisos del bucket, el almacenamiento persistente de metadatos y el tamaño de carga para que ownCloud Infinite Scale pueda almacenar el contenido de los archivos de forma fiable.

Cuando las cargas de ownCloud se detienen al 99%, compruebe estos límites.

Cuando las cargas de ownCloud se detienen al 99%, compruebe estos límites.

Descubre por qué se detiene una carga en ownCloud Server cerca de completarse comprobando el estado del archivo, la cuota, el espacio temporal en disco, los límites de PHP y los tiempos de espera del proxy.

Borre la advertencia de ownCloud Apache .htaccess de forma segura.

Borre la advertencia de ownCloud Apache .htaccess de forma segura.

Configure AllowOverride All solo para la raíz web de ownCloud, valide el vhost Apache activo y recargue de forma segura para restaurar las reglas de .htaccess.

Configurar la auditoría empresarial de ownCloud y verificar los registros.

Habilite la aplicación de auditoría empresarial de ownCloud, dirija los eventos de admin_audit a un archivo de registro protegido y confirme que se están registrando las acciones reales de los usuarios.

Conecta ownCloud Infinite Scale con Keycloak mediante OIDC.

Conecta ownCloud Infinite Scale con Keycloak mediante OIDC.

Alinea el emisor del reino, el cliente web y las reclamaciones de usuario de Keycloak para permitir que ownCloud Infinite Scale inicie sesión de forma fiable en los clientes web y móviles.