📖 Documentation Whaly
Guide complet pour installer, configurer et utiliser Whaly — de la migration en ligne au fonctionnement local avec Docker.
🔧 Prérequis
| Composant | Version minimum | Remarque |
|---|---|---|
| WordPress | 5.0+ | Testé jusqu’à 6.x |
| PHP | 7.4+ | 8.x recommandé |
| Docker | 20.10+ | Docker Desktop ou CLI |
| Docker Compose | v2+ | Inclus avec Docker Desktop |
📦 Installation
Méthode 1 : Depuis WordPress
- Allez dans Extensions → Ajouter
- Cherchez « Whaly »
- Cliquez sur Installer puis Activer
Méthode 2 : Upload manuel
- Téléchargez le fichier
.zipdu plugin - Allez dans Extensions → Ajouter → Téléverser une extension
- Sélectionnez le fichier et cliquez sur Installer
⚙️ Configuration
Une fois activé, Whaly ajoute un menu 🐳 Whaly dans la barre latérale de l’administration WordPress.
Options disponibles
| Option | Description | Version |
|---|---|---|
| Protocole | HTTP (Free) ou HTTPS avec mkcert (Pro) | Free / Pro |
| Port | Port local pour accéder au site (défaut: 8080) | Free |
| Adminer | Interface de gestion de base de données | Free |
| Dozzle | Monitoring des logs Docker en temps réel | Pro |
| Mailpit | Capture des emails en développement | Pro |
| WP-CLI | Console WordPress en ligne de commande dans le navigateur | Pro |
🚀 Migration
Étape 1 : Lancer la migration
Cliquez sur le bouton « Lancer la migration » dans l’interface Whaly. Le processus exporte :
- 📁 Tous les fichiers WordPress (thèmes, plugins, uploads)
- 🗄️ La base de données complète (export SQL)
- 🐳 Les fichiers Docker (docker-compose.yml, nginx.conf)
- 🔧 Le script de déploiement (start.sh)
Un journal en temps réel montre la progression. Le fichier .zip est généré automatiquement.
Étape 2 : Déployer en local
# Extraire l'archive
unzip whaly-export.zip -d mon-site-local
cd mon-site-local
# Lancer le déploiement interactif
chmod +x start.sh
./start.shLe script start.sh vérifie les prérequis (Docker, ports disponibles), construit les conteneurs et démarre l’environnement.
Étape 3 : Accéder aux services
| Service | URL par défaut | Description |
|---|---|---|
| WordPress | http://localhost:8080 | Votre site cloné |
| Adminer | http://localhost:9090 | Gestion de la BDD |
| Dozzle (Pro) | http://localhost:9999 | Logs Docker |
| Mailpit (Pro) | http://localhost:8025 | Emails capturés |
🛠️ Menu Maintenance
- Sauvegardes — Créez et gérez des sauvegardes de votre environnement local
- Nettoyage — Supprimez les fichiers temporaires et les caches
- Logs — Consultez les journaux d’événements
- Terminal WP-CLI (Pro) — Exécutez des commandes WordPress depuis le navigateur
❓ FAQ
Whaly modifie-t-il mon site en ligne ?
Non. Whaly effectue uniquement des opérations de lecture. La migration est une copie, votre site de production reste intact.
Mon site local est-il accessible depuis Internet ?
Non. L’environnement Docker est strictement local. Personne d’autre que vous ne peut y accéder.
Puis-je remettre mon site local en ligne ?
Whaly se concentre sur la migration vers le local. Pour remettre en ligne, nous recommandons All-in-One WP Migration qui est parfaitement compatible.
Quels OS sont supportés ?
Windows (Docker Desktop + WSL2), macOS (Docker Desktop) et Linux (Docker Engine). Le script start.sh est fonctionnel dès lors que vous avez Docker d’installé. Il suffit de le lancer via un clic droit : Git Bash Here.
Mes données sont-elles conservées si je redémarre Docker ?
Oui. Les données sont stockées dans un volume Docker nommé (db-data), elles persistent même après docker compose down.