OwnCloud Classic 10 avec un thème et du CSS

Pour ownCloud Server Classic 10, créez votre identité visuelle sous forme d'application thème et placez-la dans un répertoire d'applications personnalisé afin de minimiser les risques de remplacement lors des mises à jour. Utilisez ce thème pour remplacer les logos et définir les couleurs CSS ; il n'existe pas de sélecteur de couleurs intégré permettant d'appliquer des couleurs de marque arbitraires à l'ensemble de l'interface web. Les étapes ci-dessous concernent l'interface utilisateur web de Classic Server, et non ownCloud Infinite Scale.

Premièrement, séparez les trois voies de marque

Vérifié : ownCloud Classic 10 prend en charge les thèmes en tant qu’applications. Un thème peut remplacer le CSS, les images, les modèles et les traductions. Le manuel du développeur indique également que l’ancien themeparamètre config.phpest obsolète dans Classic 10. Action : identifiez votre produit et sa version avant de modifier les fichiers ; cette procédure concerne ownCloud Server Classic 10.

Cela dépend de votre édition : le service ownBrander d’ownCloud est une option de personnalisation graphique destinée aux clients Entreprise. Il permet de créer un thème web et des clients personnalisés ; l’accès est soumis à un abonnement Entreprise et à l’éligibilité du compte. Action : si vous disposez d’un accès Entreprise, demandez à votre administrateur ownCloud ou à votre contact de compte si ownBrander est activé. Sinon, utilisez une application de thème et testez-la sur une instance de test.

Erreur fréquente : Infinite Scale (oCIS) utilise un modèle de personnalisation web différent, avec ses propres fichiers de configuration et de thème. Les instructions oCIS theme.jsonne s’appliquent pas aux thèmes de Classic Server. Consigne : ne copiez aucun fichier ni configuration d’un guide oCIS dans une installation de Classic Server.

Une autre idée reçue courante est que modifier le logo dans les paramètres modifie automatiquement tous les logos, couleurs et clients. Le manuel du développeur de Classic Server décrit les personnalisations de thème au niveau du système de fichiers ; la disponibilité des fonctionnalités et l’image de marque du client dépendent de l’édition et de la méthode. Action : prévoyez des vérifications distinctes pour la page de connexion, l’en-tête de connexion, le favicon et les clients de bureau ou mobiles.

Préparez une application thématique en toute sécurité

Sauvegardez votre instance et effectuez d'abord un test sur une copie de test. Notez la version d'ownCloud, le packaging PHP/runtime, les répertoires de l'application, l'utilisateur du serveur web et la configuration actuelle du thème. Le manuel officiel recommande de stocker les thèmes personnalisés dans un répertoire d'application dédié afin de réduire le risque de les perdre lors des mises à jour. Action : localisez votre répertoire d'application personnalisé configuré ou utilisez le apps-externalrépertoire documenté lorsqu'il est disponible ; ne présumez pas que tous les packages utilisent le même chemin.

Une application de thème nécessite un appinfo/info.xmlfichier avec un identifiant d'application correspondant à son dossier, un <theme/>type et une plage de dépendances ownCloud. L'exemple du manuel du développeur utilise Classic 10 comme version minimale et maximale. Adaptez ces valeurs aux versions que vous prenez réellement en charge au lieu de copier une plage sans discernement. Action : partez de l'exemple de thème officiel d'ownCloud et examinez ses fichiers actuels avant de l'adapter.

Par exemple, un répertoire de thème peut être nommé theme-acmeet contenir des fichiers `<script>` appinfo/info.xml, core/css/styles.css`<script>` et des remplacements d'images sous des chemins correspondant aux chemins ownCloud. Le nom du répertoire et la <id>valeur doivent correspondre. Action : gérez les versions du thème et utilisez un identifiant unique pour éviter les conflits avec les applications installées.

Modifier les logos et les couleurs du thème

Pour remplacer une image, conservez son chemin relatif dans le thème. Par exemple, le chemin par défaut du logo de connexion est `/logo/logo` core/img/logo-icon.svg, donc le remplacement dans le thème doit se faire à theme-acme/core/img/logo-icon.svg`/logo/logo`. Le manuel répertorie d'autres chemins d'image et précise que la gestion des favicons doit inclure les remplacements pour les formats SVG et PNG. Action : examinez les ressources de votre installation et reproduisez les chemins correspondants dans votre thème au lieu de remplacer les fichiers principaux.

