
Un accueil et des index modernes pour Dolibarr / Tableau de bord NSINFO
Documentation du module · version 23.0.1 · éditeur NSINFO
Sommaire
1. Présentation
Tableau de bord NSINFO remplace la page d’accueil de Dolibarr et les pages d’index des sections par des tableaux de bord modernes, personnalisables par chaque utilisateur, sans modifier le Core de Dolibarr.
- Les indicateurs (éléments ouverts et en retard) sont regroupés par thème : clients, fournisseurs, projets, tickets.
- Les widgets de Dolibarr et de vos modules sont conservés : ajout, suppression, déplacement et redimensionnement.
- Les widgets se déplacent et se redimensionnent comme des fenêtres, sur une grille de 3, 6, 9 ou 12 colonnes.
- Les index des sections (Tiers, Commercial, Facturation, Produits, Projets, Tickets, Adhérents, Fabrication) deviennent des tableaux de bord.
- Les index des autres modules installés sont relookés automatiquement.
- Chaque utilisateur peut revenir à l’affichage classique, index par index.
- L’administrateur définit des modèles d’affichage pour des utilisateurs ou des groupes.
2. Prérequis et installation
2.1 Prérequis
- Dolibarr 20.0 ou supérieur ; PHP 7.4 ou supérieur.
- Le framework NSINFO (module NSINFO, gratuit) en version 23.9.0 ou supérieure, installé et activé. Voir le framework NSINFO.
2.2 Installation
- Installez le module comme décrit sur Installer un module.
- Dans Accueil > Configuration > Modules, activez « Tableau de bord NSINFO ».
- Ouvrez l’accueil : la nouvelle page s’affiche. Les réglages sont décrits à la section Configuration.
L’activation est refusée si le framework NSINFO n’est pas activé en version suffisante.
2.3 Mise à jour / réactivation
Après une mise à jour du module, désactivez puis réactivez le module : cela enregistre ses éléments dans Dolibarr (droits, menu, pages concernées). Un bandeau dans l’onglet « Autres modules » des réglages le rappelle quand c’est nécessaire, avec un bouton « Enregistrer maintenant ».
À la toute première activation (pas à une mise à jour), les mises en page et les choix de tous les utilisateurs sont effacés une fois, puis le fichier de configuration livré avec le module est chargé : chacun démarre avec la présentation classique (3 colonnes, widgets répartis pour remplir l’espace). Les mises à jour suivantes conservent les affichages des utilisateurs.
3. La page d’accueil
L’accueil de Dolibarr est remplacé par une page qui regroupe, de haut en bas : un message de bienvenue avec la date, le message du jour de Dolibarr s’il existe, les indicateurs, puis les widgets.
3.1 Les indicateurs
Ce sont les mêmes éléments que le « tableau de bord des éléments ouverts » de Dolibarr : propositions à accepter ou à facturer, commandes, contrats, factures impayées, tâches, tickets… Chaque indicateur affiche le nombre d’éléments et, en couleur, le nombre d’éléments en retard.
- Ils sont regroupés par thème dans des blocs nommés : Clients, Fournisseurs, Projets et agenda, Tickets, Autres.
- Dans chaque bloc, les indicateurs d’un même sujet forment une carte : propositions, commandes, contrats, factures.
- Un clic sur un indicateur ouvre la liste correspondante ; un clic sur la pastille de retard ouvre la liste des éléments en retard.
- Au survol, deux petits pictogrammes permettent de masquer un indicateur et de le déplacer dans son bloc. Les indicateurs masqués se réaffichent depuis la page Mes fenêtres ou avec le lien « Afficher les éléments masqués ».
- Les indicateurs à zéro (sans retard) ne sont pas affichés ; cela se règle dans les réglages.
3.2 Les widgets
Les widgets sont ceux de Dolibarr et de vos modules, tels que vous les aviez : ils s’ajoutent avec la liste « Choisir un widget à ajouter », se ferment avec la croix et gardent leurs paramètres.
- Ils ont un nouveau style : cartes, couleur d’accent selon le thème (commercial, facturation, projets, tickets, agenda, produits, statistiques).
- Un widget fermé puis ajouté de nouveau revient en haut à gauche (option des réglages).
4. Les index des sections
Quand l’option est activée pour une section, son index d’origine est remplacé par un tableau de bord du même style :
- Les indicateurs de la section (propositions, commandes, factures, projets, tickets…).
- Des cartes de statistiques avec des graphiques : camembert par statut, graphiques en barres sur les 12 derniers mois (nombre et montant HT) ; pour les tickets, les tickets nouveaux et fermés sur 12 mois.
- Des cartes de derniers enregistrements (tiers, contacts, propositions, commandes, factures, produits, tickets…), avec la référence client ou fournisseur et le montant HT pour les propositions, commandes et factures.
- Les widgets de la section quand Dolibarr en prévoit (Tiers, Produits, Tickets, Adhérents, Interventions).
- Des boutons de création et de liste selon vos droits. Un module n’affiche ses cartes que s’il est activé.
Sections concernées : Tiers, Commercial, Facturation, Produits et services, Projets, Tickets, Adhérents, Fabrication, Propositions commerciales, Commandes clients, Factures clients, Factures fournisseurs, Commandes fournisseurs, Fournisseurs, Contrats, Interventions, Expéditions, Propositions fournisseurs. Chaque section s’active ou se désactive dans l’onglet « Index des sections » des réglages ; elles sont activées par défaut, et l’interrupteur d’une section n’apparaît que si le module concerné est activé.
4.1 Cartes de statistiques et cartes liste
- Retirer un élément d’une carte de statistiques (un graphique, le tableau par statut) : croix à droite de son titre.
- Remettre un élément : trois points « ⋮ » à droite de l’en-tête de la carte, la liste des éléments retirés s’ouvre dessous.
- Nombre de lignes d’une carte liste : trois points de la carte (3, 5, 8, 10, 15, 20, 30 ou 50), ou liste de l’en-tête de la page pour toutes les cartes. La valeur de Dolibarr s’applique tant qu’aucun choix n’est fait.
Ces choix sont propres à chaque utilisateur et à chaque page.
5. Les index du cœur de Dolibarr et des autres modules
Les pages d’index des modules installés et de nombreuses pages du cœur de Dolibarr (Stock, Notes de frais, Comptabilité, Ressources humaines, Dons, Réceptions, Recrutement, statistiques, activité des projets…) sont relookées automatiquement : leurs blocs sont repérés dans la page, mis en cartes et placés sur la grille, avec les mêmes poignées de bord que les widgets. Rien n’est à déclarer module par module : sur une autre installation de Dolibarr, ce sont les modules qui y sont installés qui sont pris en compte.
- Seul l’affichage change ; les fichiers des modules ne sont jamais modifiés.
- L’agenda reçoit un habillage (cartes, jour courant, événements) sans déplacement de blocs, car ses filtres et son calendrier sont dans un même formulaire.
- L’administrateur peut laisser un index tel quel avec l’onglet « Autres modules » des réglages (deux onglets : modules installés, cœur de Dolibarr).
- Chaque utilisateur peut revenir à l’affichage classique d’un index (voir Revenir à l’affichage classique).
6. Placer et dimensionner les widgets
6.1 Déplacer
Saisissez le widget par sa barre de titre et déplacez-le :
- Un cadre en pointillés montre où il sera posé ; les autres widgets se poussent pour lui faire de la place.
- Posé près du bas d’un autre widget, il s’y colle ; posé plus loin, il reste exactement là où vous l’avez déposé.
- Les liens et boutons du widget gardent leur fonction ; le déplacement ne démarre qu’après quelques pixels.
6.2 Redimensionner
Comme une fenêtre :
- Bords gauche et droit : la largeur (le bord opposé reste fixe).
- Bord du bas : la hauteur ; un double clic sur la barre redonne la hauteur automatique.
- Coin en bas à droite : la largeur et la hauteur en même temps.
- Un double clic en haut du widget lui redonne sa taille normale (un tiers de la largeur, hauteur automatique).
6.3 Choisir la grille
Le sélecteur 3 · 6 · 9 · 12 en haut de la page règle le pas des déplacements et des redimensionnements.
- Avec plus de colonnes, la grille est plus fine : les widgets gardent leur taille et leur place.
- Avec moins de colonnes, la grille est plus grossière : la largeur et la colonne de chaque widget sont ramenées au nouveau pas.
Sur un écran moyen, la grille est réduite de moitié ; sur un petit écran, les widgets sont empilés.
6.4 Présentation classique
Le bouton à droite du sélecteur de colonnes remet tout en ordre : les widgets actifs sont répartis sur 3 colonnes, pris thème par thème (clients, fournisseurs, projets, tickets, produits, agenda, statistiques) et placés chacun à l’endroit le moins haut, pour remplir l’espace au mieux, avec les propositions avant les commandes, les contrats et les factures.
7. Revenir à l’affichage classique
- Le bouton « Revenir à l’affichage classique » de chaque page ouvre l’index d’origine de Dolibarr. Le choix est retenu pour cet index et pour vous : les autres index restent en tableau de bord.
- Sur l’index d’origine, le bouton « Affichage NSINFO » (en bas à droite) ramène au tableau de bord.
- Pour consulter un index d’origine sans retenir le choix, ajoutez nsdash=0 à l’adresse de la page.
8. Mes fenêtres
La page Outils > Mes fenêtres (menu de gauche) est ouverte à tout utilisateur interne qui a le droit d’utiliser le module (pas aux utilisateurs externes). Elle liste, pour chaque index auquel vous avez accès :
- l’interrupteur de redirection vers la page du module ;
- les indicateurs masqués, à réafficher en un clic ;
- les widgets fermés, à ajouter de nouveau ;
- un bouton pour réinitialiser l’affichage d’un index, ou de tous.
Si le modèle d’affichage qui vous est donné est verrouillé, la page est en lecture seule.
9. Configuration
Accueil > Configuration > Modules, puis le pictogramme de réglage du module. Les pages de réglages sont réservées aux administrateurs de Dolibarr. En haut, les onglets sont : Réglages, Configuration (JSON), ChangeLog et À propos. Dans Réglages, les onglets verticaux sont :
9.1 Onglet Accueil
- Redirection de l’accueil : tous les utilisateurs sauf une liste, seulement des utilisateurs choisis, ou personne. La redirection fonctionne aussi juste après la connexion.
- Espacement entre les fenêtres : 0, 4, 8, 12, 16, 20, 24, 32 ou 40 pixels (16 par défaut), pour l’accueil et tous les index.
- Couleurs des alertes : pastille « en retard » des indicateurs, badge « en retard » et badge « rien en retard » du titre.
- Un widget réactivé revient en haut à gauche et Ne pas afficher les indicateurs à zéro (interrupteurs).
Les réglages s’enregistrent dès qu’on les change.
9.2 Onglet Modèles d’affichage
Un modèle d’affichage fixe, page par page, la taille, la visibilité et l’ordre des fenêtres.
- Créer un modèle vide, ou copier l’affichage d’un utilisateur.
- Donner un modèle à un utilisateur ou à un groupe ; le modèle de l’utilisateur prime sur celui de son groupe.
- Un utilisateur garde son propre réglage tant qu’il en a un ; « Effacer l’affichage personnel de cet utilisateur » le ramène au modèle.
- Un modèle verrouillé empêche ses utilisateurs de changer l’affichage.
9.3 Onglet Index des sections
Un interrupteur par section : Tiers, Commercial, Facturation, Produits et services, Projets, Tickets, Adhérents, Ordres de fabrication, Propositions commerciales, Commandes clients, Factures clients, Factures fournisseurs, Commandes fournisseurs, Fournisseurs, Contrats, Interventions, Expéditions et Propositions fournisseurs. Activé, l’index d’origine est remplacé par le tableau de bord de la section. Activé par défaut ; seules les sections dont le module est activé sont listées.
9.4 Onglet Autres modules
La liste des modules installés et activés, avec leur nom et leur pictogramme, et leurs pages d’index. Chaque page a son interrupteur : désactivée, elle est laissée telle quelle.
9.5 Onglet Utilisateurs sans redirection
- Réglage par utilisateur : choisir un utilisateur et activer ou désactiver, index par index, son passage par la page du module.
- La liste des utilisateurs ayant désactivé la redirection, avec un bouton « Réactiver ».
9.6 Onglet Configuration (JSON)
La configuration de l’installation (réglages, affichages par défaut des pages, modèles d’affichage) se transporte dans un fichier JSON, en deux sous-onglets :
- Exporter : choisir le compte dont les affichages deviennent les affichages par défaut (par exemple le compte de développement), générer le JSON, le télécharger ou l’enregistrer dans le module.
- Importer : glisser-déposer le fichier JSON (ou le coller), ou appliquer le fichier livré avec le module ; « Restaurer la configuration usine » remet les réglages, affichages par défaut et modèles du fichier livré, avec confirmation ; les modèles absents du fichier et leurs attributions sont supprimés, et une case permet d’effacer aussi les affichages personnels et les choix de tous les utilisateurs.
Le fichier enregistré dans le dossier du module est chargé automatiquement à la première initialisation du module : chaque utilisateur démarre avec la mise en page prévue. Les réglages du fichier comprennent aussi la liste des index laissés tels quels (onglet « Autres modules »). Les affichages personnels, les listes d’utilisateurs et les attributions de modèles ne sont pas dans le fichier.
9.7 Affichage par défaut et administrateurs du module
Les administrateurs de Dolibarr et les administrateurs du module (choisis dans l’onglet Accueil) disposent du bouton « Définir comme affichage par défaut » dans l’en-tête de chaque page : l’affichage actuel devient celui des utilisateurs qui n’ont ni affichage personnel ni modèle.
10. Droits d’accès
| Droit | Effet |
|---|---|
| Utiliser les pages NSINFO (accueil et index des sections) | Voir les tableaux de bord, la page Mes fenêtres et les index relookés. Sans ce droit, l’affichage d’origine de Dolibarr est conservé. |
| Modifier l’affichage | Déplacer, redimensionner, masquer, fermer, choisir la grille et revenir à l’affichage classique. Sans ce droit, ou avec un modèle verrouillé, l’utilisateur voit l’affichage qui lui est donné, sans outils. |
Les deux droits sont donnés à tous les utilisateurs à l’activation. Les utilisateurs externes gardent l’accueil d’origine de Dolibarr et n’ont accès ni aux tableaux de bord ni à la page Mes fenêtres.
11. Limites connues et FAQ
- Mon index d’un autre module n’a pas changé. Il faut au moins deux blocs repérables dans la page ; sinon elle est laissée telle quelle. Vérifiez aussi son interrupteur dans l’onglet « Autres modules ».
- Où est passé un widget ? Il est peut-être fermé : page « Mes fenêtres ».
- Un indicateur a disparu. Les indicateurs à zéro et sans retard sont masqués (option des réglages) ; sinon, il est peut-être masqué : page « Mes fenêtres ».
- Les widgets se chevauchent après un changement de grille. Un widget qui gêne est poussé vers le bas ; le bouton « Présentation classique » remet tout en ordre.
- Les modules d’autres éditeurs. Leur affichage peut être relooké comme les autres, mais leurs fichiers ne sont jamais modifiés ; un interrupteur permet de laisser leurs pages d’origine.
- Multi-sociétés. Les affichages, modèles et choix sont propres à chaque entité.
