02. INSTALLATION ET ACTIVATION

• Installation et activation

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
   htdocs/custom/infrasfiles
3. OU utilisez l'outil de déploiement des modules externes de Dolibarr (Accueil > Configuration > Modules/Applications > Déployer un module externe)

3.ACTIVATION

1. Connectez-vous en tant qu'administrateur
2. Allez dans : Accueil > Configuration > 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 > Emails > 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.

IMPÉRATIF : Après toute mise à jour du module, vous DEVEZ : Désactiver le module / Réactiver le module.

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 > Configuration > Modules/Applications > Documents et emails > icône Configurer
• Outils > InfraS > 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.