Pour personnaliser les couleurs, créez un élément core/css/styles.cssdans le thème. Le manuel officiel documente les sélecteurs, notamment #body-loginpour l'arrière-plan de connexion et #body-public #headerl'en-tête de l'utilisateur connecté. Voici un exemple minimal :

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

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

Cela modifie les zones documentées ; il ne s’agit pas d’une palette de couleurs complète pour chaque application, boîte de dialogue ou interface tierce. Action : utilisez les outils de développement de votre navigateur pour identifier le composant concerné, puis ajoutez des règles CSS spécifiques à la feuille de style du thème. Évitez les sélecteurs trop généraux qui peuvent rendre le texte, les boutons ou les états de focus illisibles.

Utilisez une variante de logo adaptée à l'espace disponible et vérifiez le contraste du texte, des liens, des commandes et du focus clavier. Les sélecteurs et dimensions des ressources peuvent varier selon la version installée, le thème et les applications. Action : comparez vos modifications avec le DOM et les ressources actuels de l'environnement de test plutôt que de supposer qu'un ancien sélecteur est toujours compatible.

Activez le thème et le compte pour les contrôles d'intégrité.

Après avoir placé le thème dans le répertoire d'application approprié et configuré les droits d'accès pour que le serveur web puisse le lire, activez-le à l'aide de la occcommande d'installation. Le manuel officiel fournit docker compose exec owncloud occ app:enable theme-acmeun exemple pour Docker ; les installations non Docker doivent utiliser leur propre contexte de commande. Les thèmes peuvent également être activés depuis l'écran « Applications d'administration », où ils apparaissent parmi les applications désactivées. Procédure : suivez la procédure de commande correspondant à votre déploiement et vérifiez que l'ID de l'application correspond au répertoire et aux métadonnées.

Un thème privé peut ne pas être signé sur la Marketplace. ownCloud indique d'ajouter son ID d'application integrity.ignore.missing.app.signaturelorsque cela est nécessaire pour éviter l'avertissement de signature manquante. Cette exception concerne spécifiquement les thèmes privés non signés ; elle ne signifie pas que la vérification d'intégrité doit être désactivée globalement. Action : si votre installation signale cet avertissement, ajoutez uniquement l'ID du thème à la liste blanche documentée et conservez toutes les autres protections d'intégrité.

Les permissions des fichiers de l'application thème doivent autoriser le serveur web à lire ces fichiers. Les noms d'utilisateur et de groupe exacts varient selon le package et l'hôte ; l' www-dataexemple de la documentation n'est pas universel. Action : vérifiez le compte du service en cours d'exécution et définissez précisément le propriétaire du répertoire du thème.

Vérifiez le résultat et maintenez-le.

Ouvrez la page de connexion dans une fenêtre de navigation privée, connectez-vous et examinez l'en-tête, la navigation, la liste des fichiers, les pages de paramètres et les fenêtres d'affichage plus petites. Vérifiez que le logo est net, que le texte reste lisible, que les indicateurs de focus sont toujours visibles et qu'aucun élément de contrôle ne disparaît en arrière-plan. Le manuel recommande de tester dans un environnement de développement en production et d'utiliser les outils d'inspection du navigateur pour tester les modifications CSS. Action : testez d'abord ces chemins en préproduction, puis répétez l'opération après le déploiement avec un cache de navigateur vidé.

Si rien ne change, vérifiez que l'application de thème est activée, que le répertoire se trouve dans un chemin d'accès d'application analysé, que les noms de fichiers relatifs correspondent aux valeurs par défaut et que le sélecteur CSS correspond toujours à la page. Consultez les journaux d'ownCloud et du serveur web pour détecter d'éventuelles erreurs de chargement ou d'autorisation. La mise en cache des fichiers CSS ou des ressources du navigateur peut retarder l'affichage des mises à jour. Action : videz le cache du navigateur ou utilisez une fenêtre de navigation privée après avoir vérifié l'état des fichiers et de l'application ; ne supprimez pas les données de production et ne désactivez pas les contrôles d'intégrité pour résoudre le problème rapidement.

