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.

Ce guide pratique vous accompagne au quotidien pour gérer vos sites WordPress avec WPForge.

---

## 🚀 Premiers pas

### Lancer la plateforme

```bash

# Terminal 1 : Backend

cd backend && source venv/bin/activate

uvicorn main:app --reload --host 127.0.0.1 --port 8000

# Terminal 2 : Frontend

cd frontend && npm run dev

```

### Accès

| Service | URL |

|---------|-----|

| Interface | http://localhost:5173 |

| API | http://127.0.0.1:8000 |

| Docs API | http://127.0.0.1:8000/docs |

### Connexion

1. Ouvrez http://localhost:5173

2. Connectez-vous avec vos identifiants

3. Changez votre mot de passe si premier accès

---

## 🌍 Ajouter un site

1. **Sidebar** → "Sites"

2. **Bouton** → "+ Nouveau site"

3. Remplissez le formulaire :

| Champ | Description |

|-------|-------------|

| Nom | Nom afficher du site |

| URL | URL WordPress (https://...) |

| Chemin WP-CLI | Si pas dans PATH |

| DB (optionnel) | Pour opérations directes |

4. **Enregistrer**

---

## 🔌 Gérer les plugins

### Méthode rapide

```

Sites → [Sélection] → Plugins

```

### Actions disponíveis

| Action | Résultat |

|--------|----------|

| ✅ Activer | Rend le plugin actif |

| ❌ Désactiver | Désactive sans supprimer |

| 🔄 Mettre à jour | Dernière version |

| 🗑️ Supprimer | Retire entièrement |

### Opérations groupées

1. Cochez plusieurs plugins

2. Sélectionnez l'action

3. Appliquer

---

## 🎨 Gérer les thèmes

Même principe que les plugins :

```

Sites → [Sélection] → Thèmes

```

Actions : Activer | Désactiver | Supprimer

---

## ⌨️ Terminal WP-CLI

Chaque site dispose d'un terminal intégré :

```

Sites → [Sélection] → Terminal

```

### Commandes utiles

```bash

wp plugin list              # Liste les plugins

wp plugin activate akismet  # Active un plugin

wp core update              # Met à jour WordPress

wp theme status             # État des thèmes

wp db optimize              # Optimise les tables

wp search-replace 'old' 'new' # Remplace en base

```

---

## 📸 Screenshots

Capturer l'état d'un site :

```

Sites → [Sélection] → 📸 Screenshots

```

Options :

- Frontend / Backend

- Sauvegarde automatique

---

## 💾 Sauvegardes

### Créer une sauvegarde

```

Sites → [Sélection] → Sauvegardes → + Créer

```

### Restaurer

```

Sites → [Sélection] → Sauvegardes

→ [Sélectionner] → Restaurer

```

> ⚠️ Confirmez avant restauration !

---

## 📊 Tableau de bord

Widgets disponibles :

- Nombre de sites actifs

- Santé système (CPU/RAM/Disque)

- Activité récente

- Actions rapides

---

## 👥 Utilisateurs

### Ajouter un utilisateur

```

Utilisateurs → + Ajouter

→ Nom / Email / Rôle / Mot de passe

→ Créer

```

### Rôles

| Rôle | Droits |

|------|---------|

| 👑 Admin | Tout |

| 📢 Manager | Sites uniquement |

| 🔧 Opérateur | Opérations uniquement |

| 👀 Lecteur | Consultation |

---

## 🔧 Dépannage rapide

| Problème | Solution |

|----------|----------|

| Cannot connect | Vérifier WP-CLI + URL |

| Backup failed | Espace disque + mysqldump |

| Update failed | Permissions + cache |

### Logs

```

./logs/

```

---

## ⌨️ Raccourcis clavier

| Touche | Action |

|--------|--------|

| `/?` | Aide |

| `g s` | Sites |

| `g u` | Utilisateurs |

| `g p` | Plugins |

| `g t` | Thèmes |

---