Dolibarr est un ERP et CRM open-source qui permet aux entreprises de gérer efficacement leurs activités administratives, comptables et commerciales. L’un des atouts majeurs de Dolibarr est sa modularité, qui permet d’ajouter des fonctionnalités supplémentaires selon les besoins de l’entreprise.
Que ce soit pour la gestion des factures, des stocks, des projets ou des ressources humaines, il est possible d'installer et de configurer des modules pour personnaliser l’expérience utilisateur et optimiser la gestion d’entreprise.
Dans cet article, nous allons voir étape par étape comment installer et configurer un module sur Dolibarr, en expliquant les différentes méthodes d’installation, les réglages essentiels et les bonnes pratiques pour assurer un bon fonctionnement du module.
1. Où trouver des modules pour Dolibarr ?
Dolibarr propose plusieurs sources pour télécharger des modules :
- Modules natifs : Certains modules sont déjà inclus dans Dolibarr et doivent simplement être activés.
- Dolistore : La boutique officielle de Dolibarr propose une large gamme de modules gratuits et payants pour ajouter de nouvelles fonctionnalités.
- Marketplaces alternatives : Certains développeurs proposent leurs modules sur d'autres plateformes comme GitHub, GitLab, DolibarrStore et Dolimarketplace.
- Développement interne : Pour les entreprises ayant des besoins spécifiques, il est possible de créer et d’installer un module personnalisé.
Avant d’installer un module, il est important de vérifier qu’il est compatible avec la version de Dolibarr utilisée.
2. Méthodes d’installation d’un module sur Dolibarr
Il existe trois principales méthodes pour installer un module sur Dolibarr :
2.1 Installation via l’interface de Dolibarr
Si le module provient de Dolistore ou d’une source officielle, il est possible de l’installer directement depuis l’interface de Dolibarr :
- Accédez à l'administration de Dolibarr.
- Allez dans "Accueil" → "Configuration" → "Modules/Applications".
- Cliquez sur "Ajouter un module externe".
- Téléchargez le fichier ZIP du module.
- Cliquez sur "Téléverser" et laissez Dolibarr installer le module.
Une fois installé, le module apparaîtra dans la liste des modules disponibles.
2.2 Installation manuelle via FTP ou SSH
Si vous avez obtenu un module en dehors de Dolistore (via GitHub ou un développeur tiers), vous devrez l’installer manuellement :
- Téléchargez le fichier ZIP du module.
- Décompressez le fichier sur votre ordinateur.
- Transférez le dossier du module dans le répertoire suivant de Dolibarr :
- Assurez-vous que les permissions des fichiers sont bien définies :
- Accédez à Dolibarr, puis allez dans "Modules/Applications", et le module devrait apparaître dans la liste.
2.3 Installation via Git
Si vous souhaitez installer un module directement depuis un dépôt Git (utile pour les mises à jour automatiques), suivez ces étapes :
- Connectez-vous à votre serveur en SSH.
- Placez-vous dans le répertoire htdocs/custom/ :
- Clonez le module depuis GitHub ou GitLab :
- Changez les permissions du dossier :
- Le module apparaîtra automatiquement dans Dolibarr sous "Modules/Applications".
3. Activer un module dans Dolibarr
Une fois le module installé, il faut l’activer pour qu’il puisse être utilisé :
- Allez dans "Accueil" → "Configuration" → "Modules/Applications".
- Trouvez votre module dans la liste des modules installés.
- Cliquez sur le bouton "Activer".
- Si nécessaire, suivez les instructions d’installation supplémentaires fournies par le module.
Certaines extensions nécessitent l’exécution d’un script SQL pour créer des tables dans la base de données. Dolibarr affichera un message si cela est nécessaire.
4. Configurer un module après installation
Chaque module peut contenir des paramètres spécifiques qui doivent être configurés selon vos besoins.
-
Accédez aux paramètres du module
- Après activation, cliquez sur "Configurer" à côté du module.
- Définissez les paramètres selon les options disponibles.
-
Gérer les permissions des utilisateurs
- Allez dans "Accueil" → "Utilisateurs et groupes".
- Attribuez les droits d’accès aux utilisateurs pour qu’ils puissent utiliser le module.
-
Tester le module
- Effectuez des tests pour vérifier que toutes les fonctionnalités fonctionnent correctement.
- Consultez les journaux de Dolibarr en cas d’erreurs :
5. Mettre à jour ou désinstaller un module
5.1 Mettre à jour un module
Si une nouvelle version du module est disponible, suivez ces étapes :
- Via l’interface de Dolibarr : Téléchargez la nouvelle version et réinstallez le module.
- Via FTP/Git : Remplacez les fichiers existants dans htdocs/custom/ et vérifiez les mises à jour SQL si nécessaire.
Avant toute mise à jour, pensez à faire une sauvegarde de votre Dolibarr.
5.2 Désinstaller un module
Si un module ne vous convient plus, vous pouvez le désinstaller :
- Désactivez le module dans "Modules/Applications".
- Supprimez son dossier dans htdocs/custom/.
- Supprimez les tables associées dans la base de données si nécessaire (avec prudence).
6. Bonnes pratiques pour l’installation des modules Dolibarr
- Toujours vérifier la compatibilité du module avec votre version de Dolibarr.
- Tester le module sur un environnement de test avant de l’installer en production.
- Faire une sauvegarde complète avant toute installation ou mise à jour.
- Ne jamais modifier le code source des modules natifs pour éviter des conflits lors des mises à jour.
- Utiliser des modules provenant de sources fiables comme Dolistore, GitHub, DolibarrStore ou Dolimarketplace.
Conclusion
L’installation et la configuration d’un module sur Dolibarr permettent d’étendre les fonctionnalités de l’ERP et d’adapter l’outil aux besoins spécifiques de chaque entreprise. Grâce à ce guide, vous pouvez désormais télécharger, installer, activer et configurer vos modules en toute simplicité.
Que ce soit pour la gestion commerciale, la facturation, les stocks ou les projets, les modules Dolibarr vous offrent une personnalisation avancée et une meilleure gestion de votre entreprise.
Avez-vous déjà installé un module sur Dolibarr ? Partagez votre expérience en commentaire !