Brand ownCloud Classic 10 con un'app tema e CSS

Per ownCloud Server Classic 10, crea il tuo brand come app tema e posizionala in una directory di app personalizzata, in modo che gli aggiornamenti abbiano meno probabilità di sovrascriverla. Usa quel tema per sostituire i loghi e definire i colori CSS; non esiste uno strumento di selezione colori integrato che applichi colori di brand arbitrari all'interfaccia web. I passaggi seguenti si riferiscono all'interfaccia web di Classic Server, non a ownCloud Infinite Scale.

Innanzitutto, separare i tre percorsi di branding

Verificato: ownCloud Classic 10 supporta i temi come app. Un tema può sovrascrivere CSS, immagini, modelli e traduzioni. Il manuale ufficiale per sviluppatori afferma inoltre che la vecchia themeimpostazione config.phpè deprecata in Classic 10. Azione: identifica il tuo prodotto e la versione prima di modificare i file: questa procedura è per ownCloud Server Classic 10.

Dipende dalla tua edizione: il servizio ownBrander di ownCloud è un'opzione di branding grafico descritta per i clienti Enterprise. Consente di creare un tema web e client personalizzati; l'accesso dipende da un abbonamento Enterprise e dall'idoneità dell'account. Azione: se disponi di un accesso Enterprise, chiedi al tuo amministratore ownCloud o al referente dell'account se ownBrander è abilitato. In caso contrario, utilizza un'app per temi e verificane il funzionamento su un'istanza di prova.

Errore comune: Infinite Scale (oCIS) utilizza un modello di personalizzazione web diverso, che include file di configurazione e temi propri. Le istruzioni per oCIS theme.jsonnon si applicano ai temi di Classic Server. Azione: non copiare file o configurazioni da una guida oCIS in un'installazione di Classic Server.

Un altro presupposto comune è che la modifica del logo in una schermata delle impostazioni modifichi automaticamente tutti i loghi, i colori e i client. Il manuale per sviluppatori di Classic Server descrive le sovrascritture del tema basate sul file system; la disponibilità delle funzionalità e la personalizzazione del client dipendono dall'edizione e dal metodo. Azione: pianificare la pagina di accesso, l'intestazione della schermata di accesso, la favicon e tutti i client desktop o mobili come verifiche separate.

Prepara un'app a tema in modo sicuro

Esegui prima un backup della tua istanza e testala su una copia di staging. Annota la versione di ownCloud, il packaging PHP/runtime, le directory dell'app, l'utente del server web e la configurazione corrente relativa al tema. Il manuale ufficiale consiglia di archiviare i temi personalizzati in una directory dell'app personalizzata per ridurre la possibilità di perderli durante gli aggiornamenti. Azione: individua la directory dell'app personalizzata configurata oppure utilizza la apps-externaldirectory documentata, se disponibile; non dare per scontato che tutti i pacchetti utilizzino lo stesso percorso.

Un'app tema necessita di un appinfo/info.xmlfile con un ID app corrispondente alla sua cartella, un <theme/>tipo e un intervallo di dipendenze ownCloud. L'esempio del manuale per sviluppatori utilizza Classic 10 sia come versione minima che massima. Modifica questi valori in base alle versioni effettivamente supportate, anziché copiare un intervallo senza verificarlo. Azione: parti dall'esempio di tema ufficiale di ownCloud e rivedi i file esistenti prima di adattarlo.

Ad esempio, una directory del tema potrebbe essere denominata theme-acmee contenere appinfo/info.xml, core/css/styles.css, e override delle immagini in percorsi che rispecchiano i corrispondenti percorsi di ownCloud. Il nome della directory e il <id>valore devono corrispondere. Azione: mantieni il tema sotto controllo di versione e usa un ID univoco per evitare conflitti con le app installate.

Cambiare i loghi e i colori del tema

