---
title: "Installation"
weight: 10
description: "Guide d'installation du module OfflinePropale et de l'application mobile PWA."
---

# Installation

## Prérequis

Avant d'installer OfflinePropale, vérifiez que les éléments suivants sont en place :

- Dolibarr version 18.0 ou supérieure
- PHP 7.4 ou supérieur
- Les modules Dolibarr suivants doivent être activés :
  - Tiers
  - Propositions commerciales
  - Produits / Services
  - Catégories
  - Gestion de documents (ECM)
  - SmartAuth (pour l'authentification API)

## Téléchargement

Rendez-vous sur le DoliStore pour télécharger le module OfflinePropale.

## Installation du module

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

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

## Activation du module

1. Accédez à **Accueil > Configuration > Modules/Applications**
2. Recherchez "OfflinePropale" dans la liste des modules
3. Cliquez sur le bouton d'activation (interrupteur ON/OFF)

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

Les tables de base de données sont créées automatiquement à l'activation. Un nouveau menu **Pré-devis offline** apparaît dans le menu **Commercial > Propositions commerciales**.

## Vérification post-installation

Après activation, vérifiez que :

- Le menu **Commercial > Propositions commerciales > Pré-devis offline** est accessible
- La page de configuration est accessible via l'icône d'engrenage à côté du module

![Menu Pré-devis offline dans le menu Commercial de Dolibarr](screenshots/menu-predevis.webp)

## Installation de l'application mobile

L'application mobile est une PWA (Progressive Web App). Elle s'installe directement depuis le navigateur, sans store.

L'URL de l'application dépend de votre configuration :

- **Hébergement direct** : `https://votre-dolibarr.com/custom/offlinepropale/pwa/`
- **Via DoliProxy** : l'URL est fournie lors du provisionnement (voir [Configuration](/offlinepropale/configuration))

### Sur smartphone Android (Chrome)

1. Ouvrez l'URL de l'application dans Chrome
2. Un bandeau "Ajouter à l'écran d'accueil" apparaît automatiquement
3. Appuyez sur **Installer**
4. L'application s'ajoute à votre écran d'accueil comme une application native

![Bandeau d'installation PWA sur Android avec le bouton Installer](screenshots/installation-android.webp)

### Sur iPhone / iPad (Safari)

1. Ouvrez l'URL de l'application dans Safari
2. Appuyez sur le bouton de partage (carré avec flèche vers le haut)
3. Sélectionnez **Sur l'écran d'accueil**
4. Validez le nom et appuyez sur **Ajouter**

![Étapes d'installation PWA sur iOS via le bouton de partage Safari](screenshots/installation-ios.webp)

### Sur ordinateur de bureau

1. Ouvrez l'URL dans Chrome, Edge ou un autre navigateur compatible
2. Cliquez sur l'icône d'installation dans la barre d'adresse
3. Confirmez l'installation

## Mise à jour

Pour mettre à jour le module :

1. Téléchargez la nouvelle version depuis le DoliStore
2. Déployez le fichier ZIP via **Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe**
3. **Désactivez puis réactivez** le module pour appliquer les mises à jour de base de données et enregistrer les nouveaux hooks et permissions

> **Attention :** La désactivation/réactivation est indispensable pour que les changements de structure de base de données et les nouvelles permissions soient pris en compte.

## Désinstallation

Pour désinstaller le module, désactivez-le depuis **Accueil > Configuration > Modules/Applications**. Les données sont conservées en base de données.