Dolibarr modules : Guide complet pour débutants

Dolibarr est un ERP / CRM open‑source, facile à mettre en place et très modulaire.
Vous découvrirez ici :
– qu’est‑ce qu’un module,
– comment l’installer, l’activer et le configurer,
– quels modules choisir pour un premier projet,
– et comment créer vos propres modules.

À lire de 30 min minimum, se référer à la documentation officielle : https://wiki.dolibarr.org/index.php/Dolibarr</strong.

1. Le concept de “module”

Termes Différences Utilité
Module core Intégré à l’installation standard Fonctions de base : ventes, achats, comptabilité…
Module externe Téléchargeable depuis le référentiel officiel ou une source tierce Ajout ou extension de fonctionnalités
Module "compatible" Fonctionne avec la version actuelle de Dolibarr Up‑grade sans perte de données

Un module est en gros une collection de fichiers PHP/SQL/Smarty/JS qui joue les rôles supplémentaires dans l’interface ou dans la logique métier.

2. Où trouver les modules ?

Fait Où aller
Modules officiels https://wiki.dolibarr.org/index.php/Dolibarr_modules
Modules tiers https://www.dolibarr.org/modules.php (GitHub, GitLab…)
GitHub officiel Dolibarr https://github.com/Dolibarr
Community forums https://forum.dolibarr.org

Tip : utilisez le catalogue officiel d’abord. Il est audité, stable et compatible avec le dernier release.

3. Préparer son serveur

Assurez‑vous que votre environnement respecte la configuration requise :

Requis Comment vérifier
PHP ≥ 8.0.2 php -v
MySQL / MariaDB 5.7+, 10.3+, 11.x (sans les extensions obsolètes) mysql -V
Apache / Nginx Appliqué httpd -v ou nginx -v
Mémoire ≥ 512 Mo (1 Go recommandé) free -m

Bonnes pratiques : installez Dolibarr dans un virtual host dédié, activez le module mod_rewrite et visez l’HTTPS dès le départ.

4. Installation d’un module

4.1 Utiliser le back‑office (méthode + si vous êtes débutant)

  1. Connectez‑vous à votre instance Dolibarr en tant qu’admin.

  2. Allez dans Tools → Modules/Applications.

  3. En haut de la page, clique sur “Check for updates”. Cela synchronise la liste des modules disponibles.

  4. Recherchez le module désiré (par exemple moduleInvoice).

  5. Cliquez sur "Install". Dolibarr téléchargera et installera le module.

  6. Une fois installé, cliquez sur "Activate".

Astuce : si vous voyez l’option “Install” mais pas “Activate”, le module nécessite d’être lancé manuellement dans un script d’installation.

4.2 En ligne de commande (seuls les avancés)

Pourquoi : Automatisation, versionnage, serveurs sans interface graphique.

# Aller dans le répertoire principal de Dolibarr

cd /var/www/dolibarr
# Tester l’état des modules

./dolibarr.sh status-modules
# Installer depuis le référentiel GitHub

git clone https://github.com/Dolibarr/dolibarr-mod_sale.git modules/sale
# Réinitialiser la base pour créer les tables

./dolibarr.sh upgrade
# Activer le module

./dolibarr.sh activate sale

Remarque : si vous utilisez Composer, vous pouvez gérer les modules via composer require dolibarr-mod_*.

5. Activer / désactiver un module

  Où et comment faire ?
Back‑office Administration → Modules → Cliquez sur l’icône en forme d’engrenage, puis "Activate" ou "Deactivate".
CLI ./dolibarr.sh activate <nom> / ./dolibarr.sh deactivate <nom>
Éditeur de fichiers Modifier le fichier conf.php : $conf_all['module_name']['enabled']=true;

Savoir l’ordre : Certains modules dépendent d’autres. Dolibarr vous avertit.
Exemple : moduleProject nécessite moduleInventory.

6. Configurer un module

Chaque module possède un certain nombre de paramètres accessibles depuis son propre menu :

  1. Ouvrez le module (ex : « Production »).

  2. En haut, cliquez sur Settings (ou l’icône géométrique).

  3. Modifiez les champs : prix de vente, quantités mini–max, autorisations par profil, etc.

Bonnes pratiques :

  • Créez un profil d’utilisateur dédié aux tests (Profil Test).

  • N’ajoutez jamais de paramètres qui ne sont pas nécessaires.

  • Sauvegardez la configuration (utilisez l’option “Export configuration”) pour la récupérer sur une autre instance.

