Guide WPForge » Historique » Révision 7
Révision 6 (Johnny Fontaine, 15/04/2026 17:28) → Révision 7/28 (Johnny Fontaine, 15/04/2026 17:29)
# <img style="width: 180px;" src="clipboard-202603161125-sbyni.png"> Guide d'utilisation WPForge
> [!Note] Ce guide décrit les actions courantes pour les professeurs dans WPForge.
WPForge est une plateforme complète de gestion WordPress construite avec FastAPI (backend) et React/Vite (frontend). Elle propose des outils pour gérer les sites WordPress, utilisateurs, plugins, thèmes et bien plus via une interface web élégante.
```
┌─────────────────────────────────────────────────────────────┐
│ Architecture WPForge │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌───────────┐ │
│ │ Navigateur │────▶│ Frontend │────▶│ Backend │ │
│ │ (React/Vite) │ │ (Vite) │ │(FastAPI) │ │
│ └──────────────┘ └──────────────┘ └─────┬─────┘ │
│ │ │
│ ┌─────────────────────┼────┐ │
│ │ ▼ ▼ │
│ │ ┌────────┐ │
│ └───────────────▶│ WP-CLI │ │
│ └────────┘ │
│ ▲ │
│ ┌───────────────────┴─────────┤ │
│ │ ▼ ▼ │
│ │ ┌────────┐ │
│ └───────────────▶│ MySQL │ │
│ └────────┘ │
└─────────────────────────────────────────────────────────────┘
```
## ✨ Fonctionnalités
- 🌍 **Gestion des sites** — Lister, ajouter, supprimer des installations WordPress
- 👥 **Gestion des utilisateurs et rôles** — Gérer les accès et permissions
- 🔌 **Opérations sur les plugins** — Installer, activer, mettre à jour, supprimer
- 🎨 **Gestion des thèmes** — Parcourir et gérer les thèmes WordPress
- 📸 **Capture d'écrans** — Capturer des screenshots pour la surveillance
- 💓 **Surveillance et vérifications** — Maintenir les sites en bonne santé
- 💾 **Sauvegardes automatiques** — Sauvegarde via WP-CLI
- 🔗 **API REST** — Pour l'extensibilité et l'automatisation
## 🚦 Démarrage rapide
### 📋 Prérequis
- 🐍 Python 3.8+
- 🟢 Node.js 14+
- 🐳 Docker (optionnel, pour la production)
- 📦 WP-CLI (pour les opérations WordPress)
### 🖥️ Configuration du Backend
```bash
cd backend
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload --host 127.0.0.1 --port 8000
```
### 🖼️ Configuration du Frontend
```bash
cd frontend
npm install
npm run dev # serveur de dev sur http://localhost:5173
```
### 🏗️ Build de production
```bash
cd frontend
npm run build # sortie dans frontend/dist/
```
### 🚀 Déploiement
Utilisez le script de déploiement fourni (nécessite root) :
```bash
sudo scripts/deploy.sh [--update]
```
```
┌────────────────────────────────────────┐
│ Flux de déploiement │
├────────────────────────────────────────┤
│ │
│ ./deploy.sh │
│ │ │
│ ▼ │
│ ┌─────────────┐ │
│ │Installation │ │
│ │ dépendances│ │
│ └──────┬──────┘ │
│ ▼ │
│ ┌─────────────┐ │
│ │Build frontend│ │
│ └──────┬──────┘ │
│ ▼ │
│ ┌─────────────┐ ┌──────────────┐ │
│ │ Nginx │ │ Systemd │ │
│ │ Config │ │ Service │ │
│ └─────────────┘ └──────────────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌─────────────────────────────┐ │
│ │ ✅ Terminé ! │ │
│ └─────────────────────────────┘ │
└────────────────────────────────────────┘
```
## 📚 Documentation
- 📖 [Guide utilisateur](GUIDE.md) — Instructions détaillées pour les utilisateurs
- 📡 [API Docs](http://127.0.0.1:8000/docs) — Interface Swagger interactive (quand le backend tourne)
## 📜 Licence
MIT%