Traduction assistée par IA. Le contenu original a été rédigé en anglais.
Chaque remise de projet WordPress se termine de la meme facon.
Le site est mis en ligne. Le client recoit ses acces. Vous lui faites visiter wp-admin en appel video, partagez un enregistrement d'ecran, peut-etre quelques notes. Deux semaines plus tard : « Hey, une question rapide, comment j'ajoute un nouvel article deja ? »
Ce n'est pas la faute du client. WordPress n'est pas un outil simple, et une demonstration en appel video est une mauvaise facon d'apprendre un nouveau logiciel. Vous regardez quelqu'un d'autre conduire en essayant de memoriser le trajet. L'enregistrement se retrouve dans les favoris et n'est jamais regarde. La documentation est ignoree.
Ca arrive sur tous les projets. Ce n'est pas un probleme de client. C'est un probleme de remise.
Ce qu'on a essaye d'abord
On a essaye une meilleure documentation. Sans succes. La documentation se trouvait ailleurs, alors que le client etait deja devant wp-admin en train d'essayer de faire quelque chose. Decalage de contexte.
On a essaye des enregistrements plus courts, centres sur une seule tache. Mieux, mais les clients devaient quand meme retrouver la bonne video pour ce qu'ils essayaient de faire, et la plupart ne le faisaient pas.
On a essaye d'annoter des captures d'ecran et de creer des guides etape par etape dans Notion. Ces guides ont tenu jusqu'a la premiere mise a jour d'une extension qui a deplace un element de menu.
Rien n'a resolu le probleme fondamental : le guide se trouvait ailleurs, alors que le client en avait besoin ici, sur cet ecran, pour faire cette chose, maintenant.
Ce qu'on a construit
WP Client Tour est un plugiciel WordPress qui affiche des visites guidees superposees dans wp-admin. Il se declenche automatiquement lors de la premiere visite du client sur une page, lui montre exactement ce qu'il doit savoir, et ne reapparait plus jamais.
La visite est stockee dans un fichier JSON. Un fichier par flux de travail. Vous deposez le fichier dans le repertoire /tours/ du plugiciel, et il s'execute. Pas d'importation de base de donnees, pas de page de parametres, pas d'interface d'administration a configurer. Le fichier JSON indique quelles pages la visite couvre, quels roles d'utilisateur la voient, et ce que chaque etape dit. Les etapes peuvent couvrir plusieurs pages d'administration avec une progression automatique.
Les clients disposent aussi d'un widget de tableau de bord avec la liste de toutes les visites disponibles et des coches de completion. S'ils veulent revoir une visite, ils peuvent. Si une visite n'a pas encore ete effectuee, elle apparait comme disponible.
Le plugiciel est en ES6 pur, sous 15 ko, zero dependances externes, aucun appel a un CDN. C'est un petit logiciel qui fait une seule chose.
La partie redaction par IA
Ce qui rend cela pratique, c'est la facon dont les visites sont redigees. Rediger le JSON a la main, avec des selecteurs CSS pour chaque bouton et chaque panneau, prendrait plus de temps que l'appel video qu'il remplace.
A la place : decrivez le flux de travail a un assistant IA (on utilise Claude Code, mais ChatGPT et Cursor fonctionnent aussi). L'assistant prend des captures d'ecran de l'interface wp-admin reelle, identifie les elements pertinents, et genere le JSON avec les selecteurs et le texte. L'ensemble pour une visite standard « comment ajouter un article de blogue » prend environ cinq minutes.
Chaque selecteur genere recoit un indicateur de confiance : eleve, moyen ou faible. Les selecteurs a faible confiance sont ceux a verifier. En pratique, la plupart sont eleves pour les elements d'interface WordPress standard.
Quand une mise a jour d'extension change quelque chose, vous relancez le flux de redaction et remplacez le fichier JSON. Versionnable avec Git, portable, suivi aux cotes du projet.
Pourquoi c'est en code ouvert
On construit des outils qu'on utilise soi-meme. WP Client Tour est ne d'un vrai probleme de remise sur un vrai projet. Une fois que ca fonctionnait, le publier avait plus de sens que de le garder en interne. Si d'autres developpeurs ont le meme probleme, l'outil est la.
Il y a aussi une raison egoiste : les outils en code ouvert sont testes par des gens avec des configurations differentes, des themes differents, des combinaisons d'extensions differentes. Chaque cas limite qui remonte ameliore l'outil qu'on utilise aussi.
Le plugiciel est gratuit, sous licence MIT, et se trouve a kingsbury-labs.github.io/wp-client-tour. Aucun compte requis, aucun abonnement, aucun enfermement proprietaire.
Pour qui c'est
Si vous construisez des sites WordPress pour des clients qui ne sont pas developpeurs, c'est pour vous. Le plugiciel est particulierement utile sur les sites avec des types de contenu personnalises, plusieurs roles d'utilisateur, ou tout flux de travail qui n'est pas immediatement evident depuis l'interface wp-admin par defaut.
C'est aussi une bonne option pour les agences avec un flux d'accueil standard : redigez les visites une fois, deposez-les dans chaque projet, et ne repetez plus jamais cet appel video post-lancement.
Si vous etes une entreprise de la vallee qui vient de lancer un site WordPress avec nous, votre administration a deja des visites integrees. C'est pourquoi vous n'avez pas recu d'enregistrement d'ecran.
Des questions sur le plugiciel ou sur notre processus de remise de projet : contactez-nous.