Het merk ownCloud Classic 10 met een thema-app en CSS

Voor ownCloud Server Classic 10 kunt u uw branding als thema-app maken en deze in een aangepaste app-directory plaatsen, zodat de kans kleiner is dat deze bij upgrades wordt vervangen. Gebruik dat thema om logo's te vervangen en CSS-kleuren te definiëren; er is geen algemene ingebouwde kleurenkiezer waarmee u willekeurige merkkleuren in de webinterface kunt toepassen. De onderstaande stappen hebben betrekking op de webinterface van Classic Server, niet op ownCloud Infinite Scale.

Scheid eerst de drie merkstrategieën van elkaar.

Geverifieerd: ownCloud Classic 10 ondersteunt thema's als apps. Een thema kan CSS, afbeeldingen, sjablonen en vertalingen overschrijven. De officiële ontwikkelaarshandleiding vermeldt ook dat de oude themeinstelling config.phpin Classic 10 niet meer wordt ondersteund. Actie: identificeer uw product en versie voordat u bestanden wijzigt: deze procedure is voor ownCloud Server Classic 10.

Afhankelijk van uw editie: ownCloud's ownBrander-service is een grafische brandingoptie die is beschreven voor Enterprise-klanten. Hiermee kunt u een webthema en clients met uw eigen huisstijl creëren; toegang is afhankelijk van een Enterprise-abonnement en de geschiktheid van uw account. Actie: als u Enterprise-toegang hebt, vraag dan uw ownCloud-beheerder of accountcontactpersoon of ownBrander is ingeschakeld. Gebruik anders een thema-app en test deze op een testomgeving.

Veelvoorkomend misverstand: Infinite Scale (oCIS) gebruikt een ander webaanpassingsmodel, inclusief eigen configuratie- en themabestanden. Instructies voor oCIS theme.jsonzijn niet van toepassing op Classic Server-thema's. Actie: kopieer geen bestanden of configuratie uit een oCIS-handleiding naar een Classic Server-installatie.

Een andere veelvoorkomende aanname is dat het wijzigen van het logo in een instellingenscherm automatisch alle logo's, kleuren en clients wijzigt. De ontwikkelaarshandleiding van Classic Server beschrijft thema-overrides op basis van het bestandssysteem; de beschikbaarheid van functies en clientbranding hangt af van de editie en de gebruikte methode. Actie: plan de inlogpagina, de header voor ingelogde gebruikers, het favicon en alle desktop- of mobiele clients als afzonderlijke controles.

Bereid een thema-app veilig voor.

Maak een back-up van uw instantie en test deze eerst op een testomgeving. Noteer de ownCloud-versie, PHP/runtime-pakketten, app-mappen, webservergebruiker en de huidige thema-gerelateerde configuratie. De officiële handleiding raadt aan om aangepaste thema's in een aparte app-map op te slaan om te voorkomen dat ze verloren gaan tijdens upgrades. Actie: zoek uw geconfigureerde map voor aangepaste apps op, of gebruik de gedocumenteerde apps-externalmap indien beschikbaar; ga er niet vanuit dat elk pakket hetzelfde pad gebruikt.

Een thema-app heeft een appinfo/info.xmlbestand nodig met een app-ID die overeenkomt met de map waarin deze is opgeslagen, een <theme/>type en een bereik van ownCloud-afhankelijkheden. Het voorbeeld in de ontwikkelaarshandleiding gebruikt Classic 10 als zowel de minimale als de maximale versie. Pas dit aan naar de versies die u daadwerkelijk ondersteunt in plaats van blindelings een bereik te kopiëren. Actie: begin met het officiële thema-voorbeeld van ownCloud en bekijk de huidige bestanden voordat u het aanpast.

Een themamap kan bijvoorbeeld de naam hebben theme-acmeen afbeeldingen appinfo/info.xml, core/css/styles.cssbestanden en overschrijvingen bevatten onder paden die overeenkomen met de corresponderende ownCloud-paden. De mapnaam en de <id>waarde moeten overeenkomen. Actie: houd het thema onder versiebeheer en gebruik een unieke ID om conflicten met geïnstalleerde apps te voorkomen.

Wijzig logo's en themakleuren

