# WordPress — Skill OpenClaw

Gestion d'un site WordPress via WP REST API v2. Articles, pages, médias, commentaires, catégories, tags, recherche et utilisateurs.

## Prérequis

- **curl** + **jq** installés
- **WordPress 5.6+** avec REST API activée (par défaut)
- **Application Password** généré (Admin → Profil → Mots de passe d'application)
- Config initialisée dans `config.json` (voir `config.example.json`)

## Configuration

Créer `config.json` (ou ajouter dans TOOLS.md) :

```json
{
  "wordpress": {
    "url": "https://ton-site.com",
    "username": "admin",
    "app_password": "xxxx xxxx xxxx xxxx xxxx xxxx",
    "timeout": 30
  }
}
```

Variable d'environnement optionnelle :
- `WP_CONFIG` — chemin vers config.json
- `WP_LOG` — chemin vers le fichier de log

## Commandes

```bash
SCRIPTS="~/.openclaw/workspace/wordpress-skill/scripts"
```

### Connexion

```bash
# Tester la connexion
bash $SCRIPTS/wp-cli.sh test
```

### 📝 Articles (Posts)

```bash
# Lister les articles publiés
bash $SCRIPTS/wp-cli.sh posts

# Lister les brouillons
bash $SCRIPTS/wp-cli.sh posts draft

# Rechercher
bash $SCRIPTS/wp-cli.sh posts publish 10 "mot clé"

# Lire un article
bash $SCRIPTS/wp-cli.sh post 42

# Créer un brouillon
bash $SCRIPTS/wp-cli.sh create-post "Mon titre" "Contenu de l'article"

# Créer et publier directement
bash $SCRIPTS/wp-cli.sh create-post "Titre" "Contenu" publish

# Avec catégories et tags (IDs)
bash $SCRIPTS/wp-cli.sh create-post "Titre" "Contenu" draft "1,2" "3,4"

# Modifier
bash $SCRIPTS/wp-cli.sh edit-post 42 --title "Nouveau titre" --status publish

# Supprimer
bash $SCRIPTS/wp-cli.sh delete-post 42
```

### 📄 Pages

```bash
bash $SCRIPTS/wp-cli.sh pages
bash $SCRIPTS/wp-cli.sh page 5
bash $SCRIPTS/wp-cli.sh create-page "À propos" "Contenu..."
bash $SCRIPTS/wp-cli.sh delete-page 5
```

### 💬 Commentaires

```bash
# Commentaires en attente de modération
bash $SCRIPTS/wp-cli.sh comments hold

# Tous les commentaires
bash $SCRIPTS/wp-cli.sh comments any

# Approuver / Rejeter
bash $SCRIPTS/wp-cli.sh approve 15
bash $SCRIPTS/wp-cli.sh reject 15

# Répondre
bash $SCRIPTS/wp-cli.sh reply 15 "Merci pour votre commentaire !"

# Supprimer
bash $SCRIPTS/wp-cli.sh delete-comment 15
```

### 🏷️ Catégories & Tags

```bash
bash $SCRIPTS/wp-cli.sh categories
bash $SCRIPTS/wp-cli.sh create-category "Actualités" "actualites"
bash $SCRIPTS/wp-cli.sh tags
bash $SCRIPTS/wp-cli.sh create-tag "Tech"
```

### 🖼️ Médias

```bash
bash $SCRIPTS/wp-cli.sh upload /path/to/image.jpg
bash $SCRIPTS/wp-cli.sh upload /path/to/image.jpg 42  # attacher à l'article 42
```

### 👥 Utilisateurs

```bash
bash $SCRIPTS/wp-cli.sh users
bash $SCRIPTS/wp-cli.sh user 1
```

### 🔍 Recherche

```bash
bash $SCRIPTS/wp-cli.sh search "intelligence artificielle"
bash $SCRIPTS/wp-cli.sh search "guide" page
```

## Guidelines de rédaction

Quand l'agent rédige un article, il **doit** suivre les guidelines dans `references/writing-guidelines.md`. Les points clés :

- **Imperfections volontaires** — opinions tranchées, langage familier, paragraphes courts, doutes sincères
- **Structure non-IA** — anecdote en intro, verdict parfois en premier, pas de conclusion parfaite, mélanger sections
- **Anti-détection** — phrases de longueurs variées, pas de listes partout, pas de pros/cons séparés, pas de résumé final

### 🤖 Humanize

Le skill intègre le module **humanize-text** pour nettoyer les patterns d'écriture IA.

```bash
# Créer un article en le humanisant automatiquement
bash $SCRIPTS/wp-cli.sh create-post "Titre" "Contenu" draft "" "" true
```

Le humanize supprime les em-dashes, les phrases bateuses IA, simplifie le vocabulaire et rend le texte plus naturel.

---

## Gestion des erreurs

| Code | Cause | Action |
|------|-------|--------|
| 401 | Credentials invalides | Vérifier config.json |
| 403 | Permissions insuffisantes | Vérifier rôle utilisateur WP |
| 404 | Ressource inexistante | Vérifier l'ID |
| 500 | Erreur serveur WP | Vérifier les logs WordPress |
| Timeout | Serveur inaccessible | Vérifier URL + réseau |

Tous les appels sont loggés dans `~/.openclaw/workspace/.wordpress.log`.

## Cas d'usage agent

L'agent peut utiliser ce skill pour :

1. **Publier des articles** — "Publie un article sur [sujet]"
2. **Modérer** — "Montre les commentaires en attente" → "Approuve le 15"
3. **Rechercher** — "Cherche mes articles sur [thème]"
4. **Gérer le contenu** — "Passe l'article 42 en brouillon"
5. **Upload** — "Ajoute cette image à l'article 42"

## Références

- [endpoints.md](references/endpoints.md) — Liste complète des endpoints WP REST API v2
- [WP REST API Handbook](https://developer.wordpress.org/rest-api/)