Guide WPForge » Historique » Révision 19
Révision 18 (Johnny Fontaine, 15/04/2026 17:44) → Révision 19/28 (Johnny Fontaine, 15/04/2026 17:51)
# <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. Bienvenue sur WPForge ! Ce guide pratique vous accompagne au quotidien pour gérer dans la gestion de vos sites WordPress avec WPForge. notre plateforme. ## 📋 Table des matières 1. [Démarrage](#démarrage) 2. [Vue d'ensemble du tableau de bord](#vue-densemble-du-tableau-de-bord) 3. [Gestion des sites](#gestion-des-sites) 4. [Gestion des utilisateurs](#gestion-des-utilisateurs) 5. [Plugins et thèmes](#plugins-et-thèmes) 6. [Surveillance et sauvegardes](#surveillance-et-sauvegardes) 7. [Dépannage](#dépannage) --- ## 🚀 Premiers pas 🏁 Démarrage ### Lancer Accéder à la plateforme ```bash ``` # Terminal 1 : Backend ┌─────────────────────────────────────────┐ cd backend && source venv/bin/activate │ Points d'accès WPForge │ uvicorn main:app --reload --host 127.0.0.1 --port 8000 # Terminal 2 : Frontend ├─────────────────────────────────────────┤ cd frontend && npm run dev │ │ │ Appareil utilisateur │ │ │ │ │ ▼ │ │ ┌─────────────────────────────────┐ │ │ │ https://wpforge.h3campus.fr │ │ │ └───────────────┬─────────────────┘ │ │ │ │ │ ┌───────┴───────┐ │ │ ▼ ▼ │ │ ┌────────┐ ┌──────────┐ │ │ │Frontend│ │ API │ │ │ │ (Vite) │ │(FastAPI) │ │ │ └────────┘ └──────────┘ │ │ │ │ │ ▼ │ │ ┌─────────┐ │ │ │WP-CLI │ │ │ └─────────┘ │ └─────────────────────────────────────────┘ ``` ### Accès Première connexion 1. Accédez à la page de connexion 2. Utilisez les identifiants admin créés lors de l'installation (vérifiez `.admin_token` pour le token temporaire si nécessaire) 3. Changez votre mot de passe lors de la première connexion --- ## 📊 Vue d'ensemble du tableau de bord Le tableau de bord offre une vue d'ensemble : | Service Widget | URL Description | |---------|-----| |--------|-------------| | Interface 🌍 **Aperçu des sites** | http://localhost:5173 Nombre de sites WordPress gérés | | API 💻 **Santé système** | http://127.0.0.1:8000 Utilisation CPU, mémoire et disque | | Docs API 📝 **Activité récente** | http://127.0.0.1:8000/docs Dernières actions effectuées | | ⚡ **Actions rapides** | Ajouter un site, sauvegarder, vérifier les mises à jour | ### Connexion 1. Ouvrez http://localhost:5173 ``` 2. Connectez-vous avec vos identifiants ┌─────────────────────────────────────────────┐ 3. Changez votre mot │ Tableau de passe si premier accès bord WPForge │ ├─────────────────────────────────────────────┤ │ │ │ ┌─────────────┐ ┌─────────────┐ │ │ │ 🌍Sites │ │ 💻Système │ │ │ │ 12 │ │ CPU: 45% │ │ │ │ Actifs │ │ RAM: 62% │ │ │ └─────────────┘ └─────────────┘ │ │ │ │ ┌─────────────────────────────────────┐ │ │ │ 📝Activité récente │ │ │ │ • Plugin mis à jour - il y a 2h │ │ │ │ • Sauvegarde créée - il y a 5h │ │ │ │ • Nouvel utilisateur - il y a 1j │ │ │ └─────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────┐ │ │ │ ⚡Actions rapides │ │ │ │ [+ Nouveau] [💾Sauvegarder] [🔄] │ │ │ └─────────────────────────────────────┘ │ └─────────────────────────────────────────────┘ ``` --- ## 🌍 Gestion des sites ### Ajouter un nouveau site 1. **Sidebar** → Cliquez sur "Sites" dans la barre latérale 2. **Bouton** → "+ Nouveau Cliquez sur "Ajouter un site" 3. Remplissez : - Nom du site - URL WordPress (ex: https://wpforge.h3campus.fr) - Chemin WP-CLI (si pas dans le formulaire PATH système) - Identifiants base de données (optionnel, pour opérations DB directes) 4. Cliquez sur "Enregistrer" ### Opérations sur un site Pour chaque site, vous pouvez : | Champ Action | Description | |-------|-------------| |--------|-------------| | Nom 👁️ **Voir les détails** | Nom afficher du site Version PHP, WP, thème actif | | URL ⌨️ **Exécuter WP-CLI** | URL WordPress (https://...) Exécuter des commandes via le terminal intégré | | Chemin WP-CLI 🔌 **Gérer les plugins** | Si pas dans PATH Installer, activer, mettre à jour, supprimer | | DB (optionnel) 🎨 **Gérer les thèmes** | Pour opérations directes Installer et gérer les thèmes | | 📸 **Captures d'écran** | Capturer le frontend/backend | | 💾 **Sauvegarder/Restaurer** | Sauvegardes manuelles ou automatisées | | 🔍 **Rechercher-Remplacer** | Remplacer des chaînes en base de données | 4. **Enregistrer** --- ## 🔌 Gérer les plugins ### Méthode rapide ``` Sites → [Sélection] → ┌────────────────────────────────────────────┐ │ Flux de gestion des sites │ ├────────────────────────────────────────────┤ │ │ │ Liste des sites ──▶ Ajouter site │ │ │ │ │ │ │ ▼ │ │ │ ┌────────────┐ │ │ │ │ Remplir │ │ │ │ │leformulaire│ │ │ │ └─────┬──────┘ │ │ │ │ │ │ ▼ ▼ │ │ ┌─────────────────────────────┐ │ │ │ Détails du site │ │ │ ├─────────────────────────────┤ │ │ │ 👁️ Voir ⌨️ Terminal │ │ │ │ 🔌 Plugins 🎨 Themes │ │ │ │ 📸 Screenshots 💾 Backup │ │ │ └─────────────────────────────┘ │ └────────────────────────────────────────────┘ ``` --- ## 👥 Gestion des utilisateurs ### Actions disponíveis Rôles et permissions WPForge gère les rôles suivants : | Action Rôle | Résultat Permissions | |--------|----------| |------|-------------| | ✅ Activer 👑 **Administrateur** | Rend le plugin actif Accès complet à tous les sites et paramètres | | ❌ Désactiver 📢 **Gestionnaire** | Désactive sans supprimer Peut gérer les sites mais pas les paramètres système | | 🔄 Mettre à jour 🔧 **Opérateur** | Dernière version Peut effectuer des opérations mais pas modifier les configs | | 🗑️ Supprimer 👀 **Lecteur** | Retire entièrement Accès en lecture seule | ### Opérations groupées Ajouter des utilisateurs 1. Cochez plusieurs plugins Allez dans "Utilisateurs" dans la barre latérale 2. Sélectionnez l'action Cliquez sur "Ajouter un utilisateur" 3. Appliquer --- ## 🎨 Gérer les thèmes Même principe que les plugins : ``` Entrez le nom d'utilisateur, l'email, le rôle Sites → [Sélection] → Thèmes 4. Définissez un mot de passe ou envoyez un lien de réinitialisation ``` 5. Cliquez sur "Créer l'utilisateur" Actions : Activer | Désactiver | Supprimer --- ## ⌨️ Terminal WP-CLI Chaque site dispose d'un terminal intégré : ``` Sites → [Sélection] → Terminal ┌────────────────────────────────────────┐ ``` ### Commandes utiles ```bash │ Hiérarchie des rôles utilisateurs │ wp plugin list # Liste les plugins ├────────────────────────────────────────┤ wp plugin activate akismet │ │ │ 👑 Administrateur │ │ │ │ │ ┌───────┴───────┐ │ │ ▼ ▼ │ │ 📢 Gestionnaire # Active un plugin 🔧 Opérateur │ wp core update # Met à jour WordPress │ │ │ │ wp theme status # État des thèmes │ │ │ │ wp db optimize │ ▼ ▼ │ │ └──────────┬──┘ │ │ ▼ │ │ # Optimise les tables 👀 Lecteur │ wp search-replace 'old' 'new' # Remplace en base └────────────────────────────────────────┘ ``` --- ## 📸 Screenshots 🔌 Plugins et thèmes Capturer l'état d'un site ### Opérations groupées Depuis la page "Plugins" ou "Thèmes" : ``` 1. Sélectionnez plusieurs éléments Sites → [Sélection] → 📸 Screenshots 2. Choisissez l'action : Activer, Désactiver, Mettre à jour, Supprimer ``` 3. Appliquez aux sites sélectionnés ### Gestion par site Options Naviguez vers un site spécifique → onglet "Plugins"/"Thèmes" pour : - 📥 Installer depuis WordPress.org ou uploader un ZIP - Frontend / Backend ✅ Voir le statut actif/inactif - Sauvegarde automatique 🔄 Mettre à jour les éléments individuellement - 🔍 Rechercher dans le dépôt --- ## 💾 Sauvegardes ### Créer une sauvegarde ``` Sites → [Sélection] → Sauvegardes → + Créer ┌─────────────────────────────────────────┐ ``` ### Restaurer ``` │ Flux de gestion Plugins/Thèmes │ Sites → [Sélection] → Sauvegardes ├─────────────────────────────────────────┤ → [Sélectionner] → Restaurer │ │ ``` > ⚠️ Confirmez avant restauration │ Page Plugins/Themes │ │ │ │ │ ▼ │ │ ┌────────────────────┐ │ │ │ Sélectionner │ │ │ │ ☑ Plugin A │ │ │ │ ☑ Plugin B │ │ │ │ ☐ Plugin C │ │ │ └──────┬─────────────┘ │ │ ▼ │ │ ┌────────────────────┐ │ │ │ Choisir action │ │ │ │ [Activer] [Désact] │ │ │ │ [Maj] [Supprim] │ │ │ └──────┬───────────┘ │ │ ▼ │ │ ┌────────────────────┐ │ │ │ ✅ Succès ! --- ## 📊 Tableau de bord Widgets disponibles : - Nombre de sites actifs │ │ - Santé système (CPU/RAM/Disque) │ └────────────────────┘ │ - Activité récente └─────────────────────────────────────────┘ - Actions rapides ``` --- ## 👥 Utilisateurs 📊 Surveillance et sauvegardes ### Ajouter un utilisateur ``` Utilisateurs → + Ajouter → Nom / Email / Rôle / Mot Vérifications de passe → Créer ``` santé ### Rôles WPForge vérifie périodiquement : | Rôle Vérification | Droits Description | |------|---------| |-------|-------------| | 👑 Admin 🌐 **Disponibilité du site** | Tout Réponse HTTP 200 | | 📢 Manager ⏱️ **Temps de réponse** | Sites uniquement Vitesse de chargement | | 🔧 Opérateur 🔒 **Certificat SSL** | Opérations uniquement Validité du certificat | | 👀 Lecteur 💾 **Espace disque** | Consultation Stockage disponible | Voir les données dans "Surveillance" → "Vérifications de santé" ### Gestion des sauvegardes #### Créer une sauvegarde 1. **Manuelle** : Sélectionnez un site → "Sauvegardes" → "Créer une sauvegarde" 2. **Planifiée** : Configurez dans les paramètres du site → "Planification" #### Restaurer une sauvegarde 1. Allez dans l'onglet "Sauvegardes" du site 2. Localisez la sauvegarde souhaitée 3. Cliquez sur "Restaurer" et confirmez > ⚠️ **Note** : Les sauvegardes incluent les fichiers et la base de données. Assurez-vous d'avoir suffisamment d'espace. ``` ┌─────────────────────────────────────────┐ │ Flux des sauvegardes │ ├─────────────────────────────────────────┤ │ │ │ ┌─────────┐ ┌─────────────┐ │ │ │ Manuelle│ │ Planifiée │ │ │ │Sauvegarde│ │ Sauvegarde │ │ │ └───┬───┘ └──────┬──────┘ │ │ │ │ │ │ ▼ ▼ │ │ ┌─────────────────────────────────┐ │ │ │ Créer sauvegarde │ │ │ │ • Base de données (mysqldump) │ │ │ │ • Fichiers (wp-content) │ │ │ │ • Horodatage │ │ │ └──────────────┬──────────────────┘ │ │ ▼ │ │ ┌─────────────────────────────────┐ │ │ │ Stocker sauvegarde │ │ │ │ /backups/site_2024-01-15/ │ │ │ └──────────────┬────────────────┘ │ │ ▼ │ │ ┌─────────────────────────────────┐ │ │ │ ✅ Sauvegarde terminée │ │ │ └─────────────────────────────────┘ │ └─────────────────────────────────────────┘ ``` --- ## 🔧 Dépannage rapide | Problème | Solution | ### Problèmes courants #### ❌ "Impossible de se connecter au site" - ✅ Vérifiez que WP-CLI est installé et accessible |----------|----------| - ✅ Vérifiez l'URL du site et les identifiants | Cannot connect | Vérifier WP-CLI + URL | - ✅ Assurez-vous que le serveur peut accéder à l'instance WordPress (pare-feu/réseau) #### ❌ "La sauvegarde a échoué" - ✅ Vérifiez l'espace disque disponible | Backup failed | Espace disque + - ✅ Vérifiez que mysqldump | est installé (pour les sauvegardes DB) | Update failed | Permissions + - ✅ Vérifiez les permissions dans le répertoire de sauvegarde #### ❌ "La mise à jour du plugin/thème a échoué" - ✅ Désactivez temporairement les plugins de cache | - ✅ Vérifiez les permissions sur le répertoire wp-content - ✅ Essayez la mise à jour via WP-CLI directement pour isoler le problème ### Logs Obtenir de l'aide ``` - 📂 Consultez les logs dans le répertoire `./logs/` ./logs/ - 📸 Review les captures d'écran dans `./screenshots/` pour des indices visuels ``` - 📡 Visitez la documentation API sur http://127.0.0.1:8000/docs - 🐛 Pour les problèmes persistants, consultez le gestionnaire de problèmes du projet --- ## ⌨️ 💡 Astuces et bonnes pratiques ### Raccourcis clavier | Touche Raccourci | Action | |--------|--------| |----------|--------| | `/?` | Aide Afficher l'aide | | `g s` | Aller à la page Sites | | `g u` | Aller à la page Utilisateurs | | `g p` | Aller à la page Plugins | | `g t` | Aller à la page Thèmes | ### Commandes WP-CLI WPForge expose un terminal pour chaque site. Commandes utiles : | Commande | Description | |---------|-------------| | `wp core update` | Mettre à jour WordPress | | `wp plugin list` | Liste des plugins | | `wp theme status` | Statut des thèmes | | `wp db optimize` | Optimiser les tables | | `wp search-replace 'old' 'new'` | Remplacer des chaînes en base | ### Support Multisite WPForge fonctionne avec les réseaux WordPress Multisite : - Traitez le réseau comme un seul site - Les opérations affectent tous les sous-sites sauf indication - Utilisez WP-CLI avec le paramètre `--url` pour des commandes spécifiques ``` ┌─────────────────────────────────────────┐ │ Architecture Multisite │ ├─────────────────────────────────────────┤ │ │ │ ┌─────────────┐ │ │ │ Réseau │ │ │ │ (Root) │ │ │ └─────┬───────┘ │ │ │ │ │ ┌───────┼───────┐ │ │ │ │ │ │ │ ▼ ▼ ▼ │ │ ┌─────┐ ┌─────┐ ┌─────┐ │ │ │Sub1 │ │Sub2 │ │Sub3 │ │ │ └─────┘ └─────┘ └─────┘ │ └─────────────────────────────────────────┘ ``` --- ## 🔒 Bonnes pratiques de sécurité 1. 🔄 **Garder WPForge à jour** — Récupérez régulièrement les dernières modifications 2. 🔐 **Utiliser des mots de passe forts** — Pour WPForge et l'admin WordPress 3. 🚫 **Restreindre l'accès** — Limitez l'accès réseau aux IPs de confiance 4. 🔒 **Activer HTTPS** — Utilisez le template Nginx fourni avec SSL 5. 💾 **Sauvegardes régulières** — Planifiez des sauvegardes automatisées 6. 📊 **Surveiller les logs** — Consultez `./logs/` pour toute activité inhabituelle