Audit de reprise WordPress
Produire un état des lieux fiable d'un site WordPress que l'on s'apprête à reprendre. Le rapport sert à trois choses : chiffrer la reprise, embarquer rapidement l'équipe technique, et trancher entre maintien de l'existant et refonte. C'est un document interne : ton direct, pas de langue de bois commerciale.
La valeur de l'audit tient à deux choses : des faits vérifiés (pas de suppositions présentées comme des constats) et une interprétation utile (ce que ces faits impliquent en charge et en risque). Un inventaire sans interprétation ne permet pas de chiffrer.
Règle de sécurité : lecture seule
Les sites audités sont presque toujours en production et appartiennent au client. Ne rien modifier : pas de mise à jour, d'activation, de création de compte ou de mot de passe d'application, pas d'enregistrement de réglages, même si le back-office le propose et même si ce serait « mieux ». Une modification pendant un audit peut casser le site d'un client qui n'a encore rien signé. Le script fourni ne fait que des lectures (plus la connexion et la déconnexion).
Les identifiants ne doivent jamais apparaître dans la conversation ni sur une ligne de commande : le script les lit lui-même dans un fichier ou dans l'environnement. Ne pas afficher le contenu du fichier d'accès (ni cat, ni sed de masquage, qui échoue facilement). Si l'utilisateur colle un mot de passe dans la conversation, lui proposer de le mettre dans un fichier et lui rappeler de le changer après l'audit.
Déroulé
1. Déterminer les accès disponibles
Deux niveaux, qui se cumulent :
| Niveau | Ce qu'on a | Fiabilité |
|---|---|---|
| Public | L'URL du site | Partielle : on ne voit que ce que le site expose |
| Admin | Un compte administrateur du back-office | Complète sur les extensions, la configuration et les volumes |
Si l'utilisateur ne donne qu'une URL, lancer l'analyse publique sans attendre, puis signaler dans le rapport ce qu'un accès admin permettrait de confirmer. Ne pas bloquer l'audit en réclamant des accès.
2. Préparer le dossier d'audit
Rien ne s'écrit dans le dossier du skill ni dans un dépôt Git : les rapports, les données collectées et les accès contiennent des informations du client. Tout va dans le dossier d'audits de l'utilisateur, rangé par site puis par date :
<dossier d'audits>/
└── exemple.fr/
├── acces.env accès au back-office (jamais versionné)
└── 2026-11-16/
├── audit-exemple.fr-2026-11-16.md
├── presentation-exemple.fr-2026-11-16.pptx
└── donnees/ public.json, admin.json, presentation.json
Le dossier d'audits est celui que l'utilisateur indique dans sa demande, sinon la variable d'environnement WP_AUDIT_DIR. S'il n'est connu ni par l'un ni par l'autre, le demander avant de commencer, et suggérer de définir WP_AUDIT_DIR pour ne plus avoir à le préciser. Ne pas choisir un emplacement à sa place.
python3 <skill>/scripts/wp_audit.py init https://exemple.fr --dir "<dossier d'audits>"
La commande crée l'arborescence et renvoie les chemins à utiliser ensuite (dossier_donnees, rapport, presentation, fichier_acces), la liste des audits précédents du même site, et d'éventuels avertissements à relayer à l'utilisateur. Si elle signale des audits précédents, lire le plus récent : dire ce qui a changé depuis vaut mieux que de tout redécouvrir.
Accès au back-office. init crée un fichier acces.env à remplir (droits restreints au seul utilisateur) et indique s'il est déjà renseigné (acces_admin_renseignes). S'il ne l'est pas et que l'utilisateur dit disposer d'un accès admin, lui donner le chemin du fichier et lui demander de le compléter lui-même, puis de le confirmer. Ne jamais demander l'identifiant ou le mot de passe dans la conversation, et ne jamais écrire ces valeurs soi-même dans le fichier : ce qui passe par la conversation reste dans son historique. S'il n'a pas d'accès admin, continuer en analyse publique.
3. Collecter
Toujours commencer par l'analyse publique, même avec un accès admin : elle seule montre ce qui est exposé à l'extérieur (points d'exposition, CDN, poids des pages, sitemaps).
python3 <skill>/scripts/wp_audit.py --out "<dossier_donnees>/public.json" public https://exemple.fr
Avec un accès admin, ajouter :
python3 <skill>/scripts/wp_audit.py --out "<dossier_donnees>/admin.json" admin --env-file "<fichier_acces>"
Le fichier d'accès accepte clé=valeur ou clé: valeur, avec des noms souples : url_publique ou url, url_admin ou login_url (URL de connexion, souvent personnalisée), identifiant ou user, password ou mot_de_passe, ou encore app_password pour un mot de passe d'application existant. Les variables d'environnement WP_AUDIT_URL, WP_AUDIT_LOGIN_URL, WP_AUDIT_USER, WP_AUDIT_PASSWORD, WP_AUDIT_APP_PASSWORD fonctionnent aussi. La session ouverte est refermée en fin de collecte (session_fermee dans le résultat).
Pour vérifier l'état d'extensions relevées autrement (liste fournie par le client, capture d'écran) :
python3 <skill>/scripts/wp_audit.py plugins contact-form-7:5.7 woocommerce --search "Nom d'une extension"
Options utiles : --pages N (pages publiques échantillonnées, 8 par défaut), --sample N (contenus analysés par type, 100 par défaut), --delay S (délai entre deux requêtes vers le site, 0,35 s par défaut), --insecure (certificat invalide), --allow-http (site local sans HTTPS).
public --pagespeed ajoute les scores Lighthouse et les Core Web Vitals (mobile et ordinateur) via l'API PageSpeed Insights de Google. Cela transmet l'URL du site à Google : l'utiliser quand l'utilisateur demande une analyse de performance ou l'accepte, pas d'office sur un site confidentiel ou en préproduction.
Ménager le site. Le script espace volontairement ses requêtes : un audit trop rapide ressemble à une attaque, et le pare-feu du site peut bloquer l'adresse IP de l'auditeur, donc aussi son navigateur. Pour la même raison, ne pas relancer la collecte plusieurs fois de suite, ne pas baisser --delay, et limiter les vérifications manuelles complémentaires à quelques requêtes. Si le résultat contient alerte_blocage ou si le site se met à répondre 403 ou 429, arrêter : ne pas réessayer, ne pas changer d'agent utilisateur ni d'adresse. Prévenir l'utilisateur, qui devra peut-être demander au client de faire autoriser son adresse IP, et rédiger le rapport avec ce qui a déjà été collecté.
Lire les JSON en entier : chaque section alimente une partie du rapport.
Si la collecte admin échoue (captcha, double authentification, pare-feu qui bloque l'API REST), ne pas insister ni contourner la protection : passer à la collecte manuelle décrite dans references/collecte-admin.md (navigateur si disponible, sinon l'utilisateur colle les informations de « Santé du site »).
Si le site bloque l'analyse publique (403, page de vérification d'un pare-feu), le dire, et s'appuyer sur un navigateur si disponible ou sur ce que l'utilisateur peut fournir.
4. Interpréter
Les données brutes ne suffisent pas. Les points suivants demandent du jugement, et ce sont eux qui font la différence entre un inventaire et un audit.
Nature du thème. C'est le premier déterminant de la charge de reprise.
- Présent sur wordpress.org ou thème commercial connu (Divi, Avada, Astra, Kadence, Enfold, The7, Bridge…) : maintenu par un tiers, mais vérifier la licence et le retard de version.
- Thème enfant : les personnalisations sont dans l'enfant, dont il faudra lire le code.
- Absent de wordpress.org, nom proche de celui du client ou d'une agence, sans version ni auteur : thème sur mesure. Personne ne le maintient, il n'y a pas de documentation, et sa qualité est inconnue tant qu'on n'a pas lu le code. Le signaler comme l'inconnue principale du chiffrage.
theme.jsonou thème à blocs : site récent, édition complète du site.
Où vit le contenu. Détermine le coût d'une migration ou d'une refonte.
- Constructeur de pages (Elementor, Divi, WPBakery…) : contenu captif du constructeur, refonte = ressaisie ou conversion.
- Pages au contenu vide mais avec un modèle de page du thème, et ACF présent : le contenu est dans des champs personnalisés, la mise en page dans le code du thème. Structuré, donc migrable, mais totalement dépendant du thème.
- Éditeur classique ou blocs natifs : contenu portable.
- Shortcodes d'extensions dans les contenus : chaque shortcode est une dépendance à conserver.
Modèles de page, champs et blocs. Le rapport comme la présentation doivent dire comment le site est construit : thème, modèles de page sur mesure, types de contenu, champs personnalisés et blocs. Ne jamais se contenter de nommer le thème. Sources en mode admin : usage_sur_echantillon.modeles_de_page (modèles utilisés et nombre de pages), editeur_par_type, blocs_hors_coeur, shortcodes, blocs_enregistres_par_espace (un espace acf signale des blocs ACF), la section acf de sante_du_site (nombre de groupes de champs selon leur emplacement : base, JSON, PHP ; pages d'options ; registered_acf_blocks) et acf_groupes_de_champs (leurs noms). Quand il n'y a pas de blocs ACF, l'écrire : c'est une information sur la façon dont le site est fait. En mode public, les modèles de page se lisent dans le champ template des pages de l'API REST et les classes CSS du <body> ; le signaler comme partiel.
Types de contenu sur mesure. Ils révèlent le métier du site (annuaire, catalogue, événements…) et le volume de code spécifique. En mode admin, regarder types_non_exposes_rest, taxonomies_non_exposees_rest et menu_admin : beaucoup de thèmes sur mesure déclarent des types invisibles dans l'API REST. En mode public, les noms des sous-sitemaps (wp-sitemap-posts-<type>, <type>-sitemap.xml) et la structure des URL (/league/...) trahissent ces types : les relever même sans pouvoir les compter précisément.
État des extensions. Pour chaque extension, croiser l'origine, le retard de version et l'activité :
- fermée sur wordpress.org : à remplacer, c'est un risque de sécurité sans correctif possible ;
- aucune mise à jour depuis deux ans : abandonnée, à remplacer à terme ;
- absente de wordpress.org : premium (vérifier qui détient la licence et si elle sera transférée) ou développée sur mesure (code à lire) ;
- retard majeur : mise à jour risquée, à tester sur une copie ;
- extensions qui se recouvrent (deux SEO, deux caches, deux constructeurs) : signe d'empilement sans ménage ;
- extensions inactives : à supprimer, elles restent une surface d'attaque.
Les espaces de noms REST non identifiés, les mu_plugins, les drop-ins et les rôles utilisateurs sur mesure sont des indices de développement spécifique : les nommer et dire ce qu'ils suggèrent.
Licences. Chaque extension porte un champ licence : gratuite (dépôt wordpress.org), payante, ou hors dépôt à qualifier. Le rapport liste toutes les extensions, actives et inactives, réparties dans ces trois groupes, sans en omettre. Pour les payantes, chercher qui détient la licence et jusqu'à quand (la section ACF de sante_du_site le dit pour ACF Pro ; les écrans de licence des autres extensions, si l'accès le permet) et si une mise à jour est en attente (mise_a_jour_en_attente, lu sur l'écran des mises à jour, seule source fiable pour les extensions absentes de wordpress.org). Une licence au nom du prestataire sortant s'arrête avec lui : c'est un coût à prévoir. Le classement automatique est une aide : une extension « hors dépôt à qualifier » dont l'auteur est l'agence d'origine est du sur-mesure ; une extension gratuite peut avoir une version payante installée séparément. Ne pas inventer de tarifs.
Performance de la page d'accueil. La section performance_accueil mesure le délai de réponse du serveur, le poids et le nombre de ressources, la compression, le cache et les images. Chercher la cause plutôt que d'énumérer les chiffres : un délai de premier octet élevé avec un cookie de session ou un cache-control: no-store signifie qu'aucune page n'est mise en cache et que chaque visite sollicite PHP et la base ; un poids dominé par les images appelle un traitement des médias ; beaucoup de scripts bloquants renvoient au thème ou à un empilement d'extensions. Repères : premier octet sous 300 ms bon, au-delà de 800 ms lent (mesure connexion comprise, depuis un seul poste) ; page de plus de 3 Mo ou plus de 80 requêtes : lourde. Ces mesures ne sont pas des Core Web Vitals : ne parler de LCP, de CLS ou de « score » que si pagespeed_insights est présent, et dire d'où viennent les chiffres.
SEO. La section seo est un contrôle technique de la page d'accueil et des pages échantillonnées : balises titre et description, H1, canonique, indexation, robots.txt, sitemap, redirections, code 404, données structurées, balises de partage, textes alternatifs. Hiérarchiser : un noindex, un robots.txt qui bloque tout ou une variante www non redirigée sont graves ; un titre « Accueil » ou une description absente sont des manques courants et faciles à corriger. En mode admin, recouper avec le réglage de visibilité (blog_public dans sante_du_site), la structure des permaliens et l'extension SEO installée. Rester dans le périmètre : ce n'est pas un audit de positionnement, de mots-clés ni de liens entrants, et il faut le dire.
Santé du site. C'est une rubrique à part entière du rapport, pas une annexe. Deux sources en mode admin : sante_du_site_etat donne le verdict des tests de WordPress (critiques, recommandations, réussis) et sante_du_site les informations techniques brutes. Reprendre chaque test critique ou recommandé en disant ce qu'il signifie pour ce site et quoi faire, plutôt que de recopier le libellé de WordPress. Puis lire les informations techniques pour ce que les tests ne signalent pas : cache de code PHP saturé (opcode_cache_full), limite mémoire basse, WP_DEBUG_DISPLAY actif, absence de cache de page ou d'objets, mises à jour automatiques désactivées, répertoires non inscriptibles. Tous les tests n'ont pas le même poids : une extension inactive est une recommandation de ménage, un test de requête en boucle ou de tâches planifiées en échec peut expliquer des dysfonctionnements réels. En analyse publique seule, cette rubrique ne peut pas être établie : le dire, et la citer parmi ce qu'un accès admin apporterait.
Socle et hébergement. Versions de WordPress, PHP et base de données par rapport aux versions maintenues ; hébergeur ou CDN identifiable ; cache ; constantes de débogage ; mises à jour automatiques ; limite mémoire.
Exposition. L'énumération des utilisateurs, xmlrpc, readme.html, un debug.log public ou le listing des répertoires ne sont pas des failles démontrées : les présenter comme des points de durcissement, classés par importance. Ne pas dramatiser, ne pas tester d'exploitation.
Taille. Volumes de contenus par type, nombre de médias et poids des répertoires, taille de la base. Dire ce que cela implique concrètement : durée d'une migration, besoin d'un environnement de recette dimensionné, sauvegardes.
5. Évaluer la complexité et recommander
Lire references/grille-complexite.md et l'appliquer : une note par axe, justifiée par un fait relevé, puis un niveau global, une recommandation maintien ou refonte, et des éléments de chiffrage en fourchettes avec leurs hypothèses. Ne jamais donner un chiffre unique : l'incertitude fait partie du résultat, surtout quand le code n'a pas été lu.
6. Rédiger le rapport
Suivre la structure de assets/modele-rapport.md et enregistrer le rapport en Markdown au chemin rapport renvoyé par init.
Principes de rédaction :
- Distinguer le constaté du supposé. Chaque information porte implicitement ou explicitement sa source : vue dans le back-office, déduite de l'extérieur, ou hypothèse. En mode public seul, la liste des extensions est incomplète par nature (les extensions d'administration, de sauvegarde et de sécurité ne laissent aucune trace côté public, et une minification masque les autres) : l'écrire en tête de la section, et ne jamais conclure « le site utilise N extensions ».
- Les versions se lisent d'un coup d'œil. La version de WordPress, comparée à la dernière disponible, figure dans la synthèse et dans la fiche d'identité technique, avec celles de PHP et de la base de données quand elles sont connues. Si la version est masquée (analyse publique), l'écrire plutôt que de l'omettre.
- Commencer par la synthèse : en dix lignes, quelqu'un qui ne lit que cela doit connaître la nature du site, son état, le niveau de complexité, la recommandation et les trois principaux risques.
- Dire ce que les faits impliquent. « Thème sur mesure sans dépôt connu » est un constat ; « prévoir une phase de lecture du code avant tout engagement forfaitaire » est ce dont le chiffreur a besoin.
- Terminer par ce qui manque : les questions à poser au client et les accès à demander (code du thème, dépôt Git, hébergement, licences premium, sauvegardes, contrat du prestataire sortant) sont un livrable à part entière, car ils conditionnent la fiabilité du chiffrage.
- Ne pas recopier de données personnelles (noms, e-mails des utilisateurs) : les effectifs par rôle suffisent.
Après l'écriture du fichier, donner à l'utilisateur dans la conversation la synthèse en quelques lignes et le chemin du rapport.
7. Présentation client (sur demande)
Le rapport Markdown est interne. Quand l'utilisateur veut présenter l'audit au client (« une présentation », « des slides », « une version pour le client », « à montrer en réunion »), produire en plus une présentation .pptx avec scripts/make_slides.py, en suivant references/presentation-client.md, au chemin presentation renvoyé par init (sa description JSON va dans donnees/). Ce fichier s'importe dans Google Slides.
C'est un contenu réécrit pour un décideur non technique, pas le rapport converti : pas de charge en jours ni de prix, pas de grille de complexité, pas de jugement sur le prestataire sortant, pas de détail d'exposition exploitable. La référence explique quoi garder, la trame type et les limites de texte par diapositive.
Toujours écrire le rapport interne d'abord, même si l'utilisateur ne demande que la présentation : c'est lui qui garantit que la présentation repose sur une analyse complète, et l'agence en a besoin pour son devis. Si l'utilisateur n'a rien demandé pour le client, proposer la présentation en une ligne à la fin plutôt que de la produire d'office.
Limites à garder en tête
- Sans accès au code (FTP, SSH, dépôt), la qualité du thème et des développements sur mesure reste inconnue : l'audit mesure la surface, pas la dette interne. Le dire clairement plutôt que de la deviner.
- Les versions déduites de l'extérieur sont des indices (paramètre
ver=des fichiers), pas des certitudes. - Un site derrière un pare-feu applicatif peut répondre différemment à un script et à un navigateur.