---
title: "Installation"
weight: 10
description: "Téléchargement, installation et activation du module OnePageBasket."
---

# Installation

## Téléchargement

Téléchargez le module depuis le [DoliStore](https://www.dolistore.com/) ou depuis votre espace client CAP-REL.

## Installation du module

1. Décompressez l'archive téléchargée
2. Copiez le dossier `onepagebasket` dans le répertoire `htdocs/custom/` de votre installation Dolibarr
3. Installez les dépendances Composer :

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

## Activation

1. Connectez-vous en tant qu'administrateur Dolibarr
2. Allez dans **Accueil > Configuration > Modules/Applications**
3. Recherchez "OnePageBasket" dans la liste
4. Cliquez sur le bouton d'activation

![Page d'activation du module OnePageBasket dans la liste des modules Dolibarr](screenshots/activation-module.webp)

Le module crée automatiquement les tables nécessaires en base de données.

## Premier paramétrage

Après activation, rendez-vous dans **Accueil > Configuration > Modules > OnePageBasket** pour configurer :

![Écran de premier paramétrage avec l'utilisateur par défaut, le pays et la catégorie racine](screenshots/premier-parametrage.webp)

1. **L'utilisateur par défaut** - Utilisateur Dolibarr affecté aux actions techniques de la boutique (création de commandes, factures, etc.). Ce paramètre est **obligatoire**.
2. **Le pays par défaut** - Pays utilisé pour les calculs de TVA si le client ne précise pas son pays.
3. **L'adresse publique** - L'URL de votre boutique. Il est fortement conseillé de mettre en place un hôte virtuel dédié plutôt que d'utiliser l'URL par défaut de Dolibarr.
4. **La catégorie racine** - Catégorie principale des produits proposés sur la boutique. Seuls les produits de cette catégorie et de ses sous-catégories seront affichés.

## Hôte virtuel recommandé

Pour des raisons de sécurité, il est recommandé de créer un hôte virtuel Apache dédié qui pointe directement vers le dossier `public/` du module :

```apache
<VirtualHost *:443>
    ServerName shop.votre-domaine.fr
    DocumentRoot /var/www/dolibarr/htdocs/custom/onepagebasket/public

    <Directory /var/www/dolibarr/htdocs/custom/onepagebasket/public>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>
```

Activez le module `mod_rewrite` d'Apache, puis dans la configuration OnePageBasket, activez l'option **Masquer le index.php dans les adresses web** pour obtenir des URLs propres.

## Mise à jour

1. Remplacez le dossier `onepagebasket` par la nouvelle version
2. Relancez `composer install --no-dev`
3. Reconnectez-vous à Dolibarr : les mises à jour de base de données sont appliquées automatiquement