Projet

Général

Profil

Guide WPForge » Historique » Révision 6

Révision 5 (Johnny Fontaine, 16/03/2026 11:26) → Révision 6/28 (Johnny Fontaine, 15/04/2026 17:28)

# <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. ## Connexion 

 ``` - Aller sur `https://wpforge.h3campus.fr`. 
 ┌─────────────────────────────────────────────────────────────┐ 
 │                      Architecture WPForge                        │ 
 ├─────────────────────────────────────────────────────────────┤ 
 │                                                               │ 
 │     ┌──────────────┐       ┌──────────────┐       ┌───────────┐    │ 
 │     │    Navigateur    │────▶│     Frontend     │────▶│    Backend │    │ 
 │     │ (React/Vite) │       │     (Vite)       │       │(FastAPI) │    │ 
 │     └──────────────┘       └──────────────┘       └─────┬─────┘    │ 
 │                                                     │          │ 
 │                                ┌─────────────────────┼────┐    │ 
 │                                │                       ▼      ▼    │ 
 │                                │                   ┌────────┐ │ 
 │                                └───────────────▶│ WP-CLI │ │ 
 │                                                    └────────┘ │ 
 │                                                    ▲           │ 
 │                                ┌───────────────────┴─────────┤    │ 
 │                                │                       ▼          ▼    │ 
 │                                │                   ┌────────┐    │ 
 │                                └───────────────▶│    MySQL    │    │ 
 │                                                    └────────┘    │ 
 └─────────────────────────────────────────────────────────────┘ 
 ``` - Se connecter avec vos identifiants. 

 ## ✨ Fonctionnalités Tableau de bord 

 Le tableau de bord affiche : 

 - 🌍 **Gestion des sites** — Lister, ajouter, supprimer des installations WordPress Nombre de classes, étudiants et sites. 
 - 👥 **Gestion État global des utilisateurs et rôles** — Gérer sites. 

 ## Classes 

 Vous pouvez : 

 - Consulter les accès et permissions classes auxquelles vous êtes affecté. 
 - 🔌 **Opérations sur Accéder au détail d’une classe pour voir les plugins** — Installer, activer, mettre à jour, supprimer 
 étudiants et leurs sites. 

 ## Étudiants 

 La page “Étudiants” permet : 

 - 🎨 **Gestion des thèmes** — Parcourir et gérer De consulter les thèmes WordPress étudiants de vos classes. 
 - 📸 **Capture d'écrans** — Capturer des screenshots pour De vérifier l’association à une classe. 

 ## Sites 

 Sur la surveillance 
 page “Sites” : 

 - 💓 **Surveillance et vérifications** — Maintenir les Accès aux URLs des sites en bonne santé étudiants. 
 - 💾 **Sauvegardes automatiques** — Sauvegarde via WP-CLI 
 - 🔗 **API REST** — Pour l'extensibilité et l'automatisation Suivi du statut (actif, archivé). 

 ## 🚦 Démarrage rapide Monitoring 

 ### 📋 Prérequis La page “Monitoring” affiche : 

 - 🐍 Python 3.8+ Disponibilité (en ligne / hors ligne / inconnu). 
 - 🟢 Node.js 14+ Code HTTP et latence. 
 - 🐳 Docker (optionnel, pour la production) Dernière vérification. 
 - 📦 WP-CLI (pour les opérations WordPress) 

 ### 🖥️ Configuration Taille du Backend site (uploads) : 
   - En vert si `≤ 50 Mo` 
   - En rouge si `> 50 Mo` 

 ```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 Vous pouvez cliquer sur http://localhost:5173 
 ``` “Vérifier maintenant” pour forcer une vérification. 

 ### 🏗️ Build de production ## À propos 

 ```bash 
 cd frontend 
 npm run build    # sortie dans frontend/dist/ 
 ``` 

 ### 🚀 Déploiement 

 Utilisez le script La page “À propos” résume l’objectif de déploiement fourni (nécessite root) : la plateforme et fournit un lien direct vers WPForge. 

 ```bash 
 sudo scripts/deploy.sh [--update] 
 ``` 

 ``` 
 ┌────────────────────────────────────────┐ 
 │              Flux de déploiement          │ 
 ├────────────────────────────────────────┤ 
 │                                          │ 
 │     ./deploy.sh                            │ 
 │          │                                 │ 
 │          ▼                                 │ 
 │     ┌─────────────┐                        │ 
 │     │Installation │                       │ 
 │     │    dépendances│                        │ 
 │     └──────┬──────┘                        │ 
 │            ▼                               │ 
 │     ┌─────────────┐                        │ 
 │     │Build frontend│                       │ 
 │     └──────┬──────┘                        │ 
 │            ▼                               │ 
 │     ┌─────────────┐    ┌──────────────┐      │ 
 │     │    Nginx       │    │ Systemd        │      │ 
 │     │    Config      │    │ Service        │      │ 
 │     └─────────────┘    └──────────────┘      │ 
 │            │               │                │ 
 │            ▼               ▼                │ 
 │     ┌─────────────────────────────┐       │ 
 │     │        ✅ Terminé !            │       │ 
 │     └─────────────────────────────┘       │ 
 └────────────────────────────────────────┘ 
 ``` 

 ## 📚 Documentation Bonnes pratiques 

 - 📖 [Guide utilisateur](GUIDE.md) — Instructions détaillées Vérifier régulièrement le monitoring pour détecter les utilisateurs sites hors ligne. 
 - 📡 [API Docs](http://127.0.0.1:8000/docs) — Interface Swagger interactive (quand Contacter l’étudiant si un site dépasse 50 Mo. 
 - Utiliser le backend tourne) lien direct vers le site pour corriger rapidement les problèmes. 

 ## 📜 Licence 

 MIT%