# 2. INSTALLATION ET ACTIVATION

# Installation et activation

L'installation du module est une opération technique qui doit être réalisée par un administrateur, généralement avec l'aide de votre prestataire informatique. Le module se télécharge depuis le **DoliStore** ou depuis l'espace client **CAP-REL**, puis se copie dans le répertoire des modules externes de ***Dolibarr***.

Les dépendances du module doivent ensuite être installées avec l'outil **Composer**, par la commande suivante exécutée dans le dossier du module :

```bash
cd htdocs/custom/uptosign
composer install --no-dev
```

<p class="callout info">**Attention —**<span style="color: rgb(1, 178, 210);"> </span>Si cette étape n'est pas réalisée, le module affiche un message d'erreur sur sa page de configuration.</p>

### **Prérequis** 

Avant d'activer le module, il convient de vérifier que les extensions PHP nécessaires sont bien installées, et que le module **ECM** de ***Dolibarr*** est activé, puisqu'UptoSign en dépend pour le stockage des fichiers joints.

Le module vérifie également que la configuration de sécurité de ***Dolibarr*** est correctement en place, c'est-à-dire que le système de chiffrement des mots de passe et les clés de sécurité sont configurés ; dans le cas contraire, un avertissement est affiché et l'accès à la configuration du module est bloqué.

<table id="bkmrk-extensionusageintlin"><colgroup><col style="width: 252px;"></col><col style="width: 853px;"></col></colgroup><tbody><tr><th style="background-color: rgb(13, 142, 167); color: rgb(255, 255, 255);">Extension

</th><th style="background-color: rgb(13, 142, 167); color: rgb(255, 255, 255);">Usage

</th></tr><tr><td>intl

</td><td>Internationalisation et formatage

</td></tr><tr style="background-color: rgb(196, 230, 236);"><td>fileinfo

</td><td>Détection du type MIME des fichiers

</td></tr><tr><td>gd

</td><td>Manipulation d'images

</td></tr><tr style="background-color: rgb(196, 230, 236);"><td>mbstring

</td><td>Gestion des chaînes de caractères multi-octets

</td></tr></tbody></table>

### **Activer le module**

Pour activer le module :

1. Connectez-vous en tant qu'administrateur ***Dolibarr*** ;
2. Rendez-vous dans *Accueil &gt; Configuration &gt; Modules/Applications* ;
3. Recherchez **« UptoSign »** dans la liste ;
4. Cliquez sur le bouton d'activation.

Le module crée alors automatiquement les tables dont il a besoin dans la base de données.

### **Paramétrage initial**

Après l'activation, rendez-vous dans *Accueil &gt; Configuration &gt; Modules &gt; UptoSign* pour effectuer le paramétrage initial. Les étapes minimales pour démarrer sont les suivantes :

1. Configurer le serveur et les identifiants dans l'onglet **Serveur** ;
2. Définir l'utilisateur par défaut dans l'onglet **Paramètres** ;
3. Créer une configuration de document dans l'onglet **Modèles de documents**, en associant un modèle de document PDF à un type d'objet ***Dolibarr***.

### **Mettre à jour le module**

Pour mettre à jour le module vers une nouvelle version, il faut remplacer le dossier du module par la nouvelle version, relancer la commande Composer, puis se reconnecter à ***Dolibarr*** : les mises à jour de la base de données sont alors appliquées automatiquement.

<p class="callout info">**À noter —** Si un message signale une incohérence de version après une mise à jour, il suffit de désactiver puis de réactiver le module.</p>