Dolibarr ERP/CRM est une puissante plateforme logicielle open source utilisée par des milliers d'entreprises à travers le monde. Bien qu'elle offre des fonctionnalités robustes et prêtes à l'emploi, l'une de ses fonctionnalités les moins utilisées, mais pourtant très efficace, est la personnalisation des tableaux de bord grâce à des widgets. Ce guide détaillé vous explique tout ce que vous devez savoir pour créer votre propre tableau de bord personnalisé dans Dolibarr, vous permettant ainsi d'adapter le système à vos besoins opérationnels et stratégiques.

Table des matières

  1. Introduction aux tableaux de bord Dolibarr

  2. Pourquoi personnaliser votre tableau de bord ?

  3. Présentation du système de widgets de Dolibarr

  4. Comprendre la structure technique

  5. Préparation de votre environnement Dolibarr

  6. Activation et utilisation des widgets intégrés

  7. Créer vos propres widgets personnalisés

  8. Ajout de widgets au tableau de bord

  9. Techniques de personnalisation avancées

  10. Gestion des tableaux de bord spécifiques à l'utilisateur

  11. Conseils pour une conception efficace du tableau de bord

  12. Maintenance de votre tableau de bord personnalisé

  13. Dépannage et débogage

  14. Réflexions finales et meilleures pratiques

1. Introduction aux tableaux de bord Dolibarr

Les tableaux de bord Dolibarr offrent un espace centralisé permettant aux utilisateurs d'accéder rapidement aux données importantes et aux indicateurs clés de performance. Par défaut, l'écran d'accueil propose un aperçu général des informations système et quelques statistiques rapides. Cependant, la plateforme permet de créer des tableaux de bord plus détaillés et spécifiques à chaque rôle en ajoutant et en configurant des widgets.

Ces tableaux de bord peuvent être personnalisés par profil utilisateur ou même par utilisateur individuel, offrant une expérience sur mesure qui prend en charge des flux de travail plus productifs et une prise de décision plus rapide.

2. Pourquoi personnaliser votre tableau de bord ?

Les tableaux de bord prêts à l'emploi ne répondent souvent pas exactement aux besoins de chaque entreprise. Personnaliser votre tableau de bord Dolibarr peut vous aider à :

  • Se concentrer sur les indicateurs de performance clés pertinents pour des rôles spécifiques (par exemple, ventes par rapport aux finances)

  • Réduisez le temps passé à naviguer dans le système

  • Améliorez l'expérience utilisateur

  • Aligner les visuels du système avec les objectifs commerciaux

Les tableaux de bord personnalisés transforment Dolibarr d'un système ERP générique en un centre d'affaires puissant et personnalisé.

3. Présentation du système de widgets de Dolibarr

Dans Dolibarr, les widgets sont de petits composants réutilisables qui affichent une information ou un résumé de données. Exemples :

  • Dernières factures

  • Graphiques de performance des ventes

  • Alertes d'inventaire

  • Calendrier et rappels

Les widgets peuvent être déplacés et configurés individuellement, permettant aux utilisateurs de personnaliser leurs vues en fonction de leur fonction ou de leurs préférences personnelles.

Il existe deux types de widgets dans Dolibarr :

  • Widgets intégrés:Préinstallé et disponible immédiatement après l'installation.

  • Widgets personnalisés:Développé manuellement ou via des modules pour répondre à des besoins spécifiques.

4. Comprendre la structure technique

Pour créer ou modifier des tableaux de bord et des widgets, il est essentiel de comprendre la structure de Dolibarr. Les fichiers et modules principaux sont organisés sous la rubrique /htdocs répertoire et des modules personnalisés peuvent être ajoutés sans interférer avec le système principal.

Les dossiers pertinents incluent :

  • /htdocs/main.inc.php: Fichier principal initialisant l'environnement

  • /htdocs/core/modules/dashboard/:Contient des modules spécifiques au tableau de bord

  • /htdocs/theme/:Contient des éléments d'interface utilisateur et de style

  • /htdocs/custom/: Emplacement recommandé pour les modules personnalisés

La création de widgets personnalisés implique souvent un mélange de PHP, HTML et JavaScript. La compréhension de la programmation orientée objet et du modèle MVC facilitera également les personnalisations plus avancées.

5. Préparation de votre environnement Dolibarr

Avant de commencer la personnalisation, assurez-vous que votre environnement Dolibarr est correctement configuré :

  • Utiliser un installation de développement séparé de votre environnement de production.

  • Assurez-vous que votre compte utilisateur dispose droits d'administrateur.

  • Installez n'importe quel modules requis (par exemple, Outils de développement).

  • Sauvegardez votre instance avant d’apporter des modifications.

Vous devez également configurer votre IDE ou éditeur de code (tel que VSCode ou PhpStorm) pour le développement PHP avec la coloration syntaxique, le contrôle de version (Git) et les capacités SFTP si vous travaillez à distance.

6. Activation et utilisation des widgets intégrés

Dolibarr intègre plusieurs widgets. Faciles à activer, ils constituent la base de votre tableau de bord personnalisé.

Pour accéder aux widgets du tableau de bord :

  1. Accédez à Accueil > Configuration > Affichage.

  2. Activez les modules du tableau de bord s’ils ne sont pas déjà actifs.

  3. Accédez à votre page d'accueil (généralement Accueil > Tableau de bord).

  4. Cliquez sur l'icône d'engrenage des paramètres ou sur le bouton « Ajouter un widget ».

Vous pourrez ajouter des widgets prédéfinis tels que :

  • Nombre de clients

  • Nombre de propositions ouvertes

  • Visualisation du pipeline des ventes

  • Résumé de la tâche

