Guide installation de module/Guide installation de module

Installation initiale

Depuis la version 6.0 de Dolibarr, une nouvelle interface est disponible pour l'installation des modules externes :

Installer un module externe

Pour les versions antérieures de Dolibarr ou en alternative à cette première solution d'installation, vous pouvez suivre le process suivant :

• Télécharger le fichier archive du module (.zip) depuis le site web DoliStore.com.

• Décompresser le fichier .zip en le plaçant dans le répertoire racine de Dolibarr. Attention, pour les modules de type "pack" (GPAO, BTP, etc...), il faut copier le contenu du répertoire /monpackmodule/htdocs qui se trouve à l'intérieur du zip.

Exemple, pour le pack btp il faut télécharger le zip et copier le contenu (la liste des modules du pack) du répertoire /btp/htdocs du zip à la racine de Dolibarr

• Toujours vérifier les autres opérations d'installation dans le fichier README-FR.

Remarque : L’installation du module nécessite la présence d’un dossier « custom » dans le dossier « htdocs ».

• Le répertoire « custom », initialement, a été créé pour différencier les modules natifs de Dolibarr des modules ajoutés par les utilisateurs. Tous les modules additionnels n’utilisent pas ce répertoire et peuvent être installés dans le répertoire racine. Dans le cas où le répertoire « custom » est nécessaire pour le déploiement de modules, suivre la procédure suivante :

• Attention : la réalisation de la procédure suivante nécessite des compétences en programmation malgré la simplicité de la procédure expliquée ci-après.

• Dans votre répertoire d'installation de Dolibarr ouvrir le fichier htdocs/conf/conf.php.

• Trouver les lignes :

  //$dolibarr_main_url_root_alt=… et //$dolibarr_main_document_root_alt=…

Ou

  #$dolibarr_main_url_root_alt=… et #$dolibarr_main_document_root_alt=…

• Supprimez les "//" (ou le "#") de ces lignes et affectez une valeur cohérente par rapport à votre installation de Dolibarr en vous référant aux lignes :

$dolibarr_main_url_root=… et $dolibarr_main_document_root=…

• Par exemple pour un système UNIX/Linux/MacOS X, à partir de Dolibarr 3.5 :

$dolibarr_main_url_root = 'http://localhost/Dolibarr/htdocs';

$dolibarr_main_document_root = '/var/www/Dolibarr/htdocs';

$dolibarr_main_url_root_alt = '/custom';

$dolibarr_main_document_root_alt = '/var/www/Dolibarr/htdocs/custom';

• Par exemple pour un système Microsoft Windows, à partir de Dolibarr 3.5 :

$dolibarr_main_url_root = 'http://localhost/Dolibarr/htdocs';

$dolibarr_main_document_root = 'C:/votre_site /Dolibarr/htdocs';

$dolibarr_main_url_root_alt = '/custom';

$dolibarr_main_document_root_alt = 'C:/votre_sites/Dolibarr/htdocs/custom';

Installation de mise à jour

• Télécharger le fichier archive du module (.zip) depuis le site web DoliStore.com.
• Désactiver le module de l’environnement Dolibarr à mettre à jour.
• Décompresser le fichier archive (.zip) contenant la nouvelle version dans le dossier « \htdocs\nomdumodule ».
• Rafraîchir la page de configuration des modules dans le navigateur.
• Réactiver le module mis à jour.

Activation

• L’activation du module, qu’elle soit initiale ou de mise à jour, se fait en cliquant sur l’icône à droite en bout de ligne dans la page de configuration des modules : accueil/ configuration/ modules/
• Il est parfois nécessaire de répéter l’opération de désactivation/ réactivation afin de s’assurer de la bonne installation d’un module.