Dépannage

Les styles ou le script du thème répondent 404 après une mise à jour

Sur Redmine 6.x et 7.0, les fichiers du thème sont servis par Propshaft sous un nom à empreinte (/assets/themes/filonio/application-<empreinte>.css). Après une mise à jour, l’ancienne empreinte disparaît.

Redémarrez Redmine : les ressources sont recompilées au démarrage quand un changement est détecté (config.assets.redmine_detect_update).
Si le réglage est désactivé, ou si le 404 persiste, recompilez puis redémarrez :
```
bundle exec rake assets:precompile RAILS_ENV=production
```
Pour repartir d’un dossier de ressources propre (anciennes empreintes accumulées) :
```
bundle exec rake assets:clobber assets:precompile RAILS_ENV=production
```
Un proxy ou un CDN devant Redmine peut garder l’ancienne page en cache : videz son cache pour les pages HTML (les fichiers à empreinte, eux, ne changent jamais de contenu).

Un nouveau dossier dans le thème ou le plugin n’est pris en compte qu’au démarrage : redémarrez toujours après avoir remplacé les dossiers.

Le thème « Filonio » n’apparaît pas dans la liste des thèmes

Le dossier doit s’appeler filonio et se trouver dans themes/ (Redmine 6.x, 7.0) ou public/themes/ (Redmine 5.1.x), avec stylesheets/application.css dedans.
La liste des thèmes est lue au démarrage : redémarrez Redmine.

L’interface d’origine s’affiche malgré le thème choisi

Regardez la balise <html> au début du code source de la page :

Balise	Cause	Que faire
`<html lang="…">` sans `data-filonio`	Plugin absent ou non chargé : sans plugin, le thème est inactif	Vérifiez Administration › Plugins, le nom du dossier `plugins/filonio` et le journal de Redmine au démarrage, puis redémarrez Redmine (voir Installation).
`data-filonio="off"`	Licence non valide : essai pas encore obtenu, essai terminé après la grâce, licence révoquée, jeton refusé, ou version installée publiée après la fin des mises à jour d’une licence échue (bandeau « Filonio est désactivé »)	Administration › Licence Filonio donne l’état et le motif ; voir Licence et essai.
`data-filonio="off"` et avertissement de version	Thème et plugin de versions majeures différentes	Installez les deux archives de la même version.
`data-filonio="on"`	Filonio est actif	Videz le cache du navigateur ou d’un proxy ; voir la section 404 ci-dessus.

bundle exec rake filonio:license:status RAILS_ENV=production donne l’état de la licence en ligne de commande.

Un bandeau « Licence Filonio non vérifiable » s’affiche

C’est une cause technique, qui n’éteint pas Filonio : le bandeau, affiché aux administrateurs sur les pages d’administration, donne le motif et la marche à suivre (tables du plugin absentes, signature Ed25519 invérifiable avec ce Ruby, horloge du serveur reculée). Détail des motifs : Licence et essai.

Où s’affichent les bandeaux de licence ?

Qui : les administrateurs seulement. Un utilisateur sans droit d’administration ou un visiteur anonyme ne voit jamais de bandeau de licence, sur aucune page.
Où : les pages d’administration, c’est-à-dire toutes les entrées du menu Administration (Utilisateurs, Groupes, Rôles, Trackers, Statuts de demande, Workflow, Champs personnalisés, Listes de valeurs, Paramètres et réglages des plugins, Sources LDAP, Plugins, Informations, Licence Filonio, entrées des autres plugins). Pas sur les projets, les demandes, Ma page ni la fiche publique d’un utilisateur.
Exception, fin de grâce : pendant les 3 derniers jours de la période de grâce, le bandeau « Le thème sera désactivé dans N jours » s’affiche sur toutes les pages (administrateurs seulement), avec le lien vers la page Licence.
Bandeau masqué : la croix le masque pour la session ; il revient si l’état change (fin de l’essai, entrée dans les 3 derniers jours de grâce) ou à la session suivante.

