Widget - Bienvenue à bord

  • Publié le Jan 20, 2026
  • 1 Minute(s) lue(s)
Prev Next

Le widget Bienvenue à bord est un panneau d'information statique destiné à guider les utilisateurs lors de leurs premières connexions à Tuleap.

Note d’installation

Ce widget est utilisable uniquement sur le Tableau de bord personnel.

Contenu

Contenu par défaut

Le contenu par défaut affiché par ce widget s'adapte automatiquement selon le profil de l'utilisateur connecté :

  • Pour un utilisateur standard : le message est orienté vers la découverte et l'adoption de l'outil. Il suggère généralement les premières étapes pour démarrer dans l'espace de travail, comprendre l'organisation générale et rejoindre des projets.

  • Pour un administrateur de plateforme : le message fournit des repères techniques essentiels. Il met en avant les points de configuration serveur, les fichiers systèmes importants et les actions d'administration requises pour finaliser l'installation de la plateforme.

Astuce

Ce widget est utile pour débuter votre utilisation de Tuleap. Une fois familiarisé avec la plateforme, l'utilisateur peut le supprimer (via l'icône engrenage du widget) pour libérer de l'espace sur son tableau de bord.

Personnalisation du contenu

Par défaut, le texte de ce widget est statique et défini dans les fichiers du système Tuleap. Un administrateur système ayant accès au serveur peut personnaliser ces messages.

Cette opération s'effectue directement sur le système de fichiers du serveur. Pour modifier le contenu affiché :

  1. Connectez-vous au serveur Tuleap en SSH.

  2. Identifiez le fichier source original correspondant au profil à modifier dans /usr/share/tuleap/site-content/fr_FR/widget/ :        

    • my_welcome_message.mustache (message pour les utilisateurs standards).

    • my_welcome_message_admin.mustache (message pour les administrateurs).

  3. Copiez le fichier souhaité vers le répertoire de personnalisation /etc/tuleap/site-content/ en reproduisant la même arborescence.        
    Exemple :

    cp /usr/share/tuleap/site-content/fr_FR/widget/my_welcome_message.mustache /etc/tuleap/site-content/fr_FR/widget/my_welcome_message.mustache

  4. Éditez le fichier copié dans /etc/ avec votre propre contenu HTML.

  5. Les modifications sont prises en compte immédiatement après l'enregistrement.

Attention

Tuleap utilise un mécanisme de surcharge (override). Ne modifiez jamais les fichiers originaux présents dans /usr/share/tuleap/site-content/.

Également, les fichiers copiés peuvent contenir des balises de template (Mustache) ou du formatage HTML spécifique. Veillez à préserver la structure existante pour éviter la survenue d’erreurs sur l'affichage du tableau de bord.

Articles Liés