---
title: "Installation"
weight: 10
description: "Installer, activer et mettre à jour le module SmartDLC dans Dolibarr."
---

# Installation

## Prérequis

Avant d'installer SmartDLC, vérifiez que votre instance répond aux conditions suivantes :

- Dolibarr 18.0 ou supérieur
- PHP 7.4 ou supérieur
- Le répertoire des modules externes est actif (Accueil > Configuration > Modules doit proposer l'onglet "Déployer/Installer un module externe")

## Téléchargement

Le module est distribué sous forme d'archive ZIP. Vous l'obtenez depuis le [DoliStore](https://www.dolistore.com) ou depuis la [boutique CAP-REL](https://shop.cap-rel.fr).

## Installation

1. Connectez-vous à Dolibarr avec un compte administrateur.
2. Rendez-vous dans **Accueil > Configuration > Modules/Applications**.
3. Ouvrez l'onglet **Déployer/Installer un module externe**.
4. Sélectionnez l'archive ZIP de SmartDLC et envoyez-la.

![Onglet de déploiement d'un module externe avec l'archive SmartDLC selectionnee](screenshots/deploiement-module.webp)

## Activation

1. Toujours dans **Accueil > Configuration > Modules/Applications**, recherchez **SmartDlc** dans la liste.
2. Cliquez sur l'interrupteur pour activer le module.

SmartDLC dépend de plusieurs modules natifs de Dolibarr. Ils sont activés automatiquement s'ils ne le sont pas déjà :

| Module | Rôle dans SmartDLC |
|---|---|
| Tiers | Fournisseurs rattachés aux produits suivis |
| Produits et Services | Référentiel produit |
| Fournisseurs et Réceptions | Traçabilité à la réception des marchandises |
| Ressources | Réfrigérateurs et congélateurs |
| Agenda | Événements liés aux contrôles |
| GED | Stockage des photos d'étiquettes |
| Factures | Rattachement commercial |
| Travaux planifiés | Traitement différé de la lecture d'étiquettes |

![Fiche du module SmartDlc activee dans la liste des modules Dolibarr](screenshots/activation-module.webp)

## Vérification après installation

Contrôlez les points suivants :

- Un menu **SmartDLC** apparaît dans le menu de gauche de la section **Outils**, avec les entrées **DLC** et **Relevés de températures**.
- Le dictionnaire **DLC** est disponible dans **Accueil > Configuration > Dictionnaires**.
- La page de configuration du module est accessible depuis l'icône d'engrenage en face de SmartDlc dans la liste des modules.

Si le menu n'apparaît pas, vérifiez que votre utilisateur dispose du droit de lecture SmartDLC (voir la section Permissions de la page [Configuration](/smartdlc/configuration)).

## Mise à jour

1. Déployez la nouvelle archive comme lors de la première installation : elle remplace les fichiers existants.
2. **Désactivez puis réactivez le module** depuis **Accueil > Configuration > Modules/Applications**.

Cette étape n'est pas optionnelle : c'est à la réactivation que le module applique les évolutions de base de données, réenregistre ses menus et ses permissions, et applique les corrections prévues pour les anciennes installations.

Si une version plus récente que la vôtre est disponible, un message d'avertissement vous le signale au moment de la réactivation.

## Désinstallation

Désactivez le module depuis **Accueil > Configuration > Modules/Applications**.

Les données saisies (DLC, relevés de température, contrôles HACCP) restent en base : réactiver le module les rend de nouveau accessibles. Les répertoires de documents ne sont pas supprimés.
