# Installation et activation

#### **1.PRÉREQUIS**

- ***Dolibarr*** version **18.0.0 minimum**, jusqu'à la version 24. En dessous de la version 18, le module se désactive de lui-même ; au-delà de la version 24, un avertissement s'affiche à la connexion mais le module reste utilisable, sans garantie.
- PHP 7.4 à 8.4, avec l'extension *xml* chargée (nécessaire à la lecture du changelog).
- Au moins un des modules natifs concernés doit être activé pour que le document correspondant soit disponible : **Prélèvement** ou **Virement** (paiement par virement) pour les bons, **Stock** pour les inventaires. Sans le module natif, la ligne du document apparaît grisée dans les paramètres.

#### **2.INSTALLATION**

1. Téléchargez le module depuis le Dolistore ou le site InfraS
2. Décompressez l'archive dans le dossier « custom » de votre installation ***Dolibarr***  
    `<span class="editor-theme-code">htdocs/custom/infrasfiles</span>`
3. **OU** utilisez l'outil de déploiement des modules externes de ***Dolibarr*** (***Accueil &gt; Configuration &gt; Modules/Applications &gt; Déployer un module externe***)

#### **3.ACTIVATION**

1. Connectez-vous en tant qu'administrateur
2. Allez dans : ***Accueil &gt; Configuration &gt; Modules/Applications***
3. Recherchez « **Documents et emails** » (famille *Modules InfraS*)
4. Cliquez sur le bouton **« Activer »** (ON/OFF)
5. Cliquez ensuite sur l'icône de configuration pour ouvrir la page des paramètres

***Ce que fait l'activation***

Lors de l'activation, le module prépare automatiquement tout ce dont il a besoin, sans rien modifier aux tables natives :

- Création de sa table de suivi documentaire (dernier modèle et dernier fichier générés par objet).
- Création des répertoires de données `documents/infrasfiles/widthdraw` et `documents/infrasfiles/inventory`.
- Création, sur les fiches **tiers**, de l'attribut supplémentaire « Adresser les bordereaux de prélèvement / virement à la maison mère » (case à cocher, visible tant que le module est actif). Il sert au découpage des PDF par maison mère (voir le chapitre *Bons de prélèvement et de virement*).
- Création d'un **modèle d'email par défaut** pour chaque document (visible dans *Configuration &gt; Emails &gt; Modèles d'emails*), dans la langue de l'utilisateur qui active le module. Un modèle déjà présent n'est jamais écrasé.
- Déclaration des **événements automatiques d'agenda** « Bon de prélèvement / virement envoyé par email » et « Inventaire envoyé par email ».
- Restauration automatique des paramètres sauvegardés lors d'une précédente désactivation.

<p class="callout warning">**IMPÉRATIF :** Après toute mise à jour du module, vous **DEVEZ** : **Désactiver** le module / **Réactiver** le module.</p>

Cette opération est nécessaire pour appliquer les modifications de structure (table, attribut, modèles de mails, événements) nécessaires au bon fonctionnement de la nouvelle version. Les paramètres sont sauvegardés automatiquement à la désactivation et restaurés à la réactivation : rien n'est perdu.

#### **4.DÉSACTIVATION**

À la désactivation, le module **sauvegarde** l'ensemble de ses paramètres puis les retire de la configuration. Les fichiers PDF déjà générés, l'attribut « maison mère » des tiers et les modèles d'emails sont conservés : ils seront de nouveau utilisables dès la réactivation.

#### **5.ACCÈS AU MODULE**

Une fois activé, le module est accessible depuis deux endroits :

- ***Accueil &gt; Configuration &gt; Modules/Applications &gt; Documents et emails &gt; icône Configurer***
- ***Outils &gt; InfraS &gt; InfraSFiles***, avec deux entrées : **Changelog / Support** et **Paramètres InfraS**

La page d'administration comporte trois onglets : **Paramètres InfraS**, **À propos** et **Changelog / Support**.