Gestionnaire de Widgets — Documentation Fonctionnelle

Interface d'administration permettant de configurer les widgets affichés sur les tableaux de bord, en les adaptant par module, par client et par utilisateur.

Vue d'ensemble

Les tableaux de bord d'ISI-APP sont composés de widgets : des blocs d'information qui résument une donnée clé (tickets ouverts, équipements, indicateurs CRM, etc.). Le gestionnaire de widgets permet aux administrateurs DSI de personnaliser quels widgets sont affichés, dans quel ordre, avec quelle taille et quels paramètres d'affichage.

La configuration peut être définie à plusieurs niveaux :

• Configuration par défaut (commune à tous les clients, sur un module donné)
• Configuration par client (spécifique à un client, sur le module standard)
• Configuration par utilisateur (spécifique à un utilisateur au sein d'un client)

Les modules de type Presta Basic, Presta Silver et Portail disposent de configurations globales uniquement — il n'est pas possible de les personnaliser client par client ou utilisateur par utilisateur.

Accès

• Réservé aux administrateurs DSI (isidsi).
• Accès via l'URL /widgets-panel.

Fonctionnalités principales

Gestion des configurations de widgets

• Sélectionner un contexte : choisir un module (standard, Presta, Portail...), une page du tableau de bord, et éventuellement un client et un utilisateur.
• Ajouter un widget : choisir un widget dans le catalogue, définir son titre, sa largeur, le nombre d'éléments affichés, et ses options d'affichage. Certains widgets ont des options spécifiques — voir docs/widget/widget-catalog.md.
• Modifier un widget : éditer les paramètres d'un widget déjà configuré (titre, taille, couleur, texte libre, comportement si vide).
• Régler la hauteur du widget (widget Texte personnalisé) : en plus de la largeur, le widget Texte personnalisé permet de fixer une hauteur — un preset Petit (200 px) / Moyen (300 px) / Grand (500 px) / Très grand (700 px), Auto (le widget s'étend à son contenu, sans défilement), ou Non défini. Dès que le contenu dépasse la hauteur, une barre de défilement apparaît dans le widget.
  • Non défini applique 200 px, exactement comme Non défini applique 50 % dans « Taille colonne ». Un widget dont la hauteur n'a jamais été réglée est donc borné et défilant, au lieu de s'allonger indéfiniment et de pousser le reste de la page vers le bas.
  • Pour retrouver l'ancien comportement sur un widget donné, choisir explicitement Auto.
  • Les autres widgets du portail (tableaux, carrousels, graphiques, exports…) ne proposent pas ce réglage : une hauteur bornée y comprimerait la barre d'outils, l'en-tête et la pagination.
  • Où la hauteur est visible ailleurs : l'aperçu d'un template de configuration affiche un badge de hauteur — Auto, 300px, ou 200px (défaut) — sur les seuls widgets qui en acceptent une, et la page cliente « Mes widgets » montre désormais la hauteur réellement appliquée sur le portail (elle affichait auparavant jusqu'à 300 px, donc davantage que l'accueil).
  • Une hauteur enregistrée qui ne fait plus partie des presets (réglage historique, ou preset retiré depuis) revient à Non défini à l'ouverture du formulaire — c'est déjà ce que le portail applique, et le widget redevient enregistrable.
• Réordonner les widgets : déplacer les widgets par glisser-déposer pour définir l'ordre d'affichage.
• Masquer/afficher un widget : l'option « Afficher le widget même s'il n'a aucune donnée » contrôle la visibilité quand le widget est vide.
  • Activée : le widget est toujours affiché, même vide. Pour les widgets Texte personnalisé, Action et Liens rapides, un état vide explicite est alors présenté (« Aucun contenu » / « Aucun bouton configuré » / « Aucun lien configuré »).
  • Désactivée (« masquer si vide ») : le widget n'apparaît que s'il a réellement du contenu. Le contenu pris en compte dépend du type : le texte personnalisé (texte ou média réellement saisi), les boutons d'un widget Action, ou les liens d'un widget Liens rapides. Un widget dont le contenu est vide disparaît alors du tableau de bord.
• Supprimer un widget : retirer un widget du tableau de bord pour le contexte sélectionné.
• Supprimer toute la configuration : effacer l'ensemble des widgets du contexte courant d'un seul coup.
• Importer les widgets par défaut : copier la configuration par défaut (commune à tous) vers un client spécifique, comme point de départ d'une personnalisation.

Templates de configuration (admins ISI-App de profil 1)

En complément de l'import des widgets par défaut, il est possible de préparer plusieurs configurations types nommées (« Presta », « Portail Startup »…) et de les appliquer sur un client. Trois boutons y donnent accès depuis le Widget Manager : Créer un template, Gérer les templates et Importer un template. Ils ne sont visibles que pour les administrateurs ISI-App de profil 1.

Voir docs/widget/widget-templates.md pour le détail (création, application, ce qui est écrasé et ce qui ne l'est pas).

Catalogue de widgets (administration avancée)

• Consulter le catalogue : liste de tous les types de widgets disponibles dans le système, avec leur module associé et le nombre de fois qu'ils sont utilisés dans des configurations.
• Identifier les widgets orphelins : repérer les types de widgets qui n'ont encore aucune configuration active (indiqués en orange).

Voir aussi

• Templates de configuration : docs/widget/widget-templates.md
• Catalogue des widgets disponibles : docs/widget/widget-catalog.md
• Documentation technique : .claude/technical-docs/widget/widget-manager.md