---
title: "Configuration générale"
weight: 20
description: "Paramétrage général du module : apparence, catalogue, services et options avancées."
---

# Configuration générale

La configuration du module est accessible depuis **Accueil > Configuration > Modules > OnePageBasket**. Elle est organisée en plusieurs onglets.

![Onglets de configuration du module OnePageBasket dans Dolibarr](screenshots/configuration-onglets.webp)

### Organisation de l'administration

L'interface d'administration (accessible via **Accueil > Configuration > Modules > OnePageBasket > icône engrenage**) est organisée en onglets thématiques. Chaque onglet regroupe des réglages liés à un même domaine fonctionnel :

| Onglet | Contenu |
|--------|---------|
| Paramètres | Activation, utilisateur par défaut, pays, options techniques (URL rewrite, captcha, debug) |
| Apparence | Thème, logo, favicon, pied de page, carrousel, langues |
| Catalogue | Articles, catégories, stock, badges de version |
| Ventes | Panier, remises, fournisseur de paiement |
| Livraison | Configuration de la livraison |
| Portail client | Authentification, documents, compte, contrats, tickets, association |
| Contenu | FAQ, badges de confiance, newsletter, avis, galerie UGC, alertes |
| Pages web | Pages statiques (CRUD) |
| Galerie UGC | Gestion de la galerie photos clients |
| Services | Prépayé, leasing, rendez-vous |
| Tickets | Configuration des tickets (si le module Dolibarr Tickets est actif) |
| Avancé | Cache de données, webhooks, traductions, champs complémentaires |
| À propos | Informations sur le module |

Cette organisation permet de retrouver rapidement les réglages recherchés sans avoir à parcourir une page de configuration unique trop longue.

## Paramètres généraux

### Réécriture d'URL

| Option | Description |
|--------|-------------|
| Masquer le index.php dans les adresses web | Active le mode rewrite d'Apache pour des URLs plus propres (sans `index.php`). Nécessite le module `mod_rewrite` d'Apache. Si vous constatez des erreurs 404, désactivez cette option. |

### Liens du site

Ces URLs apparaissent dans l'en-tête et le pied de page de la boutique :

| Option | Description |
|--------|-------------|
| Adresse publique de OnePageBasket | L'URL principale de votre boutique |
| Adresse du site web de votre société | Lien vers votre site institutionnel |
| Adresse de votre formulaire de contact | Lien vers votre page de contact |
| Adresse des mentions légales | Lien vers vos mentions légales |
| Adresse des conditions générales de vente | Lien vers vos CGV |
| Lien vers une page d'aide | Lien optionnel vers votre FAQ ou plate-forme d'aide |
| Comportement des ouvertures de liens | Même fenêtre ou nouvel onglet |

> **Pages web intégrées** : Vous pouvez remplacer ces liens externes par des [pages web statiques](/onepagebasket/pages) créées directement dans OnePageBasket. Cela évite de maintenir un site séparé.

### CAPTCHA

| Option | Description |
|--------|-------------|
| Activer le CAPTCHA | Active le CAPTCHA sur les formulaires de commande et de création de compte. Laissez désactivé si vous proposez un système de réservation interne. |

## Apparence

### Thème graphique

![Section apparence avec le sélecteur de thème et les options de personnalisation visuelle](screenshots/configuration-apparence.webp)

Plusieurs thèmes sont disponibles :

| Thème | Description |
|-------|-------------|
| **default** | Thème par défaut, clair et moderne. Sert de référence à tous les autres. |
| **InfraS** | Palette plus sombre, fonctionnalités avancées |
| **lumen** | Vitrine claire et aérée, palette encre et bronze |
| **marketplace** | Vitrine dense, façon place de marché |
| **shopiplace** | Vitrine avec section marketing en tête, couleur principale configurable |
| **chacha** | Palette rose et dorée, typographies élégantes |
| **nordic** | Ancien thème épuré. Il n'a pas toutes les fonctionnalités récentes. |