Per sovrascrivere un'immagine, è necessario preservarne il percorso relativo all'interno del tema. Ad esempio, il percorso predefinito del logo di accesso è core/img/logo-icon.svg, quindi la sovrascrittura del tema deve trovarsi in theme-acme/core/img/logo-icon.svg. Il manuale elenca altri percorsi di immagine e precisa che la gestione delle favicon dovrebbe includere sia le sovrascritture SVG che PNG. Azione: esaminare le risorse dell'installazione corrente e riprodurre i percorsi pertinenti all'interno del tema anziché sostituire i file principali.

Per sovrascrivere i colori, crea un selettore core/css/styles.cssnel tema. Il manuale ufficiale documenta i selettori come #body-loginper lo sfondo di accesso e #body-public #headerper l'intestazione della schermata di login. Un esempio minimo è:

#body-login {
  background: #17324d;
}

#body-public #header {
  background-color: #17324d;
}

Questo modifica le aree documentate; non si tratta di una palette di colori completa per ogni app, finestra di dialogo o interfaccia di terze parti. Azione: utilizzare gli strumenti per sviluppatori del browser sulla propria istanza per identificare il componente desiderato, quindi aggiungere regole CSS specifiche al foglio di stile del tema. Evitare selettori generici che possono rendere illeggibili testo, pulsanti o stati di focus.

Utilizza una variante del logo che si adatti allo spazio esistente e verifica il contrasto per testo normale, link, controlli e focus della tastiera. I selettori e le dimensioni esatte delle risorse possono variare a seconda della versione installata, del tema e delle app. Azione: confronta le tue modifiche con il DOM e le risorse correnti nell'ambiente di staging anziché presumere che un vecchio selettore corrisponda ancora.

Abilita il tema e l'account per i controlli di integrità

Dopo aver posizionato il tema nella directory dell'app corretta e aver impostato la proprietà in modo che il server web possa leggerlo, abilitalo con il occcomando di installazione. Il manuale ufficiale fornisce docker compose exec owncloud occ app:enable theme-acmeun esempio per Docker; le installazioni non Docker dovrebbero utilizzare il proprio contesto di comando supportato. I temi possono essere abilitati anche dalla schermata App di amministrazione, dove compaiono tra le app disabilitate. Azione: segui il formato del comando per la tua distribuzione e verifica che l'ID dell'app corrisponda alla directory e ai metadati.

Un tema privato potrebbe non avere una firma del Marketplace. ownCloud documenta l'aggiunta del suo ID app integrity.ignore.missing.app.signaturequando necessario per evitare l'avviso di firma mancante. Questa eccezione è specifica per il tema privato non firmato; non significa che il controllo di integrità debba essere disabilitato a livello globale. Azione: aggiungi solo l'ID del tema all'elenco consentito documentato se la tua installazione segnala tale avviso e mantieni tutte le altre protezioni di integrità.

Le autorizzazioni dei file dell'app del tema devono consentire al server web di leggere i file. I nomi esatti di utenti e gruppi variano a seconda del pacchetto e dell'host; l' www-dataesempio nella documentazione non è universale. Azione: verificare l'account effettivo del servizio in esecuzione e impostare la proprietà in modo restrittivo per la directory del tema.

Verificare il risultato e mantenerlo

Apri la pagina di accesso in una finestra di navigazione privata, quindi accedi e controlla l'intestazione, la navigazione, l'elenco dei file, le pagine delle impostazioni e le dimensioni ridotte della finestra del browser. Verifica che il logo sia nitido, che il testo rimanga leggibile, che gli indicatori di focus siano visibili e che nessun controllo scompaia nello sfondo. Il manuale consiglia di eseguire i test in un ambiente di sviluppo reale e di utilizzare gli strumenti di ispezione del browser per provare le modifiche CSS. Azione: testa prima questi percorsi nell'ambiente di staging, quindi ripeti l'operazione dopo la distribuzione con la cache del browser pulita.

Se non cambia nulla, verifica che l'app del tema sia abilitata, che la directory si trovi all'interno di un percorso dell'app scansionato, che i nomi dei file relativi corrispondano a quelli predefiniti e che il selettore CSS corrisponda ancora alla pagina. Controlla i log di ownCloud e del server web per eventuali errori di caricamento o di autorizzazione. Il CSS memorizzato nella cache o le risorse del browser potrebbero ritardare gli aggiornamenti visibili. Azione: svuota la cache del browser o utilizza una finestra di navigazione privata dopo aver verificato lo stato dei file e dell'app; non eliminare i dati di produzione né disabilitare i controlli di integrità come scorciatoia per la risoluzione dei problemi.

