Atualizar, fazer backup, mudar de hospedagem

Atualizar o Éclair leva cinco minutos e nunca mexe nos seus conteúdos: eles ficam em pastas que a atualização deixa intactas. Este guia também explica como fazer backup do seu site com um clique, restaurá-lo e mudá-lo para outra hospedagem ou outro domínio, sem perder nenhuma página nem o seu posicionamento.

Como fazer backup do seu site?

Em Segurança › Backup, clique em Baixar backup. Você recebe um arquivo ZIP com duas pastas:

Por segurança, as chaves de API do assistente de IA, o histórico das conversas, as sessões e os contadores de login ficam fora do arquivo. Se a extensão zip não existir na sua hospedagem, copie simplesmente as pastas data/ e media/ por FTP.

Se você fez login há mais de 15 minutos, o Éclair pede sua senha de novo antes de criar o arquivo.

Como restaurar um backup?

1. Descompacte o arquivo no seu computador: ele contém data/, media/ e um arquivo LISEZ-MOI.txt (em francês, “leia-me”).
2. Por FTP, substitua as pastas data/ e media/ da sua instalação pelas do arquivo.
3. Faça login e vá em Configurações › Avançado › Limpar cache.
4. Se você usa o assistente de IA, cole de novo suas chaves de API em Configurações › Assistente de IA: elas não fazem parte dos backups.

Como atualizar o Éclair para uma nova versão?

Consulte primeiro o changelog para ver o que muda e depois baixe o novo arquivo na página Baixar.

1. Faça um backup em Segurança › Backup.
2. Por FTP, apague as pastas app/ e assets/ do seu site.
3. Envie as da nova versão, com index.php e .htaccess.
4. Não mexa em data/ (conteúdos, configurações, contas) nem em media/ (imagens).
5. Na administração, clique em Configurações › Avançado › Limpar cache.

Apagar antes de enviar evita manter arquivos antigos que se tornaram inúteis, que a verificação de integridade sinalizaria. Para terminar, execute Segurança › Integridade dos arquivos › Analisar agora: tudo deve ficar verde.

Como mudar para outra hospedagem?

1. Baixe um backup e depois copie a pasta inteira do site por FTP, incluindo os arquivos ocultos .htaccess.
2. Envie-a para a nova hospedagem, na pasta pública do domínio. Confira se o PHP está na versão 8.1 ou superior (8.3 recomendado).
3. Aponte o seu domínio para a nova hospedagem e depois espere a propagação do DNS (de alguns minutos a algumas horas).
4. Faça login e clique em Segurança › Verificar endereço do site.

Não há banco de dados para exportar nem reimportar: é uma das grandes vantagens de um CMS sem banco de dados.

Como mudar de nome de domínio?

Depois de copiar o site, altere o endereço em Configurações › Geral › Endereço oficial do site e depois verifique-o na página Segurança. Os links internos se adaptam automaticamente, inclusive se o site estiver instalado em uma subpasta. O sitemap, as URLs canônicas e o llms.txt passam a usar o novo endereço na hora.

Se o domínio antigo continuar ativo, redirecione-o com um 301 para o novo na sua hospedagem: seus visitantes e seu posicionamento vão junto. Lembre-se também de informar a mudança de endereço no Google Search Console, como explica o guia do Google sobre mudanças de site.

Dá para guardar os dados fora da pasta pública?

Sim, se a sua hospedagem permitir. Mova primeiro a pasta data/ para o local escolhido, depois copie o arquivo eclair-config.exemple.php com o nome eclair-config.php, ao lado do index.php, e informe o novo caminho:

<?php
defined('ECLAIR') || exit;

// Dados guardados fora da pasta pública.
define('ECLAIR_DATA', '/home/minhaconta/eclair-data');

Seus dados já estão protegidos duas vezes dentro da pasta pública. Esta opção acrescenta uma terceira barreira: eles deixam até de fazer parte da estrutura do site.

É preciso limpar o cache a cada alteração?

Não. O cache estático se limpa sozinho a cada alteração feita na administração e no horário previsto para um artigo agendado. Limpe-o à mão só depois de uma atualização ou de uma alteração de arquivos por FTP, em Configurações › Avançado › Limpar cache. O botão Reconstruir o índice e limpar o cache da página Segurança também repara o índice dos conteúdos, se for preciso.