Enfin, testez à nouveau le thème après chaque mise à jour d'ownCloud. Le balisage principal et les chemins d'accès aux ressources peuvent changer ; par conséquent, le CSS personnalisé peut devenir inefficace ou entrer en conflit avec une nouvelle interface. Le manuel décrit l'approche thème-application, mais ne garantit pas la compatibilité de chaque personnalisation entre les versions. Action : conservez une copie de sauvegarde, comparez votre thème avec la version vers laquelle vous effectuez la mise à jour et supprimez les personnalisations obsolètes uniquement après les avoir testées.

Références officielles

Laisser un commentaire

OwnCloud Classic 10 avec un thème et du CSS

Remplacez les logos ownCloud Classic 10 et personnalisez les couleurs de l'interface utilisateur Web grâce à une application de thème, tout en évitant les pièges liés à la mise à niveau et à la vérification d'intégrité.

Définir les quotas de stockage par défaut en fonction du rôle de l'utilisateur dans ownCloud oCIS

Définir les quotas de stockage par défaut en fonction du rôle de l'utilisateur dans ownCloud oCIS

Attribuez des limites de stockage en octets aux nouveaux utilisateurs d'ownCloud Infinite Scale en fonction de leur rôle, avec un exemple de fichier proxy.yaml et une liste de contrôle de vérification sécurisée.

Résoudre les erreurs de certificat de synchronisation ownCloud au niveau de la source TLS

Résoudre les erreurs de certificat de synchronisation ownCloud au niveau de la source TLS

Rétablissez la synchronisation de votre ordinateur ownCloud en vérifiant le nom d'hôte du serveur, la chaîne de certificats, la confiance de l'autorité de certification privée et les problèmes liés au portail captif sans désactiver la vérification TLS.

Effacer un avertissement d'intégrité ownCloud après une mise à niveau

Utilisez le rapport de fichiers invalides pour identifier les fichiers principaux ou les signatures d'application non concordants, restaurer les fichiers de version corrects et vérifier l'intégrité en toute sécurité.

Installer ownCloud Infinite Scale avec Docker Compose

Déployez ownCloud Infinite Scale à partir de son exemple Compose officiel, configurez les domaines et le stockage persistant, puis vérifiez TLS, les conteneurs et la première connexion.

Configurer le stockage Blob S3 pour ownCloud Infinite Scale

Configurer le stockage Blob S3 pour ownCloud Infinite Scale

Configurez le pilote S3NG, les autorisations du compartiment, le stockage persistant des métadonnées et la taille des chargements afin qu'ownCloud Infinite Scale puisse stocker le contenu des fichiers de manière fiable.

Lorsque les chargements sur ownCloud se bloquent à 99 %, vérifiez ces limites.

Lorsque les chargements sur ownCloud se bloquent à 99 %, vérifiez ces limites.

Découvrez pourquoi un chargement sur un serveur ownCloud s'interrompt presque complètement en vérifiant l'état du fichier, le quota, l'espace disque temporaire, les limites PHP et les délais d'expiration du proxy.

Supprimer en toute sécurité l'avertissement relatif au fichier .htaccess d'ownCloud Apache

Supprimer en toute sécurité l'avertissement relatif au fichier .htaccess d'ownCloud Apache

Configurez AllowOverride All uniquement pour la racine web d'ownCloud, validez l'hôte virtuel Apache actif et rechargez en toute sécurité pour restaurer les règles .htaccess.

Configurez l'audit d'ownCloud Enterprise et vérifiez les journaux.

Activez l'application d'audit d'entreprise d'ownCloud, acheminez les événements admin_audit vers un fichier journal protégé et vérifiez que les actions réelles des utilisateurs sont bien enregistrées.

Connectez ownCloud Infinite Scale à Keycloak avec OIDC

Connectez ownCloud Infinite Scale à Keycloak avec OIDC

Alignez l'émetteur de domaine Keycloak, le client web et les revendications des utilisateurs pour permettre à ownCloud Infinite Scale de connecter les utilisateurs de manière fiable sur les clients web et mobiles.