O acesso FTP
O acesso FTP foi pensado para os alojamentos partilhados, que muitas vezes não oferecem SSH. Com ele, o Copilot percorre o código da loja e deposita lá, ficheiro a ficheiro, as alterações que você aprova — quando o módulo e a API não chegam.
Antes de começar
- O acesso FTP está aberto a todos os planos, Essencial incluído: não é preciso o modo programador.
- Precisa do endereço do servidor FTP, de um utilizador, de uma palavra-passe e da pasta da loja no servidor. O seu alojamento indica-os na sua área de cliente.
Criar um utilizador FTP dedicado
Não dê ao Copilot o identificador principal da sua alojamento: crie um utilizador reservado ao Copilot, limitado à pasta da loja. Retira-o com um clique quando já não quiser o acesso, sem tocar em mais nada.
Os ecrãs mudam de um alojamento para outro: se um nome for diferente, procure a secção «FTP» da sua área de cliente.
- Nome:
copilot(ou um nome que reconheça). Palavra-passe: longa e única, que não use em mais lado nenhum. - Pasta: a da loja (onde estão
index.phpe a pastathemes), e só essa. - Permissões: leitura e escrita nessa pasta. Nenhum direito de gerir outras contas ou outros sites.
Na OVH (alojamento web): na área de cliente, abra Web Cloud, o seu alojamento e o separador FTP - SSH. Clique em Criar um utilizador, dê-lhe um nome, uma palavra-passe e, como diretório raiz, a pasta da loja. O endereço do servidor e a porta aparecem no mesmo separador.
Na o2switch (e alojamentos com cPanel): no cPanel, abra Contas FTP e depois Adicionar conta FTP. Introduza o nome, a palavra-passe e, em Diretório, a pasta da loja. A ligação Configurar o cliente FTP da conta indica o servidor a usar para a ligação cifrada.
Na Ionos: na área de cliente, abra o seu alojamento, depois a secção FTP e SSH (ou SFTP e SSH) e crie um utilizador limitado à pasta da loja. Verifique que a sua oferta inclui FTP ou FTPS: algumas só oferecem SFTP (porta 22), que o acesso FTP do Copilot não sabe usar. Nesse caso, use o módulo ou o acesso SSH se a sua oferta o permitir.
Na maioria dos alojamentos partilhados, um utilizador limitado a uma pasta vê essa pasta como a sua raiz. No Copilot, introduza então / como pasta raiz — e não o caminho do sistema que o painel do alojamento mostra (/home/…): o servidor não o conhece a partir da sua conta.
Configurar o acesso
- Nas definições da loja, abra Acesso FTP.
- Indique o servidor, a porta (21 na maioria dos casos), o utilizador e a palavra-passe.
- Indique a pasta raiz da loja: muitas vezes
public_html,wwwouhtdocs. O Copilot nunca sai desta pasta. - Leia o aviso e assinale a caixa: o que o Copilot escreve por FTP é realmente executado na sua loja, sob a sua responsabilidade. Faça cópias de segurança antes de escrever e trabalhe primeiro numa pré-produção, quando tiver uma. Aceita-se uma única vez por loja; a data do seu acordo fica registada.
- Ative o acesso, guarde e clique em Testar a ligação.
O certificado do servidor
O Copilot tenta sempre primeiro uma ligação cifrada (FTPS). No primeiro teste, mostra-lhe a impressão digital do certificado apresentado pelo servidor, antes de enviar qualquer palavra-passe. Compare-a com a que o seu alojador indica e depois aceite-a. Se este certificado mudar um dia, o Copilot recusa-se a ligar e di-lo.
Percorrer os ficheiros
Depois de testada a ligação, o navegador de ficheiros mostra o código da loja só de leitura: pastas, ficheiros, conteúdo dos ficheiros de texto.
Alterar um ficheiro
As alterações pedem-se na conversa: «Adiciona esta regra ao ficheiro .htaccess», «Corrige esta linha no modelo do rodapé». O Copilot lê o ficheiro, prepara a alteração e mostra as linhas que mudam. Você aprova; o ficheiro é escrito; o conteúdo anterior é guardado para o botão Desfazer.
O Copilot escreve um ficheiro de cada vez e não elimina nenhum ficheiro por FTP.
O que o Copilot faz por FTP, e o que nunca faz
O que faz
- Percorrer as pastas e ler os ficheiros de texto (até 512 KB), só em leitura.
- Escrever um ficheiro de cada vez, após a sua aprovação: envia-o, volta a lê-lo para verificar que o servidor recebeu exatamente o que foi enviado e guarda o conteúdo anterior para o botão Anular.
- Dizer-lhe claramente quando o servidor recusa (permissões, pasta em falta, disco cheio, ligação demasiado lenta) em vez de o deixar pensar que está feito.
O que nunca faz
- Apagar um ficheiro ou uma pasta. A única remoção possível é a de um ficheiro que o Copilot acabou de criar, quando clica em Anular.
- Criar, mudar o nome ou mover uma pasta, nem alterar permissões.
- Ler ou enviar um ficheiro binário (imagem, arquivo, base de dados) ou com mais de 512 KB: assinala-o.
- Sair da pasta raiz que indicou.
- Escrever sem a sua aprovação: uma escrita FTP nunca é automática, mesmo que tenha pedido para não ser consultado noutras ações.
- Ligar-se sem cifra se não o escolheu, nem enviar a sua palavra-passe a um servidor cujo certificado é desconhecido ou mudou sem que o tenha aceitado.
- Mostrar ou devolver a sua palavra-passe: é guardada cifrada e não aparece em lado nenhum.
Retirar o acesso
O botão Eliminar o acesso FTP apaga a palavra-passe e o certificado guardados.