Actions
Guide WPForge » Historique » Révision 12
« Précédent |
Révision 12/28
(diff)
| Suivant »
Johnny Fontaine, 15/04/2026 17:37
Guide d'utilisation WPForge¶
Ce guide décrit les actions courantes pour les professeurs dans WPForge.
Bienvenue sur WPForge ! Ce guide vous accompagne dans la gestion de vos sites WordPress avec notre plateforme.
📋 Table des matières¶
- Démarrage
- Vue d'ensemble du tableau de bord
- Gestion des sites
- Gestion des utilisateurs
- Plugins et thèmes
- Surveillance et sauvegardes
- Dépannage
🏁 Démarrage¶
Accéder à la plateforme¶
┌─────────────────────────────────────────┐
│ Points d'accès WPForge │
├─────────────────────────────────────────┤
│ │
│ Appareil utilisateur │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────┐ │
│ │ https://wpforge.h3campus.fr │ │
│ └───────────────┬─────────────────┘ │
│ │ │
│ ┌───────┴───────┐ │
│ ▼ ▼ │
│ ┌────────┐ ┌──────────┐ │
│ │Frontend│ │ API │ │
│ │ (Vite) │ │(FastAPI) │ │
│ └────────┘ └──────────┘ │
│ │ │
│ ▼ │
│ ┌─────────┐ │
│ │WP-CLI │ │
│ └─────────┘ │
└─────────────────────────────────────────┘
Première connexion¶
- Accédez à la page de connexion
- Utilisez les identifiants admin créés lors de l'installation (vérifiez
.admin_tokenpour le token temporaire si nécessaire) - 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 :
| Widget | Description |
|---|---|
| 🌍 Aperçu des sites | Nombre de sites WordPress gérés |
| 💻 Santé système | Utilisation CPU, mémoire et disque |
| 📝 Activité récente | Dernières actions effectuées |
| ⚡ Actions rapides | Ajouter un site, sauvegarder, vérifier les mises à jour |
┌─────────────────────────────────────────────┐
│ Tableau de 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¶
- Cliquez sur "Sites" dans la barre latérale
- Cliquez sur "Ajouter un site"
- Remplissez :
- Nom du site
- URL WordPress (ex: https://example.com)
- Chemin WP-CLI (si pas dans le PATH système)
- Identifiants base de données (optionnel, pour opérations DB directes)
- Cliquez sur "Enregistrer"
Opérations sur un site¶
Pour chaque site, vous pouvez :
| Action | Description |
|---|---|
| 👁️ Voir les détails | Version PHP, WP, thème actif |
| ⌨️ Exécuter WP-CLI | Exécuter des commandes via le terminal intégré |
| 🔌 Gérer les plugins | Installer, activer, mettre à jour, supprimer |
| 🎨 Gérer les thèmes | 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 |
┌────────────────────────────────────────────┐
│ 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¶
Rôles et permissions¶
WPForge gère les rôles suivants :
| Rôle | Permissions |
|---|---|
| 👑 Administrateur | Accès complet à tous les sites et paramètres |
| 📢 Gestionnaire | Peut gérer les sites mais pas les paramètres système |
| 🔧 Opérateur | Peut effectuer des opérations mais pas modifier les configs |
| 👀 Lecteur | Accès en lecture seule |
Ajouter des utilisateurs¶
- Allez dans "Utilisateurs" dans la barre latérale
- Cliquez sur "Ajouter un utilisateur"
- Entrez le nom d'utilisateur, l'email, le rôle
- Définissez un mot de passe ou envoyez un lien de réinitialisation
- Cliquez sur "Créer l'utilisateur"
┌────────────────────────────────────────┐
│ Hiérarchie des rôles utilisateurs │
├────────────────────────────────────────┤
│ │
│ 👑 Administrateur │
│ │ │
│ ┌───────┴───────┐ │
│ ▼ ▼ │
│ 📢 Gestionnaire 🔧 Opérateur │
│ │ │ │
│ │ │ │
│ ▼ ▼ │
│ └──────────┬──┘ │
│ ▼ │
│ 👀 Lecteur │
└────────────────────────────────────────┘
🔌 Plugins et thèmes¶
Opérations groupées¶
Depuis la page "Plugins" ou "Thèmes" :
- Sélectionnez plusieurs éléments
- Choisissez l'action : Activer, Désactiver, Mettre à jour, Supprimer
- Appliquez aux sites sélectionnés
Gestion par site¶
Naviguez vers un site spécifique → onglet "Plugins"/"Thèmes" pour :
- 📥 Installer depuis WordPress.org ou uploader un ZIP
- ✅ Voir le statut actif/inactif
- 🔄 Mettre à jour les éléments individuellement
- 🔍 Rechercher dans le dépôt
┌─────────────────────────────────────────┐
│ Flux de gestion Plugins/Thèmes │
├─────────────────────────────────────────┤
│ │
│ Page Plugins/Themes │
│ │ │
│ ▼ │
│ ┌────────────────────┐ │
│ │ Sélectionner │ │
│ │ ☑ Plugin A │ │
│ │ ☑ Plugin B │ │
│ │ ☐ Plugin C │ │
│ └──────┬───────────┘ │
│ ▼ │
│ ┌────────────────────┐ │
│ │ Choisir action │ │
│ │ [Activer] [Désact] │ │
│ │ [Maj] [Supprim] │ │
│ └──────┬───────────┘ │
│ ▼ │
│ ┌────────────────────┐ │
│ │ ✅ Succès ! │ │
│ └────────────────────┘ │
└─────────────────────────────────────────┘
📊 Surveillance et sauvegardes¶
Vérifications de santé¶
WPForge vérifie périodiquement :
| Vérification | Description |
|---|---|
| 🌐 Disponibilité du site | Réponse HTTP 200 |
| ⏱️ Temps de réponse | Vitesse de chargement |
| 🔒 Certificat SSL | Validité du certificat |
| 💾 Espace disque | Stockage disponible |
Voir les données dans "Surveillance" → "Vérifications de santé"
Gestion des sauvegardes¶
Créer une sauvegarde¶
- Manuelle : Sélectionnez un site → "Sauvegardes" → "Créer une sauvegarde"
- Planifiée : Configurez dans les paramètres du site → "Planification"
Restaurer une sauvegarde¶
- Allez dans l'onglet "Sauvegardes" du site
- Localisez la sauvegarde souhaitée
- 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¶
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
- ✅ 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
- ✅ Vérifiez que mysqldump est installé (pour les sauvegardes DB)
- ✅ 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
Obtenir de l'aide¶
- 📂 Consultez les logs dans le répertoire
./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¶
| Raccourci | Action |
|---|---|
/? |
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
--urlpour des commandes spécifiques
┌─────────────────────────────────────────┐
│ Architecture Multisite │
├─────────────────────────────────────────┤
│ │
│ ┌─────────────┐ │
│ │ Réseau │ │
│ │ (Root) │ │
│ └─────┬─────┘ │
│ │ │
│ ┌───────┼───────┐ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌─────┐ ┌─────┐ ┌─────┐ │
│ │Sub1 │ │Sub2 │ │Sub3 │ │
│ └─────┘ └─────┘ └─────┘ │
└─────────────────────────────────────────┘
🔒 Bonnes pratiques de sécurité¶
- 🔄 Garder WPForge à jour — Récupérez régulièrement les dernières modifications
- 🔐 Utiliser des mots de passe forts — Pour WPForge et l'admin WordPress
- 🚫 Restreindre l'accès — Limitez l'accès réseau aux IPs de confiance
- 🔒 Activer HTTPS — Utilisez le template Nginx fourni avec SSL
- 💾 Sauvegardes régulières — Planifiez des sauvegardes automatisées
- 📊 Surveiller les logs — Consultez
./logs/pour toute activité inhabituelle
Mis à jour par Johnny Fontaine il y a environ 2 mois · 28 révisions verrouillé