7. Modules incontournables pour débutants

Fonction Module recommandé Pourquoi
Gestion des clients moduleContacts La base CRM de Dolibarr
Vente moduleSales Comptes clients, devis, factures
Achat modulePurchases Suivi des fournisseurs
Comptabilité moduleAccounting Ledger, journals, rapprochement
Projet moduleProjects Planification, affectations
Stock moduleStock Inventaires, mouvements
RH moduleHr Congés, fiches de paie (si vous avez besoin)
Facturation électronique moduleEInvoice Normes e‑facture RGAA

Sélection progressive : commencez par Clients + Factures et ajoutez plus tard (Achats, Stock, Projets).

8. Créer son premier module (mini‑tutoriel)

  1. Structure de base (dans modules/mymodule):

    mymodule/
    
├ config.php    // paramètres globaux
    
├ tree.php      // menu & tree (tree_callback)
    
├ actions.php   // Somearater actions
    
├ lib/
    
│   └ mymodule.lib.php
    
└ static/
    
└ page_mymodule.php

  2. Fichier config.php 

    
<?php
    
/* Nom du module */
    
$module_name = "Mymodule";

/ Version et compatibilité /
$module_version = "0.1";
$competent_versions = array(‘10.0’, ‘10.1’);

/ Définition des hooks /
$module = array(
‘name’ => ‘Mymodule’,
‘version’ => $module_version,
‘description’ => ‘Mon premier module’,
‘sqlinstall’ => ‘mymodule.sql’,
‘depends’ => array(‘moduleBase’)
);



3. **Script d’installation** (`mymodule.sql`)  

```sql

CREATE TABLE IF NOT EXISTS llx_mymodule_item (

  rowid INTEGER AUTO_INCREMENT PRIMARY KEY,

  label VARCHAR(60) NOT NULL,

  qty INTEGER NOT NULL DEFAULT 0,

  fk_user INTEGER,

  datec datetime,

  datem datetime

);

  1. Activation 

    cd /var/www/dolibarr
    
./dolibarr.sh activate mymodule

  2. Développement

    • Ajouter des pages dans static

    • Ajouter des actions dans actions.php

    • Générer des rapports dans lib/.

Astuce : dupliquez d’abord un module déjà présent (ex : moduleSuppliercards) pour servir de squelette.

9. Mises à jour, sauvegarde & restauration

Action Méthode
Mettre à jour un module Administration → Modules → Check for updates. Puis cliquez “Upgrade”
Sauvegarder les données Export → Migrations (DDL & DML). Génère un fichier SQL.
Sauvegarder la configuration Administration → Configuration → Export.
Restauration Importer le fichier SQL dans phpMyAdmin ou via CLI.

Éviter le “merge” : ne combinez jamais deux sauvegardes manuellement. Utilisez la fonction “Import” de Dolibarr.

10. Résoudre les problèmes fréquents

Problème Cause Solution
Module ne s’installe pas Incompatible PHP / MySQL Mettre à jour les extensions, recompilez l’arborescence des modules ./dolibarr.sh update-modules
Erreur de « failed to connect to database » Mauvais credentials Vérifiez conf/conf.php + le fichier localconfig.inc.php
Messages « module non fonctionnel » Fichier manquant ou permissions Vérifiez droits 755 sur modules/ + chmod +x les scripts 
Module ne s’affiche pas dans le menu Profil utilisateur restreint Ajoutez l’option dans le profil et assurez‑vous que le module est activé

Conseil : consultez le fichier dolibarr/logs/dolibarr.log pour des traces d’erreur détaillées.

11. Ressources, communautés & formation

Suggéré : suivez le canal #dolibarr sur Discord/Matrix pour des réponses immédiates.

12. Réflexion finale

Dolibarr offre une architecture réellement modulaire. Vous pouvez :

  • Commencer avec un minimum : Clients → Factures

  • Évoluer : ajouter des modules à chaque étape pour optimiser votre flux

  • Personnaliser : créer vos propres modules lorsque la logique métier dépasse les possibilités de la base

La clé : gardez toujours une copie de sauvegarde avant chaque mise à jour ou ajout majeur, et testez les nouveaux modules dans un environnement de staging.

Bonne installation ! 🚀

Publications similaires