Om een ​​afbeelding te overschrijven, moet je het relatieve pad ervan binnen het thema behouden. Het standaardpad van het inloglogo is bijvoorbeeld core/img/logo-icon.svg, dus de thema-override hoort op theme-acme/core/img/logo-icon.svg. In de handleiding staan ​​andere afbeeldingspaden vermeld en wordt opgemerkt dat de verwerking van favicon's zowel SVG- als PNG-overrides moet omvatten. Actie: controleer de huidige installatiebestanden en reproduceer de relevante paden in je thema in plaats van kernbestanden te vervangen.

Om kleuren te overschrijven, kunt u dit core/css/styles.cssin het thema aanpassen. De officiële handleiding beschrijft selectors zoals #body-loginvoor de achtergrond van het inlogscherm en #body-public #headervoor de header die verschijnt wanneer u bent ingelogd. Een minimaal voorbeeld is:

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

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

Dit wijzigt de gedocumenteerde gebieden; het is geen compleet kleurenpalet voor elke app, dialoogvenster of interface van derden. Actie: gebruik de ontwikkelaarstools van uw browser op uw eigen instantie om het beoogde onderdeel te identificeren en voeg vervolgens nauwkeurig afgebakende CSS-regels toe aan het stylesheet van het thema. Vermijd brede selectors die tekst, knoppen of focusstatussen onleesbaar kunnen maken.

Gebruik een logovariant die in de beschikbare ruimte past en controleer het contrast voor normale tekst, links, besturingselementen en toetsenbordfocus. De exacte selectors en afmetingen van de assets kunnen variëren afhankelijk van de geïnstalleerde versie, het thema en de apps. Actie: vergelijk je overrides met de huidige DOM en assets op de stagingomgeving in plaats van ervan uit te gaan dat een oude selector nog steeds overeenkomt.

Schakel het thema en het account in voor integriteitscontroles.

Nadat je het thema in de juiste app-directory hebt geplaatst en het eigenaarschap hebt ingesteld zodat de webserver het kan lezen, kun je het inschakelen met het installatiecommando occ. De officiële handleiding geeft docker compose exec owncloud occ app:enable theme-acmeeen Docker-voorbeeld; voor niet-Docker-installaties moet je je eigen ondersteunde commandocontext gebruiken. Thema's kunnen ook worden ingeschakeld via het scherm 'Beheer apps', waar ze tussen de uitgeschakelde apps verschijnen. Actie: volg de commandovorm voor jouw implementatie en controleer of de app-ID overeenkomt met de directory en de metadata.

Een privéthema heeft mogelijk geen Marketplace-handtekening. ownCloud documenteert dat de app-ID integrity.ignore.missing.app.signatureindien nodig moet worden toegevoegd om de waarschuwing voor een ontbrekende handtekening te voorkomen. Deze uitzondering geldt specifiek voor het niet-ondertekende privéthema; dit betekent niet dat de integriteitscontrole wereldwijd moet worden uitgeschakeld. Actie: voeg alleen de thema-ID toe aan de gedocumenteerde whitelist als uw installatie deze waarschuwing geeft, en behoud alle andere integriteitsbeschermingen.

De bestandsrechten van de thema-app moeten de webserver toestaan ​​de bestanden te lezen. De exacte gebruikers- en groepsnamen verschillen per pakket en host; het www-datavoorbeeld in de documentatie is niet universeel. Actie: controleer het daadwerkelijke account van de actieve service en stel het eigenaarschap van de thema-directory nauwkeurig in.

Controleer het resultaat en bewaar het.

Open de inlogpagina in een privévenster van de browser, log in en controleer de header, navigatie, bestandslijst, instellingenpagina's en de weergave in kleinere vensters. Controleer of het logo scherp is, de tekst leesbaar blijft, de focusindicatoren zichtbaar blijven en er geen elementen naar de achtergrond verdwijnen. De handleiding raadt aan om te testen in een live ontwikkelomgeving en de inspectietools van de browser te gebruiken om CSS-wijzigingen uit te proberen. Actie: test deze stappen eerst in de stagingomgeving en herhaal dit na de implementatie met een schone browsercache.

