Cascade d'habillage
Comment Wakastart choisit, pour chaque utilisateur, le logo, le fond, le favicon et le thème CSS parmi les niveaux application, réseau, client et utilisateur.
L'habillage d'une wakapp n'est pas stocké à un seul endroit. Chaque niveau de votre organisation peut définir le sien, et Wakastart retient, élément par élément, le plus proche de l'utilisateur.
Définition
La cascade d'habillage est la règle qui choisit, pour un utilisateur donné, chaque élément visuel de l'application :
| Élément | Ordre de résolution, du plus prioritaire au moins prioritaire |
|---|---|
| Logo clair, logo sombre | client → réseau → application |
| Fond clair, fond sombre | client → réseau → application |
| Favicon | client → réseau → application |
| Thème CSS | préférence de l'utilisateur → client → réseau → application |
La résolution se fait par élément et non par niveau entier. Un client peut fournir son seul logo : il garde alors le fond et le favicon de son réseau, ou ceux de l'application.
Les couleurs de marque de l'application (couleur primaire, couleur d'accent, fond CSS) ne suivent pas la cascade : elles sont définies une fois, au niveau de l'application.
Pourquoi ça existe
Un éditeur distribue souvent la même application à plusieurs réseaux, qui la revendent à leurs propres clients. Chacun veut y voir sa marque, sans que l'éditeur ait à maintenir une version par client. La cascade permet de ne renseigner que ce qui diffère : un réseau pose son logo une fois, tous ses clients en héritent, et un client qui le souhaite le remplace par le sien.
Qui renseigne chaque niveau
| Niveau | Où | Qui |
|---|---|---|
| Application | onglet Thèmes du paramétrage de l'application, en lecture seule dans la console | l'équipe Wakastart, à partir des fichiers que vous lui transmettez |
| Réseau | fiche du réseau, onglet Thème (visuels) et onglet Général (Thème par défaut) | un Administrateur réseau ou un Propriétaire |
| Client | configuration du client, onglet Thèmes (visuels) et onglet Général (Thème par défaut) | un Administrateur client ou un niveau supérieur |
| Utilisateur | Mon profil, section Préférences, liste Thème préféré | chaque utilisateur |
Le Theme Studio d'un réseau ou d'un client n'affiche que les visuels de ce niveau. Un emplacement vide signifie que le niveau supérieur s'applique.
Comment votre application reçoit le résultat
Votre application n'a pas à refaire la cascade. Deux appels de l'API publique la lui donnent toute faite :
GET /api/merenvoie un objetbrandingrésolu pour l'utilisateur connecté : logos, fonds, favicon, couleurs de marque de l'application et variables du thème CSS retenu.GET /api/apps/{appWid}/runtime-configrenvoie l'habillage du niveau application seul, avec l'adresse du CSS du thème par défaut de l'application et la liste de ses langues. Il sert au démarrage, avant de savoir à quel client appartient l'utilisateur.
Le jeton enrichi porte aussi, dans sa revendication wthm, le nom du thème retenu pour l'utilisateur à partir de sa préférence, de son client ou de son réseau.
Exemples
- Un réseau de cliniques : le réseau dépose son logo et un thème vert. Ses vingt cliniques clientes l'affichent sans rien configurer.
- Un client qui a sa charte : une clinique dépose son propre logo clair et choisit son thème. Ses utilisateurs voient son logo ; le fond et le favicon restent ceux du réseau.
- Un utilisateur qui préfère le sombre : il choisit un thème sombre dans Mon profil. Ce choix passe avant celui de son client, pour lui seul.