Aller au contenu

Définir la couleur d'accent de la plateforme

Vous êtes administrateur·ice d'une instance Kirexo et vous voulez changer la couleur d'accent de toute la plateforme — la teinte qui colore les liens, les boutons principaux et les détails d'interface, pour tous les visiteurs.

Prérequis

Réglage d'instance, pas préférence personnelle

L'accent est un réglage global de l'instance : votre choix s'applique à tous les visiteurs, pas seulement à votre navigateur. C'est différent du thème clair/sombre, qui reste une préférence locale de chaque lecteur. Le pourquoi de cette distinction est détaillé dans Pourquoi un accent d'instance piloté serveur.

Les 6 couleurs disponibles

Le sélecteur propose six valeurs d'accent, et uniquement celles-ci :

Libellé Identifiant (data-accent)
Encre encre
Bordeaux bordeaux
Forêt foret
Prune prune
Rouille rouille
Graphite graphite

L'accent par défaut d'une instance fraîche est Encre. Ces valeurs sont figées par l'enum App\Entity\Enum\AccentColor (src/Entity/Enum/AccentColor.php) ; on ne peut pas en saisir une autre.

Procédure

  1. Connecté·e en administrateur·ice, rendez-vous sur /admin/reglages (route app_admin_settings). Vous pouvez aussi y accéder depuis le dashboard admin (/admin), qui porte un lien vers les réglages.
  2. La page Réglages affiche la rubrique « Accent » : six pastilles de couleur, une par valeur. La pastille actuellement active est pré-sélectionnée.
  3. Cliquez sur la pastille de la couleur voulue (par exemple Forêt).
  4. Cliquez sur « Enregistrer ».
  5. La page se recharge et le nouvel accent s'applique immédiatement à toute l'interface — liens, boutons, détails colorés. Le changement est visible dès cette redirection, sans délai.

Effet immédiat et global

L'enregistrement est synchrone : la nouvelle valeur est écrite en base dans la requête, puis la page est rechargée (motif Post/Redirect/Get) avec la bonne couleur déjà posée. Tout visiteur qui recharge une page de l'instance après votre enregistrement verra lui aussi le nouvel accent — il n'y a rien à resynchroniser de son côté.

Vérifier que le changement a bien pris

Le nouvel accent est posé côté serveur sur la balise <html> de chaque page de l'instance, via l'attribut data-accent. Pour le contrôler, ouvrez l'inspecteur de votre navigateur sur n'importe quelle page et vérifiez l'attribut :

<html lang="fr" data-theme="light" data-accent="foret">

Si data-accent reflète la couleur choisie, le réglage est appliqué pour toute l'instance.

En cas de problème

  • Je ne vois pas la page /admin/reglages (erreur 403 ou 404). L'accès est réservé à ROLE_ADMIN. Pour un visiteur connecté à l'espace utilisateur, l'admin se masque (404) ; assurez-vous d'être connecté·e sur l'espace d'administration (/admin/login). Voir Architecture des firewalls.
  • La couleur ne change pas après « Enregistrer ». Vérifiez d'avoir bien sélectionné une pastille avant de soumettre, puis rechargez la page. Si l'attribut data-accent du <html> ne bouge toujours pas, videz le cache du navigateur (l'accent est servi dans le HTML, pas par un script).

Voir aussi