Aide

Installer le plugin ellô-wp Companion

Ce guide s'adresse à la personne qui installe ellô-wp sur un site WordPress client : vous-même, ou une personne technique du côté du client. Compter cinq minutes. Prérequis du site : PHP 7.4 ou plus avec l'extension sodium, WordPress 6.4 ou plus, Elementor 3.18 ou plus (Free suffit) et une adresse en HTTPS.

1. Télécharger le plugin

Dans votre espace ellô-wp, écran Sites, cliquez Télécharger le plugin (ou Télécharger l'extension dans « Premiers pas ») : vous obtenez le fichier ellowp-companion-<version>.zip de la dernière version publiée.

Vérifiez que le fichier fait quelques centaines de kilo-octets (pas quelques octets : un lien expiré ou une mauvaise version télécharge une page d'erreur).

2. Installer et activer

  1. Dans l'admin WordPress du site client : Extensions → Ajouter → Téléverser une extension.
  2. Choisissez ellowp-companion-<version>.zip, cliquez Installer maintenant, puis Activer.
  3. Un nouveau menu ellô-wp apparaît dans la colonne de gauche de l'administration (icône le signe de la marque).
  4. Juste après l'activation, un avis « ellô-wp Companion est activé » s'affiche une fois en haut de l'écran : son bouton Connecter ce site mène directement à l'onglet ellô-wp.

Vous pouvez aussi déposer le dossier ellowp-companion/ extrait du zip dans wp-content/plugins/ par FTP ou SSH, puis activer depuis Extensions.

3. Connecter le site en un clic

  1. Ouvrez le menu ellô-wp : vous arrivez sur l'onglet Connexion.
  2. Vérifiez l'adresse du serveur repliée sous le bouton (app.ello-wp.com par défaut) ; ne la changez que pour un environnement particulier.
  3. Cliquez Connecter à ellô-wp. Vous êtes redirigé vers votre espace ellô-wp : connectez-vous si besoin, choisissez l'organisation, vérifiez le site proposé, puis cliquez Autoriser.
  4. Vous revenez automatiquement dans l'admin WordPress, avec le message « Site connecté à ellô-wp ». Le badge en haut de la page passe à Connecté.

Aucun mot de passe WordPress n'est demandé ni transmis : la connexion échange des clés de signature entre le site et ellô-wp : ellô-wp n'agit sur le site qu'avec des requêtes signées par ces clés. Si la redirection échoue (site sans navigateur sortant, environnement fermé), utilisez la section repliée Connexion manuelle avec un code : créez un code depuis votre espace ellô-wp, collez-le, validez.

Une fois connecté, le site apparaît dans l'écran Sites de votre espace ellô-wp, prêt à être piloté depuis Claude Code (Connecter Claude Code à ellô-wp).

4. Les trois onglets du plugin

  • Connexion : état de la connexion, serveur, version d'Elementor détectée, dernière requête reçue ; reconnecter ou déconnecter le site.
  • Utilisateurs et rôles (une fois connecté) : ce que peut faire chaque rôle WordPress, en résumé ; lien Gérer les droits détaillés vers la matrice complète dans le dashboard. Chaque personne peut aussi relier son propre compte WordPress à son compte ellô-wp depuis sa page Profil.
  • Réglages : trois interrupteurs.
    • ellô-wp actif — désactivé, plus aucune action de l'IA ni de l'éditeur en direct sur ce site (pratique pour une pause sans déconnecter).
    • Toujours passer par un brouillon pour l'IA — activé, toutes les écritures de l'IA arrivent en copie à relire, quel que soit le rôle connecté.
    • Éditeur en direct — affiche le bouton Éditer en bas des pages Elementor, pour les rôles ayant le droit de modifier les textes (guide client : Modifier les textes de votre site). Désactivé par défaut : à activer explicitement une fois le site prêt.

5. Mises à jour automatiques

Le plugin s'installe une seule fois à la main : ensuite, il se met à jour tout seul. Les mises à jour automatiques sont obligatoires pour ellô-wp Companion : dans Extensions, la colonne « Mises à jour automatiques » affiche « Mises à jour automatiques obligatoires », sans bouton pour les désactiver. Un site qui tourne avec une ancienne version du plugin est une faille possible et un site que l'IA pilote mal ; c'est pourquoi le choix n'est pas laissé.

Comment ça marche :

  • Quand WordPress vérifie ses mises à jour (deux fois par jour, par sa tâche planifiée, ou quand vous ouvrez Tableau de bord → Mises à jour), le plugin lit la dernière version publiée sur le serveur ellô-wp auquel le site est connecté (le serveur par défaut tant que le site n'est pas connecté). La réponse est gardée 12 heures ; Vérifier à nouveau force une nouvelle lecture. Rien de tout cela ne se produit pendant la visite d'une page publique.
  • La nouvelle version apparaît comme une mise à jour ordinaire ; le lien Voir les détails affiche ses notes de version. WordPress l'installe ensuite automatiquement, dans la journée, s'il la juge compatible (versions de WordPress et de PHP demandées).
  • Avant l'installation, le plugin télécharge lui-même le paquet et vérifie deux choses : l'adresse du paquet est en HTTPS sur le même serveur ellô-wp que celui configuré, et son empreinte SHA-256 est exactement celle publiée. Sinon, la mise à jour est refusée et la version en place continue de fonctionner.

Cas particuliers :

  • Sites qui bloquent les mises à jour : avec DISALLOW_FILE_MODS ou AUTOMATIC_UPDATER_DISABLED dans wp-config.php, WordPress n'installe rien tout seul. Mettez alors le plugin à jour à la main (téléchargement depuis la page Sites de votre espace, puis Téléverser une extension, qui remplace la version en place).
  • Versions 1.0.x : elles ne contiennent pas encore les mises à jour automatiques. Mettez-les à jour une fois à la main ; la page Sites de votre espace les signale par « Mise à jour à faire une fois à la main ».
  • Développement local : un serveur ellô-wp en http://localhost est accepté ; ailleurs, le HTTPS est exigé, sauf sur un site en WP_DEBUG. Une copie de travail du plugin (dossier contenant composer.json, ou lien vers le dépôt) n'est jamais remplacée par une mise à jour.

Ce que voit un visiteur du site

Rien. Tant que l'éditeur en direct n'est pas activé, ou pour un visiteur non connecté et non autorisé, le plugin n'ajoute ni script ni requête sur les pages publiques (règle non négociable du projet : rien n'est chargé pour les visiteurs). Vous pouvez vérifier ce point vous-même avec les outils de développement du navigateur (onglet Réseau) sur une page du site, avant et après l'installation : aucune différence.

Dépannage rapide

  • Le bouton « Connecter à ellô-wp » ne redirige nulle part : vérifiez que le site répond bien en HTTPS (sauf localhost) et que rien ne bloque les redirections sortantes (pare-feu, proxy) ; sinon, utilisez la connexion manuelle par code.
  • « Site suspendu » après connexion : suspension décidée côté ellô-wp (facturation, incident) ; contactez la personne qui gère l'organisation.
  • Le bouton « Éditer » n'apparaît pas après avoir activé l'éditeur en direct : vérifiez que le rôle de la personne connectée a bien le droit « Textes » dans l'onglet Utilisateurs et rôles, et que la page est bien construite avec Elementor.
Tous les guides