Aucun de ces thèmes ne vous convient ? Un graphiste peut créer une charte sur
mesure : voir [Créer un thème](creer-un-theme.md).

### Personnalisation visuelle

| Option | Description |
|--------|-------------|
| Choix du logo | Logo affiché dans l'en-tête de la boutique |
| Utiliser le favicon du thème | Utilise le favicon du thème à la place de celui de Dolibarr |
| Afficher les infos société en pied de page | Affiche les coordonnées de votre société dans le pied de page |

### Langues

Sélectionnez les langues disponibles pour vos clients. La langue par défaut est celle configurée dans votre société Dolibarr. Les traductions des articles s'appuient sur le système multilingue natif de Dolibarr.

Langues supportées : français, anglais, espagnol, italien, allemand, néerlandais, polonais, portugais brésilien.

## Images d'accueil

### Image ou carrousel

![Configuration du carrousel d'images de la page d'accueil avec les options de vitesse de transition](screenshots/configuration-carrousel.webp)

Vous pouvez afficher une image unique ou un carrousel d'images sur la page d'accueil :

1. Téléversez vos images (JPG, PNG, WEBP) via le formulaire d'import
2. Choisissez le mode d'affichage : image unique ou carrousel
3. En mode carrousel, réglez la vitesse de transition (3, 5, 7 ou 10 secondes)

### Images d'arrière-plan

Sélectionnez une ou plusieurs images d'arrière-plan parmi celles téléversées. Si plusieurs images sont sélectionnées, une sera choisie aléatoirement à chaque chargement de page.

## Images des produits

| Option | Description |
|--------|-------------|
| Créer automatiquement le lien de partage | Crée automatiquement les liens de partage nécessaires à l'affichage des images produits. Sans cette option, vous devez activer manuellement le partage dans l'onglet "fichiers joints" de chaque produit. |

## Cache de données

Le cache de données est configurable depuis l'onglet **Avancé** de l'administration. Il permet de réduire significativement le nombre de requêtes à la base de données sur la vitrine publique en mémorisant les résultats des requêtes fréquentes.

### Fonctionnement

Le cache utilise deux pilotes :

- **APCu** (prioritaire si disponible) : mémoire partagée, très performant
- **Cache fichier** (solution de repli) : fichiers PHP stockés dans le répertoire de données de Dolibarr, compatibles avec l'opcache

Le contenu dynamique lié à la session (panier, utilisateur connecté) n'est jamais mis en cache.

### Durées de rétention (TTL)

Les durées de conservation sont configurables par famille de données :

| Famille | Durée par défaut | Données concernées |
|---------|-----------------|-------------------|
| Dictionnaires | 30 minutes | Menus, carrousel, badges de confiance |
| Produits | 15 minutes | Articles, catégories, factures récurrentes, badges produits |
| Images | 1 heure | Photos principales et galeries produits |
| Contrats | 30 minutes | Modèles de contrats |

La durée minimale acceptée est de 60 secondes.

### Options disponibles

| Option | Description |
|--------|-------------|
| Activer/désactiver le cache | Le cache est activé par défaut. Vous pouvez le désactiver pour le débogage. |
| Vider le cache | Bouton permettant de supprimer immédiatement toutes les données en cache. |
| Taux de succès | Affiche le ratio de réponses servies depuis le cache (hits) par rapport aux requêtes totales, ce qui permet d'évaluer l'efficacité du cache. |

### Invalidation automatique

Les modifications effectuées dans Dolibarr invalident automatiquement les caches concernés :

- **Produits** : toute création, modification ou suppression d'un produit vide le cache des articles et des catégories.
- **Catégories** : tout changement de catégorie (création, modification, suppression, association/dissociation) vide le cache des articles.
- **Contrats** : toute modification d'un modèle de contrat vide le cache des contrats.

### Purge automatique

Une tâche planifiée (cron) s'exécute toutes les 6 heures pour supprimer les fichiers de cache expirés et appliquer la limite de taille du répertoire de cache (50 Mo par défaut).