Infine, testa nuovamente il tema dopo ogni aggiornamento di ownCloud. Il markup principale e i percorsi delle risorse potrebbero cambiare, quindi il CSS personalizzato potrebbe diventare inefficace o entrare in conflitto con una nuova interfaccia. Il manuale definisce l'approccio tema-app, ma non garantisce che ogni override rimanga compatibile tra le diverse versioni. Azione: conserva una copia di ripristino, confronta il tuo tema con la versione a cui stai eseguendo l'aggiornamento e rimuovi gli override obsoleti solo dopo averli testati.

Riferimenti ufficiali

Lascia un commento

Passare da ownCloud Classic a oCIS con una migrazione supportata

Pianifica una migrazione da ownCloud 10 a oCIS utilizzando l'app supportata, i comandi ordinati, i controlli di identità e un elenco chiaro dei dati che richiedono una gestione separata.

Brand ownCloud Classic 10 con un'app tema e CSS

Sostituisci i loghi di ownCloud Classic 10 e personalizza i colori dell'interfaccia web con un'app per temi, evitando al contempo problemi di aggiornamento e di verifica dell'integrità.

Imposta quote di archiviazione predefinite per ruolo utente in ownCloud oCIS

Imposta quote di archiviazione predefinite per ruolo utente in ownCloud oCIS

Assegna limiti di archiviazione basati sui byte ai nuovi utenti di ownCloud Infinite Scale in base al ruolo, con un esempio di proxy.yaml e una checklist di verifica sicura.

Risolvi gli errori del certificato di sincronizzazione di ownCloud alla sorgente TLS

Risolvi gli errori del certificato di sincronizzazione di ownCloud alla sorgente TLS

Ripristina la sincronizzazione desktop di ownCloud verificando il nome host del server, la catena di certificati, la fiducia nell'autorità di certificazione privata e i problemi relativi al portale captive, senza disabilitare la verifica TLS.

Risolvi un avviso di integrità di ownCloud dopo un aggiornamento

Utilizza il report sui file non validi per identificare i file di sistema o le firme delle app non corrispondenti, ripristinare i file di rilascio corretti e verificare in modo sicuro l'integrità dei dati.

Installa ownCloud Infinite Scale con Docker Compose

Distribuisci ownCloud Infinite Scale utilizzando l'esempio ufficiale di Compose, configura i domini e lo storage persistente, quindi verifica TLS, i container ed effettua il primo accesso.

Configurare l'archiviazione BLOB S3 per ownCloud Infinite Scale

Configurare l'archiviazione BLOB S3 per ownCloud Infinite Scale

Configura il driver S3NG, le autorizzazioni del bucket, l'archiviazione persistente dei metadati e le dimensioni di caricamento in modo che ownCloud Infinite Scale possa archiviare il contenuto dei file in modo affidabile.

Quando il caricamento su ownCloud si blocca al 99%, controlla questi limiti.

Quando il caricamento su ownCloud si blocca al 99%, controlla questi limiti.

Scopri perché un caricamento su ownCloud Server si interrompe quasi al termine, verificando lo stato del file, la quota, lo spazio su disco temporaneo, i limiti PHP e i timeout del proxy.

Elimina in modo sicuro l'avviso relativo al file .htaccess di ownCloud Apache

Elimina in modo sicuro l'avviso relativo al file .htaccess di ownCloud Apache

Imposta AllowOverride All solo per la directory principale del sito web di ownCloud, verifica il vhost Apache attivo e riavvia il sito in modo sicuro per ripristinare le regole .htaccess.

Configura il controllo degli accessi di ownCloud Enterprise e verifica i registri.

Abilita l'app Enterprise Auditing di ownCloud, instrada gli eventi admin_audit a un file di registro protetto e verifica che vengano registrate le azioni reali degli utenti.