Comment intégrer un module personnalisé dans Dolibarr ?
   03/06/2025 00:00:00     Dolibarr    0 Commentaires
Comment intégrer un module personnalisé dans Dolibarr ?

Dolibarr est une solution ERP et CRM open-source qui se distingue par sa flexibilité et sa modularité. Grâce à son architecture, il est possible d’ajouter des fonctionnalités spécifiques en développant des modules personnalisés. Que ce soit pour répondre à des besoins métier précis, automatiser certaines tâches ou améliorer l’expérience utilisateur, l’intégration d’un module personnalisé dans Dolibarr est une solution idéale.

Dans cet article, nous allons voir étape par étape comment intégrer un module personnalisé dans Dolibarr, de sa conception à son installation, en passant par le développement et la configuration.

1. Pourquoi créer un module personnalisé pour Dolibarr ?

Dolibarr propose une large gamme de modules natifs et des extensions disponibles sur le Dolistore. Cependant, il arrive que ces solutions ne couvrent pas entièrement les besoins spécifiques d’une entreprise. Voici quelques raisons de créer un module personnalisé :

  • Automatiser des processus internes spécifiques à votre activité.
  • Ajouter de nouvelles fonctionnalités non disponibles dans Dolibarr ou dans les modules existants.
  • Modifier ou améliorer l’interface utilisateur pour optimiser l’ergonomie.
  • Créer des connecteurs avec d’autres applications utilisées dans l’entreprise.
  • Personnaliser les rapports et tableaux de bord pour un suivi plus adapté.

2. Prérequis avant d’intégrer un module personnalisé

Avant de commencer l’intégration, il est important de s’assurer que votre environnement Dolibarr est prêt à accueillir un nouveau module.

2.1 Vérifier la version de Dolibarr

Chaque module doit être compatible avec la version installée de Dolibarr. Pour vérifier votre version :

  1. Connectez-vous à Dolibarr en tant qu’administrateur.
  2. Allez dans Accueil → Configuration → Informations système.

Assurez-vous que votre module est bien compatible avec cette version.

2.2 Activer le mode développeur

Dolibarr propose un mode développeur permettant d’afficher des erreurs et de faciliter le débogage :

  1. Accédez à Configuration → Divers.
  2. Ajoutez la ligne suivante dans le fichier conf/conf.php :
    php
    $dolibarr_main_prod = 0;

2.3 Accéder au dossier des modules

Tous les modules Dolibarr sont stockés dans le dossier :

bash
htdocs/custom/

Il est recommandé de créer vos propres modules dans ce dossier pour éviter d’écraser des fichiers natifs lors des mises à jour.

3. Développer un module personnalisé pour Dolibarr

Un module Dolibarr est constitué principalement de fichiers PHP et de structures spécifiques.

3.1 Créer la structure du module

Un module Dolibarr est organisé comme suit :

bash
htdocs/custom/mymodule/ │── core/ │ ├── modules/ │── class/ │── admin/ │── script/ │── mymodule.php │── README.md │── modulebuilder.json

Explication des répertoires :

  • core/modules/ : Contient les fichiers de configuration du module.
  • class/ : Définit les classes PHP utilisées par le module.
  • admin/ : Interface d’administration du module.
  • script/ : Scripts supplémentaires pour installation ou mise à jour.

3.2 Créer le fichier de configuration du module

Le fichier principal du module (mymodule.php) permet à Dolibarr de reconnaître le module :

php
class modMymodule extends DolibarrModules { function __construct($db) { global $langs; $this->db = $db; $this->numero = 500000; $this->family = "custom"; $this->name = "Mymodule"; $this->description = "Un module personnalisé pour Dolibarr"; $this->version = "1.0"; $this->rights_class = 'mymodule'; } }

3.3 Ajouter une table SQL pour stocker des données

Si votre module doit stocker des informations spécifiques, créez une table SQL :

sql
CREATE TABLE llx_mymodule ( rowid INT AUTO_INCREMENT PRIMARY KEY, label VARCHAR(255) NOT NULL, date_creation TIMESTAMP DEFAULT CURRENT_TIMESTAMP ) ENGINE=InnoDB;

Le script SQL peut être placé dans script/install.sql et exécuté à l’activation du module.

4. Installer et activer le module dans Dolibarr

Une fois votre module développé, il faut l’intégrer à Dolibarr.

4.1 Copier le module dans Dolibarr

Placez le dossier de votre module dans :

bash
htdocs/custom/

4.2 Activer le module depuis l’administration

  1. Allez dans Configuration → Modules/Applications.
  2. Recherchez votre module dans la liste.
  3. Cliquez sur Activer.
  4. Si nécessaire, exécutez les scripts SQL associés.

5. Tester et déboguer votre module

5.1 Vérifier les journaux d’erreurs

Si votre module ne fonctionne pas correctement, consultez les logs de Dolibarr dans :

bash
htdocs/documents/dolibarr.log

5.2 Activer le mode débogage PHP

Ajoutez cette ligne dans conf/conf.php pour afficher les erreurs :

php
ini_set('display_errors', 1); error_reporting(E_ALL);

5.3 Effectuer des tests utilisateurs

  • Vérifiez si les permissions fonctionnent correctement.
  • Testez l’interface et les formulaires du module.
  • Vérifiez la compatibilité avec d’autres modules actifs.

6. Distribuer et maintenir votre module

Si vous souhaitez partager votre module avec la communauté, vous pouvez :

  • Le publier sur Dolistore (la marketplace des modules Dolibarr).
  • Mettre à disposition le code sur GitHub/GitLab pour des mises à jour collaboratives.
  • Assurer la compatibilité avec les nouvelles versions de Dolibarr en testant régulièrement le module.

Conclusion

L’intégration d’un module personnalisé dans Dolibarr permet d’adapter l’ERP à des besoins spécifiques et d’ajouter des fonctionnalités sur mesure. En suivant ces étapes – depuis la création du module, sa configuration, son installation et son test – vous pourrez facilement enrichir votre Dolibarr sans altérer son cœur.

Avec un peu de développement PHP et de rigueur dans la gestion des mises à jour, vous pourrez optimiser votre gestion d’entreprise en intégrant des fonctionnalités entièrement adaptées à vos besoins.

Avez-vous déjà intégré un module personnalisé dans Dolibarr ? Partagez votre expérience dans les commentaires !

Commentaires

Connectez-vous ou inscrivez-vous pour poster des commentaires