Migrer un site WordPress connecté à ellô-wp

Ce guide s'adresse à la personne qui change l'adresse d'un site déjà connecté à ellô-wp : passage d'une adresse provisoire (localhost, sous-domaine de l'hébergeur) à un vrai domaine, changement de domaine, passage en https, changement d'hébergeur. Il couvre aussi le cas inverse : une copie du site (préproduction, sauvegarde restaurée ailleurs), qui ne doit jamais agir au nom de l'original.

Ce que fait ellô-wp quand l'adresse change

À la connexion, le plugin ellô-wp Companion retient l'adresse du site (home_url). Dès que l'adresse actuelle ne correspond plus (schéma, domaine, www, port ou chemin ; la casse du domaine, le port par défaut :443/:80, la barre finale et les paramètres d'URL ne comptent pas, exactement comme sur le serveur), le site passe en état « Adresse changée » :

les requêtes d'ellô-wp sont refusées (ellowp_site_moved), sauf la lecture du profil ; l'IA reçoit l'erreur site_moved avec la marche à suivre ;
les événements envoyés à ellô-wp (utilisateurs, rôles, extensions) sont mis en attente, sauf le signalement de l'adresse (ci-dessous) ;
le bouton « Éditer » disparaît des pages ;
l'admin WordPress passe en orange : badge « Adresse changée » dans l'en-tête ellô-wp, carte détaillée dans l'onglet Connexion (ancienne et nouvelle adresse, que faire), notice pour les administrateurs sur le tableau de bord (masquable jusqu'à la résolution) et sur les autres écrans ellô-wp ; deux choix : « Ce site a déménagé » ou « C'est une copie » ;
dès la première page d'admin ouverte à la nouvelle adresse, le plugin le signale à ellô-wp (événement signé address.reported, une fois par adresse, sans bloquer la page ni dépendre de WP-Cron). Ce signalement ne suffit pas : n'importe quelle copie de la base (avec la clé du site) pourrait l'envoyer. ellô-wp interroge donc l'adresse connectée : si elle répond encore « pas déplacé », le dashboard affiche seulement « Copie détectée » (avertissement, journal site.copy_detected) et le site d'origine continue de fonctionner (IA, connexion des clients) ; si elle ne répond plus pendant une heure, ou dit elle-même avoir changé d'adresse, le site porte le badge « Adresse changée » (liste des sites et fiche du site). Le badge apparaît aussi dès que ellô-wp reçoit un refus ou lit le profil du site.

Attention : tant que l'ancien site reste en ligne avec l'extension connectée, ellô-wp continue de parler à l'ancienne adresse (l'IA et l'éditeur y modifient l'ancien site). Répondez vite à la question « déménagement ou copie ».

Depuis les versions récentes du plugin, chaque requête d'ellô-wp signe aussi l'adresse du site visé (signature v2) : une requête signée pour un site est refusée par une installation connectée à une autre adresse. Une copie faite par migration garde l'adresse connectée de l'original ; c'est alors l'état « Adresse changée » qui la protège (seule la lecture du profil lui est permise).

De même, l'adresse retenue est gardée sous une forme que le rechercher-remplacer des outils de migration ne touche pas. Avant, All-in-One WP Migration, Duplicator ou wp search-replace réécrivaient aussi cette adresse : le plugin croyait n'avoir pas bougé et restait « Connecté ». Pour un site migré avec une ancienne version du plugin, la mise à jour suffit : le plugin signale son adresse, ellô-wp lui renvoie l'adresse connectée (signée par sa clé) et l'état « Adresse changée » apparaît des deux côtés.

Rien n'est perdu pendant cette pause : il suffit de répondre.

Avant la migration

Sauvegarde complète : fichiers (wp-content) et base de données, avec l'outil habituel (extension de sauvegarde, sauvegarde de l'hébergeur, ou wp db export). Vérifiez que la sauvegarde s'ouvre.
Prévenez les personnes qui utilisent l'IA ou l'éditeur en direct sur ce site : pendant la migration, ellô-wp refusera les modifications.
Notez l'ancienne et la nouvelle adresse exactes (avec ou sans www, en https).

Migrer