Chaque widget permet généralement une configuration de base telle que le filtrage par utilisateur, date ou statut.

7. Créez vos propres widgets personnalisés

Créer des widgets personnalisés offre un niveau de personnalisation plus élevé. Suivez ces étapes pour en créer un :

Étape 1 : Créer un module

Si vous n’avez pas de structure de module personnalisée, créez-en une :

mkdir /htdocs/custom/mymodule

Inclure les fichiers suivants :

  • mymodule.php

  • class/actions_mymodule.class.php

  • core/modules/dashboard/widget_mywidget.php

Étape 2 : Écrire le code du widget

In widget_mywidget.php, utilisez le framework de widgets de Dolibarr :

class MyWidget extends DolibarrWidget {
    public function __construct($db, $user) {
        global $langs;
        $this->db = $db;
        $this->user = $user;
        $this->enabled = true;
        $this->description = $langs->trans("My custom widget");
    }

    public function render() {
        $html = "<div class='widget'>";
        $html .= "<h3>Custom Data</h3>";
        $html .= "<p>Display your custom metrics here.</p>";
        $html .= "</div>";
        return $html;
    }
}

Étape 3 : Activer le module

Installez et activez votre module via :

  • Accueil > Configuration > Modules

  • Recherchez et activez votre nouveau module (mymodule)

Votre widget personnalisé devrait maintenant apparaître dans le menu de sélection des widgets du tableau de bord.

8. Ajout de widgets au tableau de bord

Une fois votre widget créé ou activé :

  1. Cliquez sur Accueil > Tableau de bord.

  2. Cliquez sur « Ajouter un widget » ou utilisez l’icône de configuration.

  3. Sélectionnez votre widget personnalisé dans la liste.

  4. Faites glisser et déposez pour repositionner.

Vous pouvez ajouter plusieurs instances du même widget avec différentes configurations.

9. Techniques de personnalisation avancées

Vous pouvez améliorer vos widgets en intégrant :

  • Appels AJAX pour récupérer des données dynamiques

  • Charts en utilisant des bibliothèques comme Chart.js

  • Filtres spécifiques à l'utilisateur

  • Sélecteurs de plage de dates

Exemple avec Chart.js :

$html .= "<canvas id='salesChart'></canvas>";
$html .= "<script> new Chart(document.getElementById('salesChart'), { type: 'bar', data: {...} }); </script>";

Assurez-vous que toutes les bibliothèques tierces sont correctement mises en file d'attente à l'aide du système de gestion des actifs de Dolibarr.

10. Gestion des tableaux de bord spécifiques à l'utilisateur

Dolibarr permet de personnaliser les tableaux de bord par utilisateur :

  • Chaque utilisateur peut sélectionner son propre ensemble de widgets.

  • Les administrateurs peuvent définir des widgets par défaut pour les nouveaux utilisateurs.

  • Les profils peuvent être clonés pour répliquer les configurations du tableau de bord entre les équipes.

Cette flexibilité est essentielle pour les entreprises ayant des rôles et des départements diversifiés.

11. Conseils pour une conception efficace du tableau de bord

Lors de la conception de tableaux de bord, gardez ces principes à l’esprit :

  • Clarity/Pureté: Évitez l'encombrement. Affichez uniquement les données pertinentes.

  • Cohérence:Utilisez un formatage similaire sur tous les widgets.

  • Code de couleurs:Utilisez la couleur pour indiquer l'état (par exemple, le rouge pour les tâches en retard).

  • Interactivity: Autoriser les filtres, les boutons ou les liens lorsque cela est utile.

  • Performance: Gardez les requêtes optimisées pour éviter de ralentir l'interface.

12. Maintenance de votre tableau de bord personnalisé

Pour garantir que votre tableau de bord reste efficace :

  • Examiner et mettre à jour régulièrement les sources de données des widgets

  • Archiver ou supprimer les widgets inutilisés

  • Suivre l'utilisation pour identifier les composants précieux

  • Documentez vos personnalisations pour une maintenance plus facile

Ceci est particulièrement important lors des mises à jour de Dolibarr qui peuvent impacter vos modules.

13. Dépannage et débogage

Les problèmes courants lors de l'utilisation de tableaux de bord personnalisés incluent :

  • Les widgets ne s'affichent pas: Vérifiez les erreurs dans la classe du widget ou la configuration du module.

  • Problèmes d'autorisation: Assurez-vous que l'utilisateur dispose des droits nécessaires pour afficher la source de données.

  • Disposition cassée: Inspectez la structure HTML et CSS pour détecter les conflits.

Utilisez les outils de développement du navigateur et les journaux Dolibarr (/dolibarr/documents/dolibarr.log) pour enquêter sur les problèmes.

14. Réflexions finales et meilleures pratiques

Les tableaux de bord personnalisés dans Dolibarr sont une véritable révolution pour les entreprises qui souhaitent optimiser leur efficacité et la visibilité de leurs données. Avec quelques connaissances en développement et une planification stratégique, vous pouvez créer des tableaux de bord qui :

  • Mettez en évidence les données essentielles pour une prise de décision rapide

  • Améliorer la navigation et la convivialité

  • Soutenir les besoins spécifiques du service

Les meilleures pratiques incluent :

  • Commencer par les widgets intégrés avant d'en créer de nouveaux

  • Garder l'interface utilisateur propre et fonctionnelle

  • Mise à jour régulière des widgets en fonction des changements de l'entreprise

La flexibilité de Dolibarr en fait un outil idéal pour tous types d'entreprises. Investir du temps dans des tableaux de bord personnalisés se traduit par une meilleure performance de l'équipe et une meilleure maîtrise de vos opérations.