Un avertissement de version s’affiche dans l’administration

Le thème et le plugin n’ont pas la même version, le fichier VERSION du thème manque (thème installé sans son build), ou Redmine est plus récent que la dernière branche vérifiée. Hors version majeure différente, il ne s’affiche que sur les pages d’administration (toutes les entrées du menu Administration, Paramètres et configuration des plugins compris, Licence Filonio), pas sur les projets ni Ma page. Installez le thème et le plugin depuis les archives de la même version (voir Installation).

L’onglet « Tableau » n’apparaît pas, ou une carte ne se déplace pas

L’onglet et l’entrée de menu demandent le thème Filonio choisi et le droit Voir les demandes dans le projet.
Une carte sans bouton « Déplacer vers… » n’est pas modifiable par l’utilisateur : droit Modifier les demandes (ou Modifier ses propres demandes) et transitions du workflow de son rôle.
« Session expirée : reconnectez-vous puis réessayez. » : la session a expiré ; Se reconnecter ramène au tableau.
Autres messages de refus et leurs causes : Tableau des demandes.

L’en-tête de la page manque pendant une seconde

L’en-tête et le menu d’origine de Redmine restent masqués jusqu’à ce que le script du thème les ait recomposés en barre et en rail, pendant le chargement de la page ; le contenu, lui, s’affiche aussitôt. Si le script ne se charge pas (bloqué par une politique de sécurité du contenu, un proxy, ou en 404), l’en-tête d’origine apparaît après moins d’une seconde, sans la recomposition du thème. Ouvrez la console du navigateur : le fichier /assets/themes/filonio/theme-<empreinte>.js (ou /themes/filonio/javascripts/theme.js sur Redmine 5.1.x) doit répondre 200 ; sur la fiche et le formulaire de demande, theme-issue-<empreinte>.js (theme-issue.js en 5.1.x) aussi. S’il manque, la fiche garde la mise en page de Redmine (en-tête, panneau des propriétés, historique d’origine) sans erreur : vérifiez que le thème et le plugin sont de la même version et que les assets ont été recompilés (Redmine 6.x et 7.0).

Requêtes vers gravatar.com

Elles viennent du réglage des avatars de Redmine (Administration › Paramètres › Affichage › Afficher les Gravatar des utilisateurs), pas de Filonio : le thème n’appelle aucun autre service externe (polices et images locales). Quand ce réglage est actif, le thème affiche aussi ces photos dans ses listes, le tableau, la fiche et le rail (URL fournies par le plugin, avec l’image par défaut choisie dans le même écran) ; désactivé, il affiche des initiales et aucune requête ne part vers gravatar.com.

Les préférences d’un utilisateur ne sont pas gardées

Elles sont enregistrées dans Mon compte (préférences Redmine de l’utilisateur) : les préférences d’apparence ne sont jamais gardées dans le navigateur (l’état du panneau latéral et les recherches récentes de la palette, eux, restent en localStorage). Le bloc « Préférences Filonio » n’apparaît que lorsque Filonio est actif : sans le plugin ou sans licence valide, il est masqué et les valeurs déjà enregistrées restent en base, intactes pour le retour de Filonio.

La licence est « Hors ligne »

Le serveur de licences est injoignable : le thème reste actif jusqu’à la validité hors ligne du jeton en cache (valid_until), puis pendant 7 jours de grâce (une licence payée échue n’a plus besoin du serveur). Vérifiez le flux HTTPS sortant et l’adresse du serveur, puis :

bundle exec rake filonio:license:status RAILS_ENV=production
bundle exec rake filonio:license:heartbeat RAILS_ENV=production

Signaler un problème

Joignez la version (themes/filonio/VERSION, Administration › Plugins), la version de Redmine et de Ruby (Administration › Informations), le navigateur, et une capture de la console du navigateur.

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