ownCloud Classic 10 mit Theme-App und CSS
Ersetzen Sie die ownCloud Classic 10-Logos und passen Sie die Farben der Web-Benutzeroberfläche mit einer Design-App an, ohne dabei Probleme bei Upgrades und Integritätsprüfungen zu riskieren.
Für ownCloud Server Classic 10 erstellen Sie Ihr Branding als Theme-App und platzieren diese in einem benutzerdefinierten App-Verzeichnis, um zu verhindern, dass sie bei Upgrades überschrieben wird. Verwenden Sie dieses Theme, um Logos zu ersetzen und CSS-Farben zu definieren. Es gibt keine integrierte Farbauswahl, die beliebige Markenfarben auf die gesamte Weboberfläche anwendet. Die folgenden Schritte beziehen sich auf die Web-Oberfläche des Classic Servers, nicht auf ownCloud Infinite Scale.
Bestätigt: ownCloud Classic 10 unterstützt Themes als Apps. Ein Theme kann CSS, Bilder, Vorlagen und Übersetzungen überschreiben. Laut offiziellem Entwicklerhandbuch ist die alte themeEinstellung config.phpin Classic 10 veraltet. Handlungsempfehlung: Ermitteln Sie Ihr Produkt und Ihre Version, bevor Sie Dateien ändern. Diese Anleitung gilt für ownCloud Server Classic 10.
Abhängig von Ihrer Edition: Der ownCloud-Dienst ownBrander ist eine grafische Branding-Option für Enterprise-Kunden. Er ermöglicht die Erstellung von Web-Themes und gebrandeten Clients. Der Zugriff setzt ein Enterprise-Abonnement und entsprechende Kontoberechtigungen voraus. Vorgehensweise: Wenn Sie über Enterprise-Zugriff verfügen, fragen Sie Ihren ownCloud-Administrator oder Ansprechpartner, ob ownBrander aktiviert ist. Andernfalls verwenden Sie eine Theme-App und testen Sie diese in einer Testumgebung.
Häufiges Missverständnis: Infinite Scale (oCIS) verwendet ein anderes Web-Anpassungsmodell mit eigenen Konfigurations- und Designdateien. Anweisungen für oCIS theme.jsongelten nicht für Classic Server-Designs. Handlungsempfehlung: Kopieren Sie keine Dateien oder Konfigurationen aus einer oCIS-Anleitung in eine Classic Server-Installation.
Eine weitere gängige Annahme ist, dass das Ändern des Logos in den Einstellungen automatisch alle Logos, Farben und Clients ändert. Das Entwicklerhandbuch des Classic Servers beschreibt dateisystembasierte Theme-Überschreibungen; die Verfügbarkeit von Funktionen und das Client-Branding hängen von der Edition und der verwendeten Methode ab. Empfehlung: Planen Sie separate Prüfungen für die Anmeldeseite, die Anmeldeseite, das Favicon und alle Desktop- oder Mobilclients.
Sichern Sie Ihre Instanz und testen Sie sie zunächst in einer Testumgebung. Notieren Sie sich die ownCloud-Version, die PHP-/Laufzeitumgebung, die Anwendungsverzeichnisse, den Webserver-Benutzer und die aktuelle Theme-Konfiguration. Das offizielle Handbuch empfiehlt, benutzerdefinierte Themes in einem separaten Anwendungsverzeichnis zu speichern, um Datenverlust bei Upgrades zu vermeiden. Vorgehensweise: Suchen Sie Ihr konfiguriertes benutzerdefiniertes Anwendungsverzeichnis oder verwenden Sie, apps-externalfalls vorhanden, das dokumentierte Verzeichnis. Gehen Sie nicht davon aus, dass jedes Paket denselben Pfad verwendet.
Eine Theme-App benötigt eine appinfo/info.xmlDatei mit einer App-ID, die dem Ordner entspricht, einem <theme/>Typ und einem ownCloud-Abhängigkeitsbereich. Im Beispiel des Entwicklerhandbuchs wird Classic 10 als minimale und maximale Version verwendet. Passen Sie dies an die tatsächlich unterstützten Versionen an, anstatt einen Bereich einfach zu kopieren. Vorgehensweise: Verwenden Sie das offizielle ownCloud -Theme-Beispiel als Grundlage und prüfen Sie dessen Dateien, bevor Sie es anpassen.
Ein Theme-Verzeichnis könnte beispielsweise so benannt werden theme-acmeund Dateien sowie Bildüberschreibungen unter Pfaden enthalten appinfo/info.xml, core/css/styles.cssdie den entsprechenden ownCloud-Pfaden entsprechen. Verzeichnisname und <id>-wert müssen übereinstimmen. Empfehlung: Verwenden Sie für das Theme eine Versionskontrolle und eine eindeutige ID, um Konflikte mit installierten Apps zu vermeiden.
Um ein Bild zu überschreiben, muss dessen relativer Pfad innerhalb des Themes beibehalten werden. Der Standardpfad des Anmeldelogos lautet beispielsweise `/login/login` core/img/logo-icon.svg, daher muss die Theme-Überschreibung unter `/login/login` erfolgen theme-acme/core/img/logo-icon.svg. Das Handbuch listet weitere Bildpfade auf und weist darauf hin, dass die Favicon-Verwaltung sowohl SVG- als auch PNG-Überschreibungen berücksichtigen sollte. Vorgehensweise: Überprüfen Sie die Assets Ihrer aktuellen Installation und fügen Sie die entsprechenden Pfade in Ihr Theme ein, anstatt die Kerndateien zu ersetzen.
Um Farben zu überschreiben, erstellen Sie entsprechende Einstellungen core/css/styles.cssim Theme. Das offizielle Handbuch dokumentiert Selektoren, beispielsweise #body-loginfür den Anmeldehintergrund und #body-public #headerdie Anmelde-Kopfzeile. Ein Minimalbeispiel:
#body-login {
background: #17324d;
}
#body-public #header {
background-color: #17324d;
}
Dies ändert die dokumentierten Bereiche; es handelt sich nicht um eine vollständige Markenpalette für jede App, jeden Dialog oder jede Benutzeroberfläche von Drittanbietern. Vorgehensweise: Verwenden Sie die Entwicklertools Ihres Browsers, um die gewünschte Komponente zu identifizieren, und fügen Sie anschließend präzise CSS-Regeln zum Theme-Stylesheet hinzu. Vermeiden Sie allgemeine Selektoren, die Text, Schaltflächen oder Fokuszustände unlesbar machen können.
Verwenden Sie eine Logo-Variante, die in den vorhandenen Bereich passt, und prüfen Sie den Kontrast für normalen Text, Links, Steuerelemente und den Tastaturfokus. Die genauen Selektoren und Asset-Abmessungen können je nach installierter Version, Theme und App variieren. Handlungsempfehlung: Vergleichen Sie Ihre Überschreibungen mit dem aktuellen DOM und den Assets in der Staging-Umgebung, anstatt anzunehmen, dass ein alter Selektor noch passt.
Nachdem Sie das Theme im korrekten Anwendungsverzeichnis abgelegt und die Besitzrechte so festgelegt haben, dass der Webserver darauf zugreifen kann, aktivieren Sie es mit dem Installationsbefehl occ. Das offizielle Handbuch enthält docker compose exec owncloud occ app:enable theme-acmeein Docker-Beispiel; bei Installationen ohne Docker verwenden Sie bitte Ihren eigenen Befehlskontext. Themes können auch über die Admin-Apps aktiviert werden, wo sie unter den deaktivierten Apps angezeigt werden. Vorgehensweise: Folgen Sie dem Befehlsformular für Ihre Bereitstellung und stellen Sie sicher, dass die App-ID mit dem Verzeichnis und den Metadaten übereinstimmt.
Private Themes verfügen möglicherweise nicht über eine Marketplace-Signatur. ownCloud dokumentiert, wie die App-ID integrity.ignore.missing.app.signaturebei Bedarf hinzugefügt werden kann, um die Warnung wegen fehlender Signatur zu vermeiden. Diese Ausnahme gilt speziell für unsignierte private Themes; sie bedeutet nicht, dass die Integritätsprüfung generell deaktiviert werden sollte. Maßnahme: Fügen Sie nur die Theme-ID zur dokumentierten Zulassungsliste hinzu, wenn Ihre Installation diese Warnung ausgibt, und behalten Sie alle anderen Integritätsschutzmechanismen bei.
Die Dateiberechtigungen der Theme-App müssen dem Webserver das Lesen der Dateien erlauben. Die genauen Benutzer- und Gruppennamen variieren je nach Paket und Host; das www-dataBeispiel in der Dokumentation ist nicht allgemeingültig. Maßnahme: Überprüfen Sie das aktuelle Benutzerkonto des laufenden Dienstes und legen Sie die Besitzrechte für das Theme-Verzeichnis genau fest.
Öffnen Sie die Anmeldeseite in einem privaten Browserfenster, melden Sie sich an und überprüfen Sie Header, Navigation, Dateiliste, Einstellungsseiten sowie die Darstellung in kleineren Bildschirmgrößen. Stellen Sie sicher, dass das Logo scharf ist, der Text lesbar bleibt, die Fokusindikatoren sichtbar sind und keine Steuerelemente im Hintergrund verschwinden. Das Handbuch empfiehlt, Tests in einer Live-Entwicklungsumgebung durchzuführen und CSS-Änderungen mithilfe der Browser-Entwicklertools zu testen. Empfehlung: Testen Sie diese Pfade zunächst in der Staging-Umgebung und wiederholen Sie den Test nach der Bereitstellung mit einem leeren Browser-Cache.
Wenn sich nichts ändert, überprüfen Sie, ob die Theme-App aktiviert ist, sich das Verzeichnis innerhalb eines gescannten App-Pfads befindet, die relativen Dateinamen den Standardwerten entsprechen und der CSS-Selektor weiterhin zur Seite passt. Prüfen Sie die ownCloud- und Webserver-Protokolle auf Lade- oder Berechtigungsfehler. Zwischengespeicherte CSS- oder Browserressourcen können sichtbare Aktualisierungen verzögern. Maßnahme: Leeren Sie den Browser-Cache oder verwenden Sie ein privates Fenster, nachdem Sie die Dateien und den App-Status überprüft haben. Löschen Sie keine Produktionsdaten und deaktivieren Sie keine Integritätsprüfungen als schnelle Fehlerbehebung.
Testen Sie das Theme nach jedem ownCloud-Update erneut. Da sich der Core-Code und die Pfade zu Assets ändern können, kann benutzerdefiniertes CSS wirkungslos werden oder mit der neuen Benutzeroberfläche in Konflikt geraten. Das Handbuch beschreibt zwar den Ansatz „Theme-App“, garantiert aber nicht, dass alle Anpassungen über verschiedene Releases hinweg kompatibel bleiben. Empfehlung: Erstellen Sie eine Sicherungskopie, vergleichen Sie Ihr Theme mit dem Release, auf das Sie aktualisieren, und entfernen Sie veraltete Anpassungen erst nach erfolgreichen Tests.
Ersetzen Sie die ownCloud Classic 10-Logos und passen Sie die Farben der Web-Benutzeroberfläche mit einer Design-App an, ohne dabei Probleme bei Upgrades und Integritätsprüfungen zu riskieren.
Weisen Sie neuen ownCloud Infinite Scale-Benutzern rollenbasierte Speicherlimits auf Byte-Basis zu, inklusive eines proxy.yaml-Beispiels und einer Checkliste zur sicheren Überprüfung.
Stellen Sie die ownCloud-Desktop-Synchronisierung wieder her, indem Sie den Server-Hostnamen, die Zertifikatskette, die Vertrauensstellung der privaten Zertifizierungsstelle und Probleme mit dem Captive Portal überprüfen, ohne die TLS-Verifizierung zu deaktivieren.
Verwenden Sie den Bericht über ungültige Dateien, um nicht übereinstimmende Kerndateien oder App-Signaturen zu identifizieren, die korrekten Release-Dateien wiederherzustellen und die Integritätsprüfung sicher durchzuführen.
Stellen Sie ownCloud Infinite Scale anhand des offiziellen Compose-Beispiels bereit, konfigurieren Sie Domänen und persistenten Speicher und überprüfen Sie anschließend TLS, Container und die erste Anmeldung.
Richten Sie den S3NG-Treiber, die Bucket-Berechtigungen, die persistente Metadatenspeicherung und die Upload-Größe so ein, dass ownCloud Infinite Scale Dateiinhalte zuverlässig speichern kann.
Finden Sie heraus, warum ein Upload auf einem ownCloud-Server kurz vor Abschluss abbricht, indem Sie den Dateistatus, das Kontingent, den temporären Speicherplatz, die PHP-Limits und die Proxy-Timeouts überprüfen.
Setzen Sie AllowOverride All nur für das Web-Root-Verzeichnis von ownCloud, überprüfen Sie den aktiven Apache-Vhost und laden Sie die Seite sicher neu, um die .htaccess-Regeln wiederherzustellen.
Aktivieren Sie die ownCloud Enterprise Auditing App, leiten Sie admin_audit-Ereignisse in eine geschützte Protokolldatei um und vergewissern Sie sich, dass echte Benutzeraktionen aufgezeichnet werden.
Die Realm Issuer-, Webclient- und Benutzeransprüche von Keycloak müssen aufeinander abgestimmt werden, damit ownCloud Infinite Scale-Benutzer zuverlässig über Web- und mobile Clients anmelden können.