L’accès FTP
L’accès FTP est fait pour les hébergements mutualisés, qui n’offrent souvent pas de SSH. Avec lui, Copilot parcourt le code de la boutique et y dépose, fichier par fichier, les modifications que vous approuvez — quand le module et l’API ne suffisent pas.
Avant de commencer
- L’accès FTP est ouvert à toutes les formules, Essentiel compris : aucun mode développeur n’est nécessaire.
- Il vous faut l’adresse du serveur FTP, un identifiant, un mot de passe et le dossier de la boutique sur le serveur. Votre hébergeur les indique dans son espace client.
Créer un utilisateur FTP dédié
Ne donnez pas à Copilot l’identifiant principal de votre hébergement : créez un utilisateur réservé à Copilot, limité au dossier de la boutique. Vous le retirez en un clic quand vous ne voulez plus de l’accès, sans toucher au reste.
Les écrans changent d’un hébergeur à l’autre : si un intitulé diffère, cherchez la rubrique « FTP » de votre espace client.
- Nom :
copilot(ou un nom que vous reconnaîtrez). Mot de passe : long et unique, que vous ne réutilisez nulle part. - Dossier : celui de la boutique (là où se trouvent
index.phpet le dossierthemes), et lui seul. - Droits : lecture et écriture dans ce dossier. Aucun droit de gérer d’autres comptes ou d’autres sites.
Chez OVH (hébergement web) : dans l’espace client, ouvrez Web Cloud, votre hébergement, puis l’onglet FTP - SSH. Cliquez sur Créer un utilisateur, donnez-lui un nom, un mot de passe et, comme répertoire racine, le dossier de la boutique. L’adresse du serveur et le port s’affichent dans le même onglet.
Chez o2switch (et les hébergements avec cPanel) : dans cPanel, ouvrez Comptes FTP, puis Ajouter un compte FTP. Saisissez le nom, le mot de passe et, dans Répertoire, le dossier de la boutique. Le lien Configurer le client FTP du compte donne le serveur à utiliser pour la connexion chiffrée.
Chez Ionos : dans l’espace client, ouvrez votre hébergement, puis la rubrique FTP et SSH (ou SFTP et SSH) et créez un utilisateur limité au dossier de la boutique. Vérifiez que votre offre propose bien le FTP ou le FTPS : certaines n’offrent que le SFTP (port 22), que l’accès FTP de Copilot ne sait pas utiliser. Dans ce cas, passez par le module ou par l’accès SSH si votre offre l’autorise.
Chez la plupart des hébergeurs mutualisés, un utilisateur limité à un dossier voit ce dossier comme sa racine. Dans Copilot, saisissez alors / comme dossier racine — et pas le chemin système que le panneau de l’hébergeur affiche (/home/…) : le serveur ne le connaît pas depuis votre compte.
Régler l’accès
- Dans les réglages de la boutique, ouvrez Accès FTP.
- Renseignez le serveur, le port (21 le plus souvent), l’utilisateur et le mot de passe.
- Indiquez le dossier racine de la boutique : souvent
public_html,wwwouhtdocs. Copilot ne sort jamais de ce dossier. - Lisez l’avertissement et cochez la case : ce que Copilot écrit par FTP s’exécute réellement sur votre boutique, sous votre responsabilité. Faites des sauvegardes avant d’écrire et travaillez d’abord sur une préproduction quand vous en avez une. Il s’accepte une seule fois par boutique ; la date de votre accord est enregistrée.
- Activez l’accès, enregistrez, puis cliquez sur Tester la connexion.
Le certificat du serveur
Copilot essaie toujours d’abord une connexion chiffrée (FTPS). Au premier test, il vous montre l’empreinte du certificat présenté par le serveur, avant d’envoyer le moindre mot de passe. Comparez-la avec celle que votre hébergeur indique, puis acceptez-la. Si ce certificat change un jour, Copilot refuse de se connecter et vous le dit.
Parcourir les fichiers
Une fois la connexion testée, le navigateur de fichiers montre le code de la boutique en lecture seule : dossiers, fichiers, contenu des fichiers texte.
Modifier un fichier
Les modifications se demandent dans la conversation : « Ajoute cette règle au fichier .htaccess », « Corrige cette ligne dans le gabarit du pied de page ». Copilot lit le fichier, prépare la modification et montre les lignes qui changent. Vous approuvez ; le fichier est écrit ; l’ancien contenu est gardé pour le bouton Défaire.
Copilot écrit un fichier à la fois, et ne supprime aucun fichier par FTP.
Ce que Copilot fait par FTP, et ce qu’il ne fait jamais
Ce qu’il fait
- Parcourir les dossiers et lire les fichiers texte (jusqu’à 512 Ko), en lecture seule.
- Écrire un fichier à la fois, après votre approbation : il l’envoie, le relit pour vérifier que le serveur a bien reçu ce qu’il a envoyé, et garde l’ancien contenu pour le bouton Défaire.
- Vous dire clairement quand le serveur refuse (droits, dossier absent, disque plein, connexion trop lente) au lieu de laisser croire que c’est fait.
Ce qu’il ne fait jamais
- Supprimer un fichier ou un dossier. Le seul retrait possible est celui d’un fichier que Copilot vient lui-même de créer, quand vous cliquez sur Défaire.
- Créer, renommer ou déplacer un dossier, ni changer des droits.
- Lire ou envoyer un fichier binaire (image, archive, base de données) ou de plus de 512 Ko : il le signale.
- Sortir du dossier racine que vous avez indiqué.
- Écrire sans votre approbation : une écriture FTP n’est jamais automatique, même si vous avez demandé à ne plus être interrogé pour d’autres actions.
- Se connecter en clair sans que vous l’ayez choisi, ni envoyer votre mot de passe à un serveur dont le certificat est inconnu ou a changé sans que vous l’ayez accepté.
- Afficher ou renvoyer votre mot de passe : il est conservé chiffré et n’apparaît nulle part.
Retirer l’accès
Le bouton Supprimer l’accès FTP efface le mot de passe et le certificat enregistrés.