Documentation

Piloter une extension de bout en bout : assistants, objets, actions

Régler une extension ne suffit pas toujours. Pour « configurer Complianz », il faut aussi terminer son assistant, générer la politique de cookies et mettre la bannière aux couleurs du site. L'IA sait faire tout cela par l'outil extension_setup, en passant par les écrans et les classes de l'extension elle-même : vous retrouvez le résultat dans l'admin WordPress, à l'endroit habituel, comme si une personne l'avait fait.

Ce guide s'adresse aux agences qui gèrent le site. Pour installer, mettre à jour et régler une extension, voir Extensions et thèmes.

Ce que l'IA peut piloter

Le catalogue d'ellô-wp décrit 50 extensions et 6 thèmes courants (Complianz, Yoast, Rank Math, WooCommerce, WPForms, LiteSpeed Cache, UpdraftPlus, Polylang, Astra, Kadence…). En plus de leurs réglages, une fiche peut décrire trois choses :

Ce qui est piloté Exemples Ce que fait l'IA
L'assistant de configuration Complianz, Rank Math, Yoast, WooCommerce, WP Mail SMTP lit les questions qui restent, y répond, le termine
Les objets de l'extension bannière de cookies, formulaire, zone de livraison, taux de taxe, langue, groupe de redirections, groupe de champs, palette de couleurs d'un thème les liste, les lit, les crée ou les modifie, les supprime si la fiche le permet
Les actions nommées générer les documents, purger le cache, lancer une sauvegarde, optimiser les images, envoyer un e-mail de test les lance, ou vous dit où le faire vous-même

L'IA commence toujours par demander ce que la fiche couvre sur votre site (action status) : assistant terminé ou non, types d'objets, actions et leur niveau, gestes qui restent à faire par une personne.

Une extension sans fiche de pilotage reste réglable par ses réglages (extension_settings) et par les réglages prêts à l'emploi (configure_plugin : bandeau cookies, GA4, pixel Meta, SEO).

