---
title: "Installation"
weight: 10
description: "Guide d'installation, mise à jour et désinstallation du module DoliScubaDiving."
---

# Installation

## Téléchargement

Le module DoliScubaDiving est disponible sur le DoliStore. Rendez-vous sur la fiche du module pour télécharger la dernière version au format ZIP.

<!-- TODO: lien DoliStore à confirmer -->

## Installation dans Dolibarr

1. Connectez-vous à votre Dolibarr en tant qu'administrateur.
2. Rendez-vous dans **Accueil > Configuration > Modules/Applications**.
3. Cliquez sur **Déployer/Installer un module externe**.
4. Sélectionnez le fichier ZIP téléchargé et validez l'envoi.

![Page de déploiement d'un module externe dans Dolibarr](screenshots/deploiement-module.webp)

Dolibarr extrait automatiquement les fichiers dans le répertoire approprié.

## Activation

1. Rendez-vous dans **Accueil > Configuration > Modules/Applications**.
2. Recherchez "DoliScubaDiving" dans la liste des modules ou filtrez par la catégorie "Autre".
3. Cliquez sur le bouton d'activation (interrupteur ou bouton "Activer").

![Activation du module DoliScubaDiving dans la liste des modules](screenshots/activation-module.webp)

> **Attention :** DoliScubaDiving nécessite l'activation préalable de plusieurs modules Dolibarr (Agenda, Catégories, Commandes, Factures, Emailing, Marges, Produits, Ressources, Services, Stock, TakePos, Tiers). Si l'un d'entre eux est manquant, Dolibarr vous en informera lors de l'activation.

## Vérification post-installation

Après activation, vérifiez les points suivants :

1. **Menu principal** : une entrée "Diving" ou "DoliScubaDiving" apparaît dans le menu de gauche de Dolibarr.
2. **Page de configuration** : cliquez sur l'icône d'engrenage à côté du module pour accéder à la page de configuration. Vérifiez que celle-ci s'affiche sans erreur.
3. **Permissions** : rendez-vous dans **Accueil > Configuration > Utilisateurs & Groupes** et vérifiez que les nouvelles permissions DoliScubaDiving sont visibles (sorties, fiches de sécurité, réservations, gonflage, bateaux, etc.).

![Page de configuration principale après activation du module](screenshots/verification-post-installation.webp)

## Mise à jour

Pour mettre à jour le module vers une nouvelle version :

1. Téléchargez la nouvelle version depuis le DoliStore.
2. Rendez-vous dans **Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe**.
3. Envoyez le nouveau fichier ZIP (les fichiers existants sont remplacés automatiquement).
4. **Désactivez puis réactivez** le module depuis la liste des modules.

> **Important :** l'étape de désactivation/réactivation est indispensable. Elle déclenche la mise à jour des tables de base de données et l'enregistrement des nouveaux hooks, permissions et menus.

## Désinstallation

Pour désinstaller le module :

1. Rendez-vous dans **Accueil > Configuration > Modules/Applications**.
2. Recherchez "DoliScubaDiving" dans la liste.
3. Cliquez sur le bouton de désactivation.

La désactivation supprime les entrées de menu et les permissions associées. Les données créées par le module (sorties, fiches de sécurité, gonflages, etc.) restent en base de données et seront à nouveau disponibles si vous réactivez le module.