Aller au contenu

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.

ConceptAdministrateurDéveloppeur
Voir en Markdown

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émentOrdre de résolution, du plus prioritaire au moins prioritaire
Logo clair, logo sombreclient → réseau → application
Fond clair, fond sombreclient → réseau → application
Faviconclient → réseau → application
Thème CSSpré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.

Chargement du schéma…

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

NiveauOùQui
Applicationonglet Thèmes du paramétrage de l'application, en lecture seule dans la consolel'équipe Wakastart, à partir des fichiers que vous lui transmettez
Réseaufiche 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
Clientconfiguration du client, onglet Thèmes (visuels) et onglet Général (Thème par défaut)un Administrateur client ou un niveau supérieur
UtilisateurMon 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/me renvoie un objet branding ré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-config renvoie 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.

Pour aller plus loin