Copiez le site vers sa nouvelle adresse avec votre méthode habituelle : extension de migration (Duplicator, All-in-One WP Migration, Migrate Guru…), outil de l'hébergeur, ou manuellement (fichiers + base).
Remplacez les adresses écrites en dur dans la base. Les liens internes créés par ellô-wp sont dynamiques (balises Elementor : ils suivent la page visée, quel que soit le domaine) ; mais les images, les liens saisis à la main, les réglages d'extensions et le contenu des pages contiennent souvent l'ancienne adresse en clair.
- Avec WP-CLI, sur la nouvelle installation :
```
wp search-replace 'https://ancienne-adresse.fr' 'https://nouvelle-adresse.fr' --all-tables --precise --dry-run
wp search-replace 'https://ancienne-adresse.fr' 'https://nouvelle-adresse.fr' --all-tables --precise
wp elementor replace-urls https://ancienne-adresse.fr https://nouvelle-adresse.fr
wp elementor flush-css
wp cache flush
```
  Le premier passage (--dry-run) montre ce qui sera changé sans rien écrire. search-replace respecte les données sérialisées ; elementor replace-urls traite en plus les données Elementor (équivalent de « Elementor › Outils › Remplacer l'URL »).
- Avec une extension de migration : utilisez son étape de remplacement d'adresse (la plupart le font d'office), puis « Elementor › Outils › Remplacer l'URL » et « Régénérer les fichiers CSS ».
- Pour une adresse avec un chemin (http://localhost/mon-site → https://mon-site.fr), remplacez l'adresse complète, chemin compris.
Redirections : sur l'ancien domaine (s'il reste à vous), redirigez tout en 301 vers le nouveau, page par page (règle de l'hébergeur ou du serveur web, par exemple Redirect 301 / https://nouvelle-adresse.fr/ pour Apache). Pour des pages dont le chemin change, ajoutez les redirections dans le site (ellô-wp : outil manage_redirects, ou votre extension de redirections).
Réglages WordPress : dans « Réglages › Général », « Adresse web de WordPress » et « Adresse web du site » doivent afficher la nouvelle adresse (ou les constantes WP_HOME et WP_SITEURL dans wp-config.php). Enregistrez une fois « Réglages › Permaliens ».

Dire à ellô-wp que le site a déménagé

Connectez-vous à l'admin WordPress à la nouvelle adresse, menu ellô-wp. La carte « L'adresse de ce site a changé » affiche l'adresse connectée et l'adresse actuelle.
Cliquez « Ce site a déménagé ». Vous êtes envoyé sur votre espace ellô-wp (connexion demandée si besoin).
Un propriétaire ou un administrateur de l'organisation du site vérifie l'écran « Confirmer le déménagement » : ancienne adresse, nouvelle adresse, organisation. Cochez la confirmation puis cliquez « Confirmer le déménagement ». (S'il ne s'agit pas du bon site ou si c'est une copie, cliquez « Annuler ».)
Retour automatique sur WordPress : « Déménagement confirmé ». Le site a généré de nouvelles clés ; ellô-wp a mis à jour l'adresse du même site : son identifiant, son journal, les comptes reliés, les droits des rôles et les jetons MCP sont conservés. L'action apparaît au journal (site.move_authorized puis site.moved, avec l'ancienne et la nouvelle adresse).

La demande envoyée par le bouton est signée par la clé actuelle du site et vaut 5 minutes, une seule fois ; ellô-wp refuse si un autre site de l'organisation est déjà connecté à la nouvelle adresse (retirez-le d'abord).

Vérifications après le déménagement

Dashboard ellô-wp › Sites : le badge « Adresse changée » a disparu et l'adresse affichée est la nouvelle.
Depuis l'IA : « Donne-moi la vue d'ensemble du site … » répond sans erreur, puis une petite modification de test (en brouillon si besoin).
Sur une page du site, connecté avec un rôle autorisé : le bouton « Éditer » est revenu.
Admin WordPress › ellô-wp › Utilisateurs et rôles : les droits sont toujours affichés.
Quelques pages, images et liens ouvrent bien la nouvelle adresse (sinon, refaire le rechercher-remplacer sur l'adresse oubliée, par exemple la variante http:// ou www.).
L'ancienne adresse redirige vers la nouvelle.

L'ancienne installation après le déménagement

Avec une version récente du plugin, l'ancienne installation (restée à l'ancienne adresse avec ses clés) apprend que la connexion a été déplacée : juste après « Ce site a déménagé » si elle est joignable, sinon au plus tard à sa page d'admin suivante. Elle affiche alors le badge gris « Connexion déplacée » et, dans ellô-wp > Connexion : « La connexion ellô-wp de ce site a été déplacée vers <nouvelle adresse> le <date>. Ce site n'est plus piloté par ellô-wp. » Deux boutons, tous deux locaux (le nouveau site n'est ni contacté ni touché) : « Effacer les clés de ce site » et « Connecter ce site comme un nouveau site ». En attendant, elle refuse toute requête signée sauf le profil. La déclaration d'ellô-wp est signée et liée à l'adresse de cette installation : elle ne peut déconnecter ni le nouveau site ni une copie ailleurs.

Le cas d'une copie (préproduction, sauvegarde)

Une copie du site (staging chez l'hébergeur, restauration sur un poste) contient les clés du site d'origine. ellô-wp s'en protège : à sa nouvelle adresse, la copie passe en « Adresse changée » et ne répond plus, n'envoie rien et n'affiche pas « Éditer ». Elle ne peut donc jamais agir au nom de l'original.

Dans l'admin de la copie, menu ellô-wp, cliquez « C'est une copie » et confirmez : la copie est déconnectée et ses clés effacées ; le site d'origine continue de fonctionner normalement. Juste avant, la copie retire son signalement auprès d'ellô-wp (événement signé address.released, au mieux) : l'avertissement « Copie détectée » disparaît du dashboard. Il ne lève jamais un état « Adresse changée ». « Déconnecter ce site » fait de même sur un site dont l'adresse a changé ; sinon, il efface seulement les réglages locaux, sans contacter ellô-wp. Si vous voulez piloter la copie avec ellô-wp, connectez-la ensuite comme un nouveau site (« Connecter à ellô-wp »), éventuellement dans une autre organisation.

Ne cliquez jamais « Ce site a déménagé » sur une copie : l'original perdrait sa connexion (ses clés seraient remplacées par celles de la copie). En cas d'erreur, reconnectez l'original depuis son admin (« Remplacer la connexion »).

Cas particuliers

Retour en arrière : si l'adresse redevient celle d'origine (migration annulée), l'état « Adresse changée » disparaît de lui-même ; le badge du dashboard s'efface à la lecture suivante du profil (vue d'ensemble du site depuis l'IA).
Sites connectés avant cette version du plugin : l'adresse est retenue à la première requête d'ellô-wp après la mise à jour. Mettez le plugin à jour et faites une requête (vue d'ensemble du site) avant de migrer.
Passage en https seul : c'est un changement d'adresse ; suivez la même procédure (le rechercher-remplacer porte sur http:// → https://).

Tous les guides