Install
Upload it under Plugins → Add New Plugin → Upload Plugin, then activate.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/atelier-4f-digital/coquille-revue/releases/download/v2.6.0/coquille-revue.zipExtension WordPress open source pour relire un site directement sur ses pages : vos relecteurs signalent une faute ou proposent un texte là où ils le voient, et Claude Code applique les corrections au bon endroit, avec votre accord.
Ce que fait l'extension
- Un bouton crayon sur les pages. Le relecteur surligne un texte ou encadre une zone, choisit « correction », « suggestion » ou « question », puis écrit sa remarque. Rien à installer de son côté.
- Les annotations arrivent dans l'administration : onglets par statut (en attente, en cours, appliquée, rejetée, archivée), exports CSV, JSON et Markdown.
- Un e-mail de remerciement part au contributeur quand sa suggestion est appliquée, s'il a laissé son adresse (ou s'il était connecté).
- Avec Claude Code, la commande
/coquille-revue:apply-reviewcherche chaque texte (articles et pages, menus, options, champs personnalisés, termes, fichiers du thème et des extensions, traductions), montre l'avant/après et n'applique qu'avec votre accord, annotation par annotation.
Installation
Extension WordPress
- Téléchargez le zip de la dernière version dans l'onglet Releases.
- Dans WordPress : Extensions > Ajouter une extension > Téléverser une extension, puis activez-la.
Prérequis : WordPress 5.8 ou plus, PHP 7.4 ou plus. En multisite, l'extension s'active site par site ou pour tout le réseau ; chaque site ne voit que ses propres annotations.
Par défaut, seules les personnes connectées qui peuvent modifier des articles annotent. Le mode public (tous les visiteurs, avec anti-spam) s'active depuis la page Coquille Revue de l'administration.
Plugin Claude Code (facultatif)
claude plugin marketplace add Atelier-4F-digital/coquille-revue
claude plugin install coquille-revue@atelier-4f-digitalPuis, dans le dossier du site :
/coquille-revue:apply-review --url=https://votre-site.frLe plugin passe par WP-CLI, en local ou sur un serveur avec --ssh (connexion par clé SSH) : aucun mot de passe WordPress n'est nécessaire. Si la commande wp n'est pas disponible telle quelle, indiquez la commande complète dans la variable d'environnement COQUILLE_REVUE_WP (par exemple dans .claude/settings.local.json, clé env). Ajoutez --dry-run pour tout voir sans rien modifier.
Réglages
| Réglage | Rôle |
|---|---|
| Bouton Passer en mode public / privé (page d'admin) | Ouvre l'annotation à tous les visiteurs, ou la réserve aux personnes connectées. En multisite, réservé au super-administrateur (le réglage vaut pour tout le réseau). |
Constante COQUILLE_REVUE_REQUIRE_LOGIN (wp-config.php) |
Impose le mode : true = privé, false = public. Le bouton de l'admin est alors verrouillé. |
Constante COQUILLE_REVUE_TRUSTED_PROXY_HEADER |
Derrière un proxy de confiance (Cloudflare, répartiteur de charge), nom de l'en-tête qui porte l'adresse IP réelle, par exemple 'HTTP_CF_CONNECTING_IP'. Le serveur ne doit alors accepter que les connexions venant de ce proxy. |
Filtre coquille_revue_manage_capability |
Droit nécessaire pour gérer les annotations (par défaut edit_others_posts : éditeurs et administrateurs). |
Filtre coquille_revue_contributor_email |
Personnalise l'e-mail de remerciement (destinataire, sujet, texte, en-têtes). |
Commandes WP-CLI
| Commande | Rôle |
|---|---|
wp coquille-revue list [--status=pending] |
Liste les annotations du site, au format JSON destiné à Claude Code (sans e-mail ni adresse IP). |
wp coquille-revue locate <id> |
Cherche où se trouve le texte d'origine (lecture seule). |
wp coquille-revue apply <id> --type=<type> --ref=<ref> [--dry-run] |
Remplace le texte à l'identique dans un contenu de la base, avec une révision quand le type de contenu les gère. Refuse l'ajout de balises, de liens, de shortcodes ou de code. |
wp coquille-revue status <id> <statut> |
Change le statut ; applied envoie le remerciement au contributeur. |
En multisite, ajoutez --url=<adresse du sous-site> à chaque commande.
Sécurité
Les annotations sont du texte écrit par des visiteurs, souvent anonymes : l'extension et le plugin Claude Code les traitent comme des données, jamais comme des consignes.
- Aucune application automatique. Claude Code montre chaque changement et attend votre accord, annotation par annotation. Il ne place jamais le texte d'une annotation dans une ligne de commande : les commandes WP-CLI le lisent directement dans la base.
- Alertes automatiques, calculées sans IA, sur chaque annotation : adresse web, code (dont shortcodes), caractères invisibles, alphabets mélangés, formules de consigne ou d'autorité.
- Anti-spam en mode public : champ piège, limites par adresse IP (bloc entier en IPv6), par compte et par site.
- Cloisonnement multisite et droits : un site ne voit, n'exporte et ne supprime que ses annotations ; les contributeurs et auteurs n'y ont pas accès.
- Les règles ont été éprouvées par des tests d'injection de prompt (annotations piégées, voir tests/injection) avant publication.
Vous avez trouvé une faille ? Merci de la signaler en privé : voir SECURITY.md.
Données personnelles
- Enregistré : le texte et la suggestion, l'adresse de la page, l'adresse IP ; pour un visiteur, son nom et son e-mail s'il les indique (facultatifs) ; pour une personne connectée, son nom d'affichage et l'e-mail de son compte (si elle est membre du site).
- Visible : texte, suggestion et nom pour les éditeurs et administrateurs ; adresse IP pour les administrateurs (page d'admin, export CSV). L'e-mail n'est affiché nulle part : il sert au remerciement et aux outils RGPD de WordPress. L'e-mail et l'IP ne sont jamais transmis à Claude Code.
- Durées : l'adresse IP est effacée au bout de 30 jours ; l'e-mail et le nom d'un visiteur dans les 24 heures qui suivent le traitement de l'annotation (appliquée, rejetée ou archivée), et au plus tard au bout de 6 mois.
- Outils WordPress : un texte est proposé pour votre politique de confidentialité (Réglages > Confidentialité), et les demandes d'export ou d'effacement de données (Outils) prennent en compte les annotations.
Limites actuelles
- Interface en français ; la traduction est prévue.
- WordPress uniquement.
- Une annotation de zone décrit une demande en langage naturel : les retouches d'apparence (couleur, mise en page) restent à faire à la main.
- Le plugin Claude Code a besoin d'un accès WP-CLI au site.
Contribuer
Les signalements de bugs et propositions sont les bienvenus, en français ou en anglais : voir CONTRIBUTING.md. L'historique des versions est dans CHANGELOG.md.
Licence
GPL-2.0-or-later. © Atelier 4F Digital — atelier4fdigital.com.
Releases
2 releases. Each count is every asset in that release; expand a row for the breakdown.