Public_Wiki

# <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 vous accompagne dans la gestion de vos sites WordPress avec 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)

---

## 🏁 Démarrage

### Accéder à la plateforme

Une fois le backend et le frontend lancés :

- 🖥️ API Backend : http://127.0.0.1:8000

- 🌐 Interface frontend : http://localhost:5173 (développement) ou votre domaine déployé

```

┌─────────────────────────────────────────┐

│         Points d'accès WPForge          │

├─────────────────────────────────────────┤

│                                         │

│   Appareil utilisateur                  │

│        │                               │

│        ▼                               │

│   ┌─────────────────────────────────┐  │

│   │      https://votre-domaine.com  │  │

│   └───────────────┬─────────────────┘  │

│                   │                    │

│           ┌───────┴───────┐            │

│           ▼               ▼            │

│      ┌────────┐    ┌──────────┐       │

│      │Frontend│    │   API    │       │

│      │ (Vite) │    │(FastAPI) │       │

│      └────────┘    └──────────┘       │

│                              │          │

│                              ▼          │

│                         ┌─────────┐      │

│                         │WP-CLI   │      │

│                         └─────────┘      │

└─────────────────────────────────────────┘

```

### 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 :

| 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

1. Cliquez sur "Sites" dans la barre latérale

2. Cliquez sur "Ajouter un site"

3. 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)

4. 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

1. Allez dans "Utilisateurs" dans la barre latérale

2. Cliquez sur "Ajouter un utilisateur"

3. Entrez le nom d'utilisateur, l'email, le rôle

4. Définissez un mot de passe ou envoyez un lien de réinitialisation

5. 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" :

1. Sélectionnez plusieurs éléments

2. Choisissez l'action : Activer, Désactiver, Mettre à jour, Supprimer

3. 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

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

### 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 `--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