Préférences des utilisateurs

Chaque utilisateur règle son apparence dans Mon compte › Préférences Filonio. Les valeurs sont enregistrées dans ses préférences Redmine et appliquées par le serveur dès le premier affichage de chaque page (pas de clignotement au chargement).

Les valeurs par défaut de ces préférences sont fixées par l’administrateur (voir Réglages d’administration).

Deux états d’interface sont aussi mémorisés dans le compte, sans champ dans Mon compte ni valeur d’administration (null tant que l’utilisateur ne les a pas choisis, le thème applique alors son défaut ; null par l’API y ramène) :

Les administrateurs ont en plus deux marqueurs, écrits par le thème dès qu’une annonce de nouvelle version s’affiche (voir Licence › Annonce des nouvelles versions) ; ils ne figurent ni dans Mon compte, ni dans le contexte du thème, ni dans la réponse de l’API :

Navigation au clavier

• Lien d’évitement : le premier appui sur Tab affiche « Aller au contenu » en haut à gauche de la fenêtre, au-dessus du rail et de la barre ; Entrée porte le focus au contenu de la page.
• Raccourcis à touche unique (c, /, [, ], m, G puis I / M / P / F dans la seconde qui suit) : actifs par défaut. Ils ne se déclenchent jamais pendant la saisie dans un champ, ni avec Alt (touches d’accès du cœur), ni quand un dialogue est ouvert (tiroir, modale). Dans la palette, seules les combinaisons Ctrl / ⌘ restent actives (Ctrl+K / ⌘K la referme). Préférence désactivée : seules les combinaisons Ctrl / ⌘ restent actives.
• Rail : Tab sur le logo le déploie (libellés), Échap le replie, [ l’épingle ; au survol, un aperçu avec libellés et épingle s’ouvre sans rien déplacer. Il n’y a plus de bouton « Déployer le menu » : sur un écran tactile sans souris (tablette en paysage), le bouton Menu de la barre ouvre le rail en tiroir, comme sous 1024 px.
• Rail, menus : la photo du compte ouvre le menu du compte (Mon compte, Administration pour un administrateur, Aide, Déconnexion) ; rail replié, l’étoile ouvre le menu des projets favoris (G puis F) ; les modules du projet qui ne tiennent pas dans la hauteur de la fenêtre sont dans Plus (N), le module courant restant toujours dans le rail.
• Menus : les menus du rail, les menus « … » et le menu Créer de la barre s’ouvrent au clavier (Entrée, Espace ou flèche bas), se parcourent aux flèches (Début, Fin) et se referment par Échap, qui rend le focus au bouton.
• Tiroirs (rail sous 1024 px et sur écran tactile sans souris, panneau latéral de 640 à 1279 px) : le focus reste dans le tiroir ouvert ; Échap ou un clic sur le voile le referme et rend le focus au bouton d’ouverture.

Par l’API

Avec l’API REST de Redmine activée (Administration › Paramètres › API), un utilisateur peut modifier ses préférences avec sa clé d’API :

curl -X PATCH https://redmine.example.com/filonio/preferences.json \
  -H "X-Redmine-API-Key: <clé>" -H "Content-Type: application/json" \
  -d '{ "preferences": { "theme": "dark", "rail_pinned": true } }'

Écritures simultanées (rail, favoris, panneau, annonce vue…) : le compte range toutes ses préférences dans un seul enregistrement ; chaque PATCH le verrouille et le relit avant d’y fusionner ses clés, sans effacer celles d’une autre requête.

Réponses : 200 avec les valeurs normalisées, 400 si preferences n’est pas un objet, 422 pour une clé ou une valeur inconnue (rien n’est enregistré), 401 / 403 sans utilisateur connecté.

Sans le plugin

Le plugin est requis : sans lui, Filonio reste inactif et Redmine garde son interface d’origine. Les préférences d’apparence ne sont jamais gardées dans le navigateur : elles n’existent que dans le compte Redmine, et restent en base, sans effet, tant que Filonio est inactif (fin de licence, plugin retiré). L’état du panneau latéral des listes et des autres pages (une clé par type de page ; celui de la fiche est la préférence issue_panel) et les recherches récentes de la palette, eux, restent dans le navigateur (localStorage).

Copie de la documentation livrée avec Filonio (dossier docs/ des archives).