# Installation de TCPDF pour la génération des PDF

## ⚠️ Important

Le plugin **Yacht Provisioning** fonctionne sans TCPDF, mais **les PDF de devis ne seront pas générés** automatiquement. Pour activer la génération automatique des PDF, vous devez installer TCPDF.

## 📋 Symptômes si TCPDF n'est pas installé

- ✅ Le plugin fonctionne normalement
- ✅ Les demandes de devis sont enregistrées
- ✅ Les emails de confirmation sont envoyés
- ❌ Les PDF ne sont pas générés
- ⚠️ Un message d'avertissement s'affiche dans l'administration WordPress

## 🔧 Méthodes d'installation de TCPDF

### Méthode 1: Via Composer (Recommandé)

Si vous avez accès au serveur par SSH:

```bash
cd /chemin/vers/wp-content/plugins/yacht-provisioning-woo/
composer require tecnickcom/tcpdf
```

### Méthode 2: Via le script d'installation

Un script d'installation est fourni avec le plugin:

```bash
cd /chemin/vers/wp-content/plugins/yacht-provisioning-woo/
chmod +x install-tcpdf.sh
./install-tcpdf.sh
```

### Méthode 3: Installation manuelle

1. **Télécharger TCPDF**
   - Allez sur https://github.com/tecnickcom/TCPDF/releases
   - Téléchargez la dernière version (zip ou tar.gz)

2. **Extraire les fichiers**
   - Extrayez l'archive téléchargée
   - Vous devriez avoir un dossier `TCPDF-X.X.X` (où X.X.X est le numéro de version)

3. **Installer dans le plugin**
   - Connectez-vous à votre serveur par FTP/SFTP
   - Naviguez vers: `wp-content/plugins/yacht-provisioning-woo/vendor/`
   - Créez un dossier `tecnickcom` s'il n'existe pas
   - Renommez le dossier `TCPDF-X.X.X` en `tcpdf`
   - Déplacez-le dans `vendor/tecnickcom/`
   - Le fichier principal doit être à: `vendor/tecnickcom/tcpdf/tcpdf.php`

4. **Structure finale**
```
yacht-provisioning-woo/
├── vendor/
│   ├── autoload.php
│   └── tecnickcom/
│       └── tcpdf/
│           ├── tcpdf.php (fichier principal)
│           ├── config/
│           ├── fonts/
│           └── ...
```

### Méthode 4: Via cPanel File Manager

1. Connectez-vous à votre cPanel
2. Ouvrez **File Manager**
3. Naviguez vers `public_html/wp-content/plugins/yacht-provisioning-woo/`
4. Téléchargez le fichier TCPDF depuis GitHub (voir Méthode 3)
5. Uploadez l'archive dans le dossier du plugin
6. Clic droit → Extract
7. Renommez et organisez les dossiers comme indiqué dans la Méthode 3

## ✅ Vérification de l'installation

1. **Connectez-vous à WordPress Admin**
2. **Allez dans Extensions → Extensions installées**
3. Si TCPDF est correctement installé:
   - ✅ Aucun message d'avertissement ne s'affiche
   - ✅ Un nouveau devis générera un PDF automatiquement

4. **Test de génération**
   - Passez une commande de test
   - Vérifiez que le PDF est généré dans les notes de commande
   - Vérifiez que l'email contient le PDF en pièce jointe

## 🐛 Dépannage

### "TCPDF non installé" s'affiche toujours

Vérifiez la structure des dossiers:
```bash
ls -la /chemin/vers/wp-content/plugins/yacht-provisioning-woo/vendor/tecnickcom/tcpdf/tcpdf.php
```

Le fichier `tcpdf.php` doit exister à cet emplacement exact.

### "Class TCPDF not found"

1. Vérifiez les permissions des fichiers:
```bash
chmod 755 vendor/tecnickcom/tcpdf/
chmod 644 vendor/tecnickcom/tcpdf/tcpdf.php
```

2. Désactivez et réactivez le plugin WordPress

### Les PDF ne se génèrent toujours pas

1. Vérifiez les logs d'erreurs WordPress
2. Vérifiez les permissions du dossier uploads:
```bash
chmod 755 wp-content/uploads/yacht-quotes/
```

3. Vérifiez que PHP a accès en écriture au dossier

## 📞 Besoin d'aide ?

Si vous rencontrez des difficultés, vous pouvez:
1. Consulter le fichier TROUBLESHOOTING.md
2. Vérifier les logs PHP de votre serveur
3. Contacter le support

## 💡 Alternative sans TCPDF

Si vous ne pouvez pas installer TCPDF, le plugin fonctionnera quand même normalement pour:
- ✅ Gérer les demandes de devis
- ✅ Envoyer les emails de confirmation
- ✅ Gérer les commandes dans WooCommerce

Vous devrez simplement générer les devis PDF manuellement ou utiliser une autre méthode.

---

**Version requise:** TCPDF 6.6.0 ou supérieur  
**Testé avec:** TCPDF 6.7.5  
**Licence:** LGPL-3.0
