thomas@hammoudi:~/dev$

mu-plugins maison

Des petits programmes WordPress maison, vérifiés avant chaque envoi

Vitesse, référencement, recherche : 37 mu-plugins, de petits programmes WordPress, font ce que les extensions ne savent pas faire, et un script vérifie chacun avant de l'envoyer.

en service · 37 mu-plugins en service sur le Blog en novembre 2026 · mis à jour en

Avant
Du code collé dans le thème, effacé à la prochaine mise à jour, ou une extension de plus.
Maintenant
37 fichiers, un besoin chacun, contrôlés par un script avant chaque envoi pour ne pas faire tomber le site.

Utile si vous gérez un site WordPress et aucune extension ne couvre tout votre besoin.

En 3 étapes

  1. Je décide qu'un besoin mérite son propre petit programme plutôt qu'une extension de plus, et Claude Code l'écrit dans un seul fichier.
  2. Un script vérifie le code PHP, garde la version en ligne pour un retour arrière, envoie le fichier et vide le bon cache.
  3. WordPress charge toujours ces fichiers avant le reste, et LiteSpeed (le cache du Blog) resert et refait les pages.
$ plugins-wordpress-maison --schema5 étapes · 3 faits maison

Du besoin à la page servie

01

Moi

mu-plugin ou extension ?

le besoin

02fait maison

Le mu-plugin

un besoin, un fichier

avecPHP

fichier

03fait maison

Le dépôt

PHP vérifié, cache vidé

avecPython

en ligne

04

Le chargement

chargé en premier

WordPress

pages

05

Les pages du Blog

servies, cache refait

LiteSpeed

À côté

fait maison

Le retour arrière

copie de l'ancienne version

avecPython

L'audit

35 relus, 34 utiles, 1 retiré

Un mu-plugin ne pardonne rien : PHP vérifié avant l'envoi.

  • fait maison
  • outil du marché
  • une personne

le détail, étape par étape

Pourquoi je l'ai fait

Sur le Blog, un thème et des extensions font l’essentiel du travail. Mais il reste toujours un truc qui coince : un réglage que l’extension n’expose pas, deux extensions qui se marchent dessus, une donnée qu’un de mes scripts doit lire. En juillet 2026, pour masquer l’image mise en avant d’une seule page, j’avais ajouté une règle CSS à la main. J’ai préféré une case à cocher dans le panneau de la page, pour être autonome : c’est devenu un mu-plugin.

Ce que ça fait, concrètement

Le Blog tourne avec 37 mu-plugins, tous écrits pour lui (compte relevé sur le serveur en novembre 2026). Rangés par famille :

  • Vitesse : l’image principale et le logo se chargent tout de suite, les photos suivantes juste avant d’arriver à l’écran. Après une purge du cache, le robot de LiteSpeed refait d’abord les pages les plus vues, d’après une liste tirée de Google Analytics.
  • Référencement et assistants IA : une seule description structurée par page, le plan du site pour les IA et une version texte des pages vidéo (voir le Blog lisible par les IA).
  • Contenu : le tirage du jour de l’accueil du Blog, la recherche instantanée et une case « Masquer l’image mise en avant » pour mes pages de séries photo.
  • Maintenance : la version exacte de PHP en service, lisible par les administrateurs, et les champs cachés des pages vidéo, que mes scripts peuvent corriger.

Comment ça marche, en détail

Fabrication : Audit d'octobre 2026 : 35 relus, 34 utiles, 1 retiré, 34 en-têtes réécrits

Un mu-plugin (pour must-use, « à utiliser d’office »), c’est un fichier PHP que WordPress charge toujours, avant tout le reste, et qu’on ne peut pas désactiver par erreur depuis l’administration. Pratique. Le revers : une seule faute de syntaxe dans l’un d’eux, et c’est tout le site qui tombe.

Chaque mu-plugin fait une seule chose, et son en-tête suit toujours le même modèle : un nom en clair, puis une phrase qui dit ce qu’il fait et pourquoi. Du coup, la liste des extensions dans l’administration se lit comme une documentation. Le code de presque tous est rangé avec le projet qui s’en sert, à côté de sa doc.

Pour l’envoi sur le serveur (le dépôt), je ne fais rien à la main. Un script Python vérifie la syntaxe, garde une copie de la version en ligne, envoie le fichier, puis vide le bon cache. S’il trouve une erreur de syntaxe, rien ne part.

