Installation et mise à jour

• Une installation Dolibarr en version 19.0 ou ultérieure. La version s’affiche dans AccueilÀ propos, et en bas de chaque page.
• PHP 7.4 ou ultérieur, la version minimale déclarée par les sixdescripteurs.
• Le dossier des modules externes, htdocs/custom/, présent et accessible en écriture si vous passez par l’interface.
• Le module Dolibarr dont dépend le module installé — Propositions commercialesou Tiers selon les cas. Chaque fiche l’indique.
• Un compte administrateur, le temps de l’activation.

C’est le chemin le plus court, et celui à essayer en premier.

1. Téléchargez le fichier zip du module depuis le DoliStore, sur votre poste.
2. Dans Dolibarr, ouvrez AccueilConfigurationModules/Applications.
3. Ouvrez l’onglet « Déployer/installer un module externe », choisissez le zip et envoyez-le. Dolibarr décompresse lui-même dans htdocs/custom/.
4. Le module apparaît dans la liste. Activez-le avec l’interrupteur de sa ligne.

Si cet onglet est absent ou si l’envoi échoue, l’envoi de modules a été désactivé sur cette installation, ou le dossier custom n’est pas accessible en écriture. Passez alors par le fichier.

Pour un hébergement mutualisé où l’envoi par l’interface est bloqué, ou pour un serveur auquel vous accédez en SSH.

1. Décompressez le zip sur votre poste.
2. Envoyez le dossier obtenu dans htdocs/custom/, sans le renommer. Vous devez obtenir par exemple htdocs/custom/dolixmasse/core/modules/…, et non htdocs/custom/dolixmasse/dolixmasse/….
3. Vérifiez que les fichiers sont lisibles par le compte du serveur web. Après un envoi par FTP, c’est la vérification qui règle la plupart des cas.
4. Rechargez AccueilConfigurationModules/Applications: le module figure dans la liste. Activez-le.

L’activation crée ce que le module a besoin de créer — sa table d’historique quand il en a une, son attribut supplémentaire quand il en pose un. Elle n’efface rien.

Les droits se donnent ensuite dans AccueilUtilisateurs & Groupes, sur l’onglet des permissions de l’utilisateur ou du groupe concerné.

1. Récupérez la nouvelle version sur le DoliStore.
2. Désactivez le module dans la liste des modules. La désactivation ne supprime aucune donnée : ni les tables, ni les réglages, ni les valeurs saisies.
3. Remplacez le dossier du module dans htdocs/custom/ par le nouveau, ou renvoyez le zip par l’onglet de déploiement.
4. Réactivez le module. Les réglages et l’historique sont retrouvés tels quels.

Le journal des versions de chaque fiche est repris du fichier ChangeLog.md livré dans le module : il n’y a pas deux histoires possibles.

Désactiver un module fait disparaître ses écrans et ses colonnes. Ce qu’il a écrit en base, lui, reste — c’est un choix, pour qu’une désactivation par erreur ne détruise rien. Voici, module par module, ce que cela recouvre.

Cinq vérifications, dans cet ordre. Elles couvrent l’essentiel des cas.

1. Le dossier est-il au bon endroit ? Le dossier du module doit se trouver directement dans htdocs/custom/, et porter exactement son nom technique — celui indiqué sur sa fiche. Un dossier imbriqué deux fois (custom/dolixmasse/dolixmasse) est la cause la plus fréquente.
2. Le serveur web peut-il lire les fichiers ? Après une décompression par FTP ou par SSH, les fichiers appartiennent parfois à un autre compte que celui du serveur web. Le module reste alors invisible dans la liste.
3. La version de Dolibarr est-elle suffisante ? Les six modules exigent Dolibarr 19.0 au minimum et PHP 7.4 au minimum. La version de Dolibarr s’affiche dans AccueilÀ propos.
4. Le module dont il dépend est-il activé ? Chaque fiche indique le module Dolibarr à activer d’abord — Propositions commerciales, Tiers, selon les cas. Sans lui, l’écran attendu n’apparaît pas.
5. Les droits ont-ils été attribués ? Un module activé mais sans droit attribué reste invisible pour l’utilisateur. Les droits se donnent dans AccueilUtilisateurs & Groupes, onglet des permissions.