Traduction assistée par IA. Le contenu original a été rédigé en anglais.
Chaque remise de projet WordPress se termine de la même façon.
Le site est mis en ligne. Le client reçoit ses accès. Vous lui faites visiter wp-admin en appel vidéo, partagez un enregistrement d'écran, peut-être quelques notes. Deux semaines plus tard : « Hey, une question rapide, comment j'ajoute un nouvel article déjà ? »
Ce n'est pas la faute du client. WordPress n'est pas un outil simple, et une démonstration en appel vidéo est une mauvaise façon d'apprendre un nouveau logiciel. Vous regardez quelqu'un d'autre conduire en essayant de mémoriser le trajet. L'enregistrement se retrouve dans les favoris et n'est jamais regardé. La documentation est ignorée.
Ça arrive sur tous les projets. Ce n'est pas un problème de client. C'est un problème de remise.
Ce qu'on a essayé d'abord
On a essayé une meilleure documentation. Sans succès. La documentation se trouvait ailleurs, alors que le client était déjà devant wp-admin en train d'essayer de faire quelque chose. Décalage de contexte.
On a essayé des enregistrements plus courts, centrés sur une seule tâche. Mieux, mais les clients devaient quand même retrouver la bonne vidéo pour ce qu'ils essayaient de faire, et la plupart ne le faisaient pas.
On a essayé d'annoter des captures d'écran et de créer des guides étape par étape dans Notion. Ces guides ont tenu jusqu'à la première mise à jour d'une extension qui a déplacé un élément de menu.
Rien n'a résolu le problème fondamental : le guide se trouvait ailleurs, alors que le client en avait besoin ici, sur cet écran, pour faire cette chose, maintenant.
Ce qu'on a construit
WP Client Tour est un plugiciel WordPress qui affiche des visites guidées superposées dans wp-admin. Il se déclenche automatiquement lors de la première visite du client sur une page, lui montre exactement ce qu'il doit savoir, et ne réapparaît plus jamais.
La visite est stockée dans un fichier JSON. Un fichier par flux de travail. Vous déposez le fichier dans le répertoire /tours/ du plugiciel, et il s'exécute. Pas d'importation de base de données, pas de page de paramètres, pas d'interface d'administration à configurer. Le fichier JSON indique quelles pages la visite couvre, quels rôles d'utilisateur la voient, et ce que chaque étape dit. Les étapes 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 complétion. S'ils veulent revoir une visite, ils peuvent. Si une visite n'a pas encore été effectuée, elle apparaît comme disponible.
Le plugiciel est en ES6 pur, sous 15 ko, zéro dépendances externes, aucun appel à un CDN. C'est un petit logiciel qui fait une seule chose.
La partie rédaction par IA
Ce qui rend cela pratique, c'est la façon dont les visites sont rédigées. Rédiger le JSON à la main, avec des sélecteurs CSS pour chaque bouton et chaque panneau, prendrait plus de temps que l'appel vidéo qu'il remplace.
À la place : décrivez le flux de travail à un assistant IA (on utilise Claude Code, mais ChatGPT et Cursor fonctionnent aussi). L'assistant prend des captures d'écran de l'interface wp-admin réelle, identifie les éléments pertinents, et génère le JSON avec les sélecteurs et le texte. L'ensemble pour une visite standard « comment ajouter un article de blogue » prend environ cinq minutes.
Chaque sélecteur généré reçoit un indicateur de confiance : élevé, moyen ou faible. Les sélecteurs à faible confiance sont ceux à vérifier. En pratique, la plupart sont élevés pour les éléments d'interface WordPress standard.
Quand une mise à jour d'extension change quelque chose, vous relancez le flux de rédaction et remplacez le fichier JSON. Versionnable avec Git, portable, suivi aux côtés du projet.
Pourquoi c'est en code ouvert
On construit des outils qu'on utilise soi-même. WP Client Tour est né d'un vrai problème de remise sur un vrai projet. Une fois que ça fonctionnait, le publier avait plus de sens que de le garder en interne. Si d'autres développeurs ont le même problème, l'outil est là.
Il y a aussi une raison égoïste : les outils en code ouvert sont testés par des gens avec des configurations différentes, des thèmes différents, des combinaisons d'extensions différentes. Chaque cas limite qui remonte améliore l'outil qu'on utilise aussi.
Le plugiciel est gratuit, sous licence MIT, et se trouve à kingsbury-labs.github.io/wp-client-tour. Aucun compte requis, aucun abonnement, aucun enfermement propriétaire.
Pour qui c'est
Si vous construisez des sites WordPress pour des clients qui ne sont pas développeurs, c'est pour vous. Le plugiciel est particulièrement utile sur les sites avec des types de contenu personnalisés, plusieurs rôles d'utilisateur, ou tout flux de travail qui n'est pas immédiatement évident depuis l'interface wp-admin par défaut.
C'est aussi une bonne option pour les agences avec un flux d'accueil standard : rédigez les visites une fois, déposez-les dans chaque projet, et ne répétez plus jamais cet appel vidéo post-lancement.
Si vous êtes une entreprise de la vallée qui vient de lancer un site WordPress avec nous, votre administration a déjà des visites intégrées. C'est pourquoi vous n'avez pas reçu d'enregistrement d'écran.
Des questions sur le plugiciel ou sur notre processus de remise de projet : contactez-nous.