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