Le dépôt en quatre gestes : syntaxe vérifiée, copie de l’ancienne version, envoi en FTPS, cache vidé pour ce seul fichier
  1. Le script passe le fichier à php -l, qui vérifie la syntaxe.
  2. Il garde une copie de la version en ligne : c’est mon retour arrière.
  3. Il envoie le fichier en FTPS, un envoi de fichiers chiffré.
  4. Il vide, pour ce seul fichier, le cache d’opcodes (la version compilée que PHP garde en mémoire), puis purge les pages en cache. Pour ça, il dépose un petit fichier PHP ponctuel, au nom tiré au hasard, qui fait le ménage et disparaît aussitôt.
Deux leçons d’octobre 2026 : vider le cache d’opcodes, ne purger que les pages

Sans vider le cache d’opcodes, PHP a continué d’exécuter l’ancienne version d’un mu-plugin que je venais pourtant de remplacer. Et une purge complète de LiteSpeed efface aussi les CSS et JavaScript regroupés : des pages resservies pointaient vers des fichiers disparus, et un visiteur tombait sur une page sans style. Depuis, le script ne purge que les pages.

L’audit d’octobre 2026 : 34 mu-plugins utiles, 1 retiré, 34 en-têtes réécrits

J’ai fait relire chaque mu-plugin de l’époque : son en-tête, ses points d’accroche dans WordPress (les moments où il intervient), les scripts qui s’en servent, les journaux du serveur, les tests publics. Sur 35, verdict : 34 utiles et 1 retiré, un outil d’audit des liens qui ne servait plus. Les 34 en-têtes ont été réécrits sur le modèle, et le site contrôlé juste après.

Le détail des réglages par famille : pages retentées, résumé pour assistants vocaux, écran de suivi de la recherche
  • Une page que le robot de LiteSpeed n’a pas réussi à mettre en cache est retentée au passage suivant, au lieu d’être écartée pour toujours.
  • Une seule description structurée par page, là où deux extensions en produisaient chacune une, concurrente.
  • Le court résumé destiné aux assistants vocaux se remplit tout seul à partir de l’extrait de chaque article.
  • La recherche instantanée a son écran de suivi dans l’administration.
  • Les index de séries utilisent le même tirage du jour que l’accueil.

Le rôle de chaque pièce

Les 5 étapes du schéma, une par une
  1. Moi Je décide de ce qui mérite un mu-plugin et de ce qui reste une extension.
  2. Le mu-pluginPHPfait maison Chaque fichier fait une chose, avec un en-tête qui dit ce qu'il fait et pourquoi. 37 en service : vitesse, référencement, contenu, maintenance.
  3. Le dépôtPythonfait maison Vérifie la syntaxe (une erreur et rien ne part), garde la version en ligne, envoie fichier, vide le cache d'opcodes pour ce seul fichier, puis purge les pages.
  4. Le chargementWordPress WordPress charge toujours les mu-plugins avant le reste, et on ne peut pas les désactiver par erreur depuis l'administration.
  5. Les pages du BlogLiteSpeed LiteSpeed met les pages en cache et les refait après une purge, les plus vues d'abord. Une purge de pages seules garde les CSS et JavaScript regroupés.

# à côté

  • Le retour arrièrePythonfait maison À chaque dépôt, le script garde une copie de l'ancienne version : c'est le retour arrière.
  • L'audit En octobre 2026, chaque mu-plugin a été relu : en-tête, points d'accroche, scripts qui s'en servent, journaux du serveur. Sur 35, verdict : 34 utiles, 1 retiré.

Ce que vous pouvez reprendre chez vous

Le dépôt en quatre gestes marche sur n’importe quel WordPress : vérifiez avec php -l avant l’envoi, gardez une copie de la version en ligne, videz le cache d’opcodes pour le seul fichier envoyé, et purgez les pages sans toucher aux CSS et JavaScript regroupés. Donnez aussi à chaque fichier un en-tête « ce que ça fait et pourquoi » : l’audit en est plus court. Mes fichiers restent privés : la plupart sont taillés pour mon thème et mes extensions.

Ce que j'en retiens

Un mu-plugin, on ne le désactive pas par erreur, mais il ne pardonne rien non plus. Alors je vérifie le PHP avant chaque envoi, sans exception. La petite phrase « pourquoi » de l’en-tête sert à l’audit : c’est elle qui dit si je garde ou si je retire un fichier, sans refaire toute l’enquête.

tous les projets