L'assistant de configuration

  1. L'IA lit les questions encore visibles, par étape (wizard_get). Certaines dépendent d'autres réponses : ellô-wp calcule lui-même celles qui s'affichent et celles qui sont obligatoires.
  2. Elle propose des réponses tirées du site (nom, e-mail d'administration, adresse du site), toujours comme des suggestions, jamais écrites seules.
  3. Elle répond (wizard_answer) ; chaque réponse est relue dans l'extension après l'écriture.
  4. Elle termine l'assistant (wizard_finish). Tant qu'une question obligatoire reste sans réponse, ellô-wp refuse de terminer (wizard_incomplete) et donne la liste.

Une option réservée à une autre édition de l'extension (version payante) est refusée avec un message clair : c'est l'extension qui le dit, jamais un test « si Pro » d'ellô-wp.

Les questions juridiques : c'est vous qui répondez

Certaines questions engagent votre responsabilité : régions où vous recevez des visiteurs, finalités des données, données sensibles, adresse et pays de l'organisation. La fiche les marque comme juridiques.

  • L'IA ne les invente jamais. Elle vous les pose, peut vous proposer une réponse, et c'est vous qui décidez.
  • Elle n'envoie vos réponses qu'en précisant qu'elles viennent de vous (answered_by: "person"). Sans cela, ellô-wp refuse (person_answer_required) et redonne la liste des questions concernées.
  • La réponse de l'outil répète ce qui a été écrit, et le journal attribue ces réponses à la personne (dashboard, Journal : « Réponses données par la personne »).

Les objets

Une bannière, un formulaire, une zone de livraison : ce sont des objets rangés par l'extension dans ses propres tables ou types de contenu. ellô-wp les écrit par la classe ou la route de l'extension, jamais par une requête directe en base.

  • Créer ou modifier (object_set) : seules les propriétés listées dans la fiche sont écrites ; les autres sont refusées avec la liste des propriétés permises. Chaque écriture garde l'état d'avant au journal.
  • Aux couleurs du site (style_from_kit) : pour un objet qui le permet (la bannière de Complianz, la palette d'un thème comme Kadence, Blocksy ou GeneratePress), ellô-wp lit les couleurs globales du kit Elementor et choisit des couleurs lisibles (contraste d'au moins 4,5:1). Si l'objet n'a pas de réglage de police, l'IA vérifie que le texte suit la typographie du site et vous le dit ; une CSS propre à l'extension n'est proposée qu'avec votre accord.
  • Supprimer (object_delete) : seulement si la fiche le permet, toujours après votre accord. Une suppression en masse ou une remise à zéro reste un geste à faire vous-même.
  • Annuler (revert) : quand l'objet se relit entièrement, ellô-wp le réécrit tel qu'il était, par la même voie. Il refuse si quelqu'un l'a modifié entre-temps (rien n'est écrasé) ; un objet créé par l'IA se supprime dans l'écran de l'extension.

Objets visibles sur tout le site. Une bannière de cookies, une zone de livraison ou une langue agissent sur tout le site, et l'extension n'en garde pas de brouillon. Les écrire demande donc le droit Écrire en direct (publish.live) ; sans lui, l'IA vous dit qui peut le faire, plutôt que de simuler une copie brouillon.

Objets qui exécutent du code (extraits de WPCode ou de Code Snippets, par exemple) : c'est du code en dur, même par la classe officielle de l'extension. La règle « jamais en dur » s'applique (voir plus bas).

Les actions

Chaque action a un niveau, fixé par la fiche :

Niveau Quand Ce que fait l'IA
auto action locale, sans risque, qu'on peut relancer (purger un cache) la lance
confirm action longue, coûteuse, qui consomme des crédits, agit sur un service distant ou touche à beaucoup de contenus (sauvegarde, optimisation en masse, indexation) vous explique ce qui va se passer, attend votre oui, puis la lance
human geste réservé à une personne (voir plus bas) ne la lance jamais et vous donne l'écran exact

Une action longue (optimiser toutes les images, indexer, sauvegarder) part en tâche de fond : l'IA reçoit un numéro de tâche et suit l'avancement (get_job_status).

Une action qui crée une page (les documents légaux de Complianz, par exemple) suit la règle d'écriture d'ellô-wp : sans le droit Écrire en direct, la page est créée en brouillon et la réponse le signale (created_as_draft) ; avec ce droit, elle est publiée et une révision est créée.

Ce qui reste à faire par vous

Certains gestes ne sont jamais faits par ellô-wp. La réponse les renvoie en étapes humaines (human_steps), avec l'écran exact et ce qu'il faut préparer ; l'IA reprend ensuite en relisant l'état de l'extension :

  • se connecter à un compte distant (Google, WordPress.com, Jetpack, Stripe, PayPal…) ;
  • saisir ou lire une clé, une licence, un mot de passe, un jeton ;
  • accepter les conditions d'un service tiers (le service de description des cookies de Complianz, par exemple) ;
  • payer ou activer une licence ;
  • restaurer une sauvegarde, remettre une extension à zéro, supprimer en masse ;
  • lancer le scan des cookies de Complianz depuis son écran.

Quand une extension refuse elle-même une opération à votre compte relié (Site Kit sans connexion Google, par exemple), ellô-wp ne la contourne pas : c'est aussi une étape humaine.

Les règles qui ne changent pas

  • Jamais une option entière. Une extension range souvent tous ses réglages dans une seule option. ellô-wp n'écrit que le réglage visé ; toute écriture qui remplacerait l'option entière est refusée (whole_option_refused), par cet outil comme par extension_settings.
  • Jamais en dur sans votre accord. Quand la seule voie est du code en dur (un extrait de code, une option que l'extension ne montre dans aucun écran), l'IA reçoit d'abord un refus qui explique ce qui serait codé en dur, où et comment l'enlever (hardcode_requires_consent). Elle doit vous le présenter ; elle ne peut relancer avec votre accord (acknowledge_hardcode: true) que dans la même conversation et dans les 30 minutes. Un accord donné sans ce refus préalable est rejeté (consent_not_requested) : l'IA ne peut pas se l'accorder seule. Voir aussi Code sur mesure.
  • Les interrupteurs IA des extensions restent fermés tant que vous n'avez pas dit oui (voir Extensions et thèmes).
  • Les textes de l'extension (libellés des questions, aides, messages) sont transmis à l'IA comme des données, jamais comme des consignes.
  • Versions vérifiées. Chaque voie dépend du code de l'extension. Si la version installée sort de la plage vérifiée par ellô-wp, la voie est refusée ou signalée, le temps de revérifier la fiche ; la veille d'ellô-wp ouvre alors une issue avec les voies à revérifier.

Pourquoi certaines extensions passent par l'admin

Certaines extensions (Complianz, Astra et leurs voisines) ne chargent leur code d'administration que dans l'admin WordPress, quand un administrateur y est connecté. Une requête ordinaire vers l'API de WordPress ne le trouve pas.

Pour ces extensions, ellô-wp envoie ses ordres par un second point d'entrée signé de l'extension ellô-wp Companion, dans l'admin du site (admin-ajax.php). Les ordres sont signés de la même façon que les autres, l'extension vérifie la signature avant toute chose et agit au nom de votre compte relié, avec ses droits. Rien ne change pour les visiteurs : ce point d'entrée ne fait rien sans une signature valide.

Si le pare-feu de votre hébergeur bloque ce point d'entrée, l'IA vous le dit (site_blocked_by_firewall) avec l'écran de l'hébergeur ; elle ne se rabat jamais en silence sur une autre voie.

L'extension ellô-wp Companion doit être à jour

Le pilotage demande une version récente de l'extension ellô-wp Companion. Vous n'avez en général rien à faire :

  • avant une modification, ellô-wp met à jour l'extension Companion d'un site en retard, puis reprend la demande. La liste des sites du dashboard affiche alors « Mis à jour à la demande » avec la date ;
  • une version plus ancienne se met à jour par les mises à jour automatiques de WordPress (voir Installer le plugin), ou à la main une fois pour les toutes premières versions ;
  • tant que l'extension n'est pas à jour, extension_setup répond plugin_outdated avec la marche à suivre, sans rien tenter d'autre.

Dans le dashboard

Dans le détail d'un site, carte Extensions et thème :

  • Pilotage : l'extension ou le thème a une fiche de pilotage ; survolez la pastille pour voir ce qui est couvert (assistant, types d'objets, nombre d'actions). Elle est orange tant que l'extension ellô-wp Companion du site n'est pas assez récente ;
  • Assistant à terminer : l'IA a commencé l'assistant sans le finir. Demandez-lui de le terminer, ou finissez-le dans l'admin WordPress.

Le Journal montre chaque réponse d'assistant, objet écrit ou supprimé et action lancée, avec l'état d'avant ; les réponses juridiques y sont marquées « Réponses données par la personne ».

Le droit nécessaire

  • Lire ce qui est couvert, les questions d'un assistant et les objets : Utiliser l'IA. Pour des objets qui contiennent des données personnelles (entrées de formulaires, par exemple), il faut aussi Lire les envois de formulaires (colonne Formulaires).
  • Répondre, terminer, écrire un objet, lancer une action, annuler : Gérer les extensions et les thèmes (colonne Extensions).
  • Écrire un objet visible sur tout le site, ou supprimer un objet : en plus, Écrire en direct (colonne En direct).

Votre compte WordPress relié doit aussi avoir les capacités que l'extension demande dans son propre écran (un administrateur les a).

Exemple : Complianz de A à Z

« Configure Complianz, génère la page cookies et mets la bannière à la charte. »

  1. status : l'IA voit que l'assistant n'est pas terminé, que la bannière est pilotable et que le scan des cookies reste un geste humain.
  2. wizard_get : elle lit les questions, propose le nom de l'organisation et l'e-mail tirés du site, et vous pose les questions juridiques (régions, finalités, adresse…).
  3. wizard_answer avec vos réponses et answered_by: "person", puis wizard_finish.
  4. action_run generate_documents : la politique de cookies est créée (en brouillon si vous n'avez pas le droit d'écrire en direct) ; l'IA peut proposer de l'ajouter au menu.
  5. object_set banner avec style_from_kit : la bannière prend les couleurs du kit, lisibles.
  6. Étapes humaines : lancer le scan des cookies et accepter le service de description des cookies, dans l'écran de Complianz.

Tout se retrouve dans l'écran de Complianz ; rien n'a été écrit en base à la main, rien n'a été codé en dur.

Quand l'IA ne peut pas

Ce que dit l'IA Pourquoi Que faire
Pas de fiche de pilotage L'extension n'est pas décrite en détail dans le catalogue L'IA règle ses réglages (extension_settings) ou passe par un réglage prêt à l'emploi.
Extension ellô-wp à mettre à jour (plugin_outdated) L'extension Companion du site est trop ancienne pour le pilotage Laissez ellô-wp la mettre à jour, ou mettez-la à jour depuis Extensions dans l'admin WordPress.
Réponse de la personne demandée (person_answer_required) Question juridique sans réponse de votre part Répondez vous-même ; l'IA relance avec vos réponses.
Assistant incomplet (wizard_incomplete) Une question obligatoire est restée sans réponse Répondez aux questions listées, puis terminez.
Geste humain seulement (human_only) Compte distant, clé, conditions d'un service, paiement, remise à zéro, suppression en masse Faites-le dans l'écran indiqué ; l'IA reprend ensuite.
Écran occupé (busy) Une personne a l'écran de l'extension ouvert (l'assistant de Complianz, par exemple) Fermez l'écran, puis relancez.
Option entière refusée (whole_option_refused) L'écriture remplacerait tous les réglages de l'extension L'IA écrit réglage par réglage.
Accord non demandé (consent_not_requested) L'IA a envoyé un accord au code en dur sans vous avoir présenté le refus Elle doit d'abord vous expliquer ce qui serait codé en dur ; dites oui ou non.
Créé en brouillon (created_as_draft) Page générée sans le droit d'écrire en direct Relisez le brouillon et publiez-le, ou demandez à quelqu'un qui a ce droit.
Changement modifié depuis (revision_conflict) Quelqu'un a modifié l'objet après l'IA L'IA relit l'état actuel avant de changer quoi que ce soit.
Pré-vol bloquant (preflight_blocked) Un obstacle ferait échouer l'opération (voir Diagnostic du site) Réglez l'obstacle, ou dites à l'IA de passer outre en connaissance de cause.

Exemples de demandes

  • « Qu'est-ce qu'ellô-wp sait piloter dans Rank Math sur ce site ? »
  • « Termine l'assistant de WooCommerce : boutique en France, euros, produits physiques. » (l'IA vous posera les questions qu'elle ne doit pas deviner)
  • « Crée une zone de livraison France métropolitaine avec la livraison gratuite dès 60 €. »
  • « Duplique le formulaire de contact de WPForms. »
  • « Purge le cache de LiteSpeed. »
  • « Lance une sauvegarde UpdraftPlus maintenant et dis-moi quand elle est finie. »
  • « Ajoute l'anglais comme deuxième langue dans Polylang. »
  • « Mets la bannière de cookies aux couleurs du site. »
  • « Annule le dernier changement fait sur la bannière. »
Tous les guides