Als er niets verandert, controleer dan of de thema-app is ingeschakeld, of de map zich binnen een gescand app-pad bevindt, of de relatieve bestandsnamen overeenkomen met de standaardwaarden en of de CSS-selector nog steeds overeenkomt met de pagina. Controleer de logbestanden van ownCloud en de webserver op laad- of machtigingsfouten. Gecachede CSS of browserbestanden kunnen zichtbare updates vertragen. Actie: wis de browsercache of gebruik een privévenster nadat u de bestanden en de app-status hebt gecontroleerd; verwijder geen productiedata en schakel geen integriteitscontroles uit als snelle oplossing voor problemen.

Test het thema na elke ownCloud-update opnieuw. De kernopmaak en paden naar assets kunnen veranderen, waardoor aangepaste CSS mogelijk niet meer werkt of conflicteert met een nieuwe interface. De handleiding beschrijft de thema-app-aanpak, maar garandeert niet dat elke overschrijving compatibel blijft tussen releases. Actie: bewaar een back-up van uw thema, vergelijk uw thema met de release waarnaar u upgradet en verwijder verouderde overschrijvingen pas na het testen.

Officiële referenties

Laat een reactie achter

Beveilig ownCloud met HTTPS via Let's Encrypt en Nginx.

Beveilig ownCloud met HTTPS via Let's Encrypt en Nginx.

Kies HTTP-01 of DNS-01, configureer een ownCloud reverse proxy en controleer of Certbot HTTPS-certificaten automatisch vernieuwt.

Verbind ownCloud Infinite Scale met LDAP voor gebruikersaanmelding.

Configureer de oCIS LDAP-aanmelding, stem gebruikers- en groepszoekopdrachten op elkaar af en controleer de TLS- en schema-instellingen vóór de uitrol.

Verbind een S3-bucket met ownCloud 10 als externe opslag.

Verbind een S3-bucket met ownCloud 10 als externe opslag.

Voeg een Amazon S3-bucket toe aan ownCloud 10, bereid compatibele inloggegevens en eindpunten voor en controleer de toegang zonder een mount te verwarren met primaire opslag.

Automatiseer het maken van database-dumps van ownCloud met een veilige, dagelijkse cronjob.

Automatiseer het maken van database-dumps van ownCloud met een veilige, dagelijkse cronjob.

Plan beveiligde MariaDB-dumps voor ownCloud Server, ga veilig om met de onderhoudsmodus en controleer elke back-up voordat u erop vertrouwt.

Migreer ownCloud Classic naar oCIS met een ondersteunde migratie.

Plan een migratie van ownCloud 10 naar oCIS met de ondersteunde app, geordende opdrachten, identiteitscontroles en een duidelijke lijst van gegevens die afzonderlijk verwerkt moeten worden.

Het merk ownCloud Classic 10 met een thema-app en CSS

Vervang de logo's van ownCloud Classic 10 en pas de kleuren van de webinterface aan met een thema-app, en vermijd daarbij de valkuilen van upgrades en integriteitscontroles.

Stel standaardopslagquota in op basis van gebruikersrol in ownCloud oCIS.

Stel standaardopslagquota in op basis van gebruikersrol in ownCloud oCIS.

Wijs bytegebaseerde opslaglimieten toe aan nieuwe ownCloud Infinite Scale-gebruikers per rol, met behulp van een proxy.yaml-voorbeeld en een checklist voor veilige verificatie.

Los certificaatfouten van ownCloud Sync op bij de TLS-bron.

Los certificaatfouten van ownCloud Sync op bij de TLS-bron.

Herstel de synchronisatie van ownCloud Desktop door de serverhostnaam, certificaatketen, vertrouwensrelatie met de privé-CA en problemen met de captive portal te controleren, zonder TLS-verificatie uit te schakelen.

Een ownCloud-integriteitswaarschuwing wissen na een upgrade

Gebruik het rapport met ongeldige bestanden om niet-overeenkomende kernbestanden of app-handtekeningen te identificeren, de juiste releasebestanden te herstellen en de integriteitscontrole veilig te verifiëren.

Installeer ownCloud Infinite Scale met Docker Compose.

Implementeer ownCloud Infinite Scale vanuit het officiële Compose-voorbeeld, configureer domeinen en permanente opslag, en controleer vervolgens TLS, containers en de eerste aanmelding.