# Guide d'installation - Yacht Provisioning v2.1.0

## 🚀 Installation

1. **Télécharger le plugin**
   - Téléchargez le fichier `yacht-provisioning-woo-v2.1.0.zip`

2. **Installer dans WordPress**
   - Allez dans WordPress Admin → Extensions → Ajouter
   - Cliquez sur "Téléverser une extension"
   - Sélectionnez le fichier zip
   - Cliquez sur "Installer maintenant"
   - Activez le plugin

3. **Vérifier WooCommerce**
   - Le plugin nécessite WooCommerce pour fonctionner
   - Si WooCommerce n'est pas installé, installez-le d'abord

## ⚙️ Configuration

### Configuration de base
1. Allez dans **WooCommerce → Réglages → Yacht Provisioning**
2. Configurez :
   - Nom de votre entreprise
   - Logo (pour les PDF)
   - Texte de pied de page des PDF

### Configuration des produits
Pour chaque produit, vous pouvez configurer :

1. **Mode de tarification** :
   - Prix fixe
   - Prix à l'unité
   - Prix au kg
   - Fourchette de prix au kg (min-max)

2. **Mode de préparation** (optionnel) :
   - Cochez "Activer les modes de préparation"
   - Permet aux clients de choisir : Entier / Gratté & vidé / En filet

## ✅ Nouveautés version 2.1.0

### 1. Quantités en nombres entiers
- Les clients ne peuvent plus saisir de nombres décimaux
- Seuls les nombres entiers (1, 2, 3, etc.) sont acceptés
- Validation automatique côté client et serveur

### 2. Génération automatique du devis
- **Plus besoin d'action manuelle !**
- Le PDF est généré automatiquement dès qu'un client passe commande
- Visible immédiatement dans l'administration

### 3. Envoi automatique par email
- Le PDF du devis est automatiquement attaché à l'email de confirmation
- Email renommé en "Confirmation de votre demande de devis #XXX"
- Le client reçoit son devis instantanément

### 4. Design responsive
- **Affichage optimisé sur mobile et tablette**
- Les tableaux se transforment en cartes sur petit écran
- Navigation tactile améliorée
- Formulaires adaptés aux mobiles

## 📱 Utilisation sur mobile

Le nouveau design responsive offre une expérience optimale sur tous les appareils :

- **Desktop** : Affichage en tableau complet
- **Tablette** : Affichage en tableau avec colonnes adaptées
- **Mobile** : Affichage en cartes verticales avec tous les champs accessibles

## 🔄 Processus de commande

1. **Client se connecte** (obligatoire pour voir les produits)
2. **Sélectionne les produits** dans les catégories accordéon
3. **Saisit les quantités** (nombres entiers uniquement)
4. **Ajoute les options** (préparation, commentaires)
5. **Passe la commande** → "Demander un devis"
6. **Reçoit automatiquement** :
   - Email de confirmation avec PDF attaché
   - Lien de téléchargement du PDF sur la page de confirmation

## 👨‍💼 Gestion des devis (Admin)

1. **Voir les demandes** : WooCommerce → Commandes
2. **Statut** : "Devis en attente"
3. **Télécharger le PDF** : Bouton disponible dans chaque commande
4. **Régénérer si besoin** : Action "Générer le PDF de devis" disponible

## 🎨 Personnalisation

### Couleurs du thème
Les couleurs principales sont définies dans `/assets/css/shop.css` :
- Bleu principal : `#0c4a6e`
- Bleu secondaire : `#0369a1`
- Vert succès : `#10b981`

### Textes et traductions
Les textes sont tous traduisibles via le domaine `yacht-provisioning`.

## 🐛 Dépannage

### Le PDF n'est pas généré ?
- Vérifiez que le dossier `/wp-content/uploads/yacht-quotes/` existe
- Vérifiez les permissions d'écriture sur ce dossier
- Le PDF est généré automatiquement lors de la commande

### Le PDF n'est pas attaché à l'email ?
- Le plugin attache automatiquement le PDF
- Si le PDF n'existe pas, il est généré avant l'envoi de l'email
- Vérifiez que l'email de confirmation est bien envoyé par WooCommerce

### Affichage mobile incorrect ?
- Videz le cache du navigateur
- Vérifiez qu'aucun CSS de thème n'entre en conflit
- Les media queries sont à partir de 768px

## 📧 Support

Pour toute question ou problème, contactez Arnaud Poirier.

---

**Version :** 2.1.0  
**Date :** 29 Octobre 2025  
**Compatibilité :** WordPress 6.0+ / WooCommerce 8.0+