# Téléchargement WP Agent Ready

**Distribution officielle du plugin WordPress WP Agent Ready.**

URL : https://wp-agent-ready.com/plugins/

## Dernière version disponible

La version actuelle et toutes ses informations techniques sont disponibles via l'endpoint :

- **Manifeste JSON** : https://wp-agent-ready.com/plugins/update.json
- **Archive ZIP** : https://wp-agent-ready.com/plugins/wp-agent-ready-v{VERSION}.zip

Le manifeste contient : `version`, `download_url`, `package_sha256`, `last_updated`, `requires` (WordPress mini), `requires_php` (PHP mini), `tested` (WordPress maxi testé).

## Caractéristiques du plugin

| Champ | Valeur |
|---|---|
| **Licence** | GPL v2+ (libre, open-source) |
| **Prix** | Gratuit, sans fonctionnalité premium |
| **WordPress mini** | 5.0+ |
| **PHP mini** | 8.0+ |
| **Tested up to** | WordPress 7.0 |
| **Format** | Archive ZIP |
| **Distribution** | Direct depuis ce site (futur dépôt WordPress.org prévu en v1.0) |

## Vérification d'intégrité SHA-256

Chaque archive ZIP est publiée avec son empreinte SHA-256 dans `update.json`. Le **updater interne du plugin** vérifie automatiquement cette empreinte à chaque mise à jour.

Pour vérifier manuellement après téléchargement :

```bash
# Linux / macOS
sha256sum wp-agent-ready-v{VERSION}.zip

# Windows PowerShell
Get-FileHash wp-agent-ready-v{VERSION}.zip -Algorithm SHA256
```

L'empreinte doit correspondre exactement à celle annoncée dans `update.json`.

## Installation en trois étapes

### 1. Télécharger l'archive

Cliquer sur le bouton de téléchargement sur la page `/plugins/`. Vous obtiendrez un fichier nommé `wp-agent-ready-v{VERSION}.zip`.

### 2. Uploader dans WordPress

Dans l'admin WordPress :

1. Aller dans **Extensions → Ajouter**
2. Cliquer sur **Téléverser une extension**
3. Sélectionner le fichier `.zip` téléchargé
4. Cliquer sur **Installer maintenant**
5. Cliquer sur **Activer l'extension**

### 3. Configurer

Un **assistant de configuration en 4 étapes** se lance automatiquement à la première activation. Il vous guide pour :

- Activer la génération du `llms.txt` à la racine
- Activer la génération automatique des fichiers Markdown pour chaque article et page
- Activer le filtrage HTTP des robots IA via `.htaccess` (optionnel)
- Activer le partage anonyme avec l'observatoire communautaire (opt-in, optionnel)

Tous les réglages sont **ajustables ensuite** depuis **Configuration → WP Agent Ready** dans l'admin.

## Mise à jour automatique

Le plugin embarque son propre **updater interne** qui :

1. Consulte `https://wp-agent-ready.com/plugins/update.json` toutes les 12 heures
2. Compare la version locale avec la version distante
3. Si une nouvelle version est disponible, affiche un avis dans **Tableau de bord → Mises à jour**
4. Lors de la mise à jour, télécharge le ZIP et vérifie son empreinte SHA-256 avant installation
5. En cas d'échec de vérification, **refuse la mise à jour** et garde la version installée

Sécurité :
- Pinning de l'hôte de mise à jour (`wp-agent-ready.com` uniquement)
- HTTPS obligatoire (refus si certificat invalide)
- Vérification SHA-256 obligatoire avant écrasement
- Aucune télémétrie envoyée pendant la check (uniquement consultation du JSON public)

## Endpoints techniques de distribution

Pour les développeurs et les outils d'audit :

| Endpoint | Description | Cache |
|---|---|---|
| `https://wp-agent-ready.com/plugins/update.json` | Manifeste consulté par l'updater interne | 5 min |
| `https://wp-agent-ready.com/plugins/wp-agent-ready-v{VERSION}.zip` | Archive versionnée téléchargeable | 1 an immutable |
| `https://wp-agent-ready.com/plugins/` | Page humaine de téléchargement | 1 h |

Toutes les archives anciennes versions restent disponibles indéfiniment pour permettre le rollback.

## Compatibilité et dépendances

### Compatible avec

- Tous les thèmes WordPress (block themes et classic themes)
- Yoast SEO, Rank Math, All in One SEO (cohabitation testée)
- WP Rocket, W3 Total Cache, LiteSpeed Cache (cohabitation testée)
- WPML, Polylang (sites multilingues testés)
- WooCommerce (sites e-commerce testés)
- Cloudflare (avec configuration appropriée pour ne pas cacher les `.md`)

### Incompatibilité connue avec

- **« 404 to 301 »** : ce plugin intercepte les 404 sur `/wp-content/` et peut bloquer la livraison des `.md` d'archives. Désactiver pendant la configuration de WP Agent Ready, puis ajouter les exclusions nécessaires.

### Tables de base de données

WP Agent Ready respecte le **table prefix WordPress** défini dans `wp-config.php`. Ne fait aucune assumption sur le préfixe (compatible avec les sites utilisant un préfixe custom comme `wpk_`).

Aucune nouvelle table créée. Le plugin utilise uniquement les options WordPress standards et les logs serveur internes.

## Désinstallation propre

Lors de la désinstallation depuis l'admin WordPress :

1. Tous les fichiers `.md` générés sont supprimés
2. Le `.htaccess` est nettoyé des règles ajoutées par le plugin
3. Les options WordPress liées au plugin sont supprimées
4. Le `llms.txt` à la racine est supprimé
5. Les fichiers d'archive `.md` (`category-*.md`, `tag-*.md`, etc.) sont supprimés

Le site revient exactement à son état d'avant installation. **Aucune trace résiduelle**.

## English summary

WP Agent Ready WordPress plugin distribution page. The plugin is free (GPL v2+) and compatible with WordPress 5.0+ and PHP 8.0+. Latest version metadata is available at https://wp-agent-ready.com/plugins/update.json with SHA-256 integrity check. The plugin includes a self-updater that verifies SHA-256 fingerprints before installation. Installation is manual upload through WordPress admin. Configuration is wizard-driven in 4 steps. Compatible with all SEO plugins, cache plugins, and major hosting providers (o2switch, OVH, etc.). Future WordPress.org submission planned for v1.0.

---

*Dernière mise à jour : 2 juin 2026*
