Guia de instalação

Instalar o Éclair CMS leva cerca de 3 minutos: não há banco de dados para criar nem arquivo de configuração para preencher. Você envia uma pasta para a sua hospedagem, abre o endereço do seu site e um assistente faz quatro perguntas. Este guia detalha cada etapa com capturas de tela e apresenta, depois, os primeiros ajustes a fazer.

O que você precisa para instalar o Éclair CMS?

De uma hospedagem web comum, como um plano compartilhado de poucos euros por mês. Nenhum banco de dados é necessário.

Praticamente todas as hospedagens compartilhadas são compatíveis: o2switch, OVH, Hostinger, IONOS, PlanetHoster… E não se preocupe: o assistente de instalação verifica tudo isso para você e explica o que corrigir.

Etapa 1: baixar o Éclair

Baixe o arquivo ZIP oficial e descompacte-o no seu computador (clique duas vezes no Mac; no Windows, clique com o botão direito › Extrair tudo).

Baixar o Éclair 1.7.0 (440 KB)

Você obtém uma pasta eclair e três arquivos de texto (leia-me, licença MIT e avisos de terceiros) que não precisam ser enviados. Veja o que a pasta eclair contém:

Etapa 2: enviar os arquivos para a sua hospedagem

O objetivo é que index.php, .htaccess e as pastas app, assets, data, cache e media fiquem diretamente na pasta pública do seu site. Dependendo da hospedagem, ela se chama public_html, www ou htdocs, ou leva o nome do seu domínio.

Com o gerenciador de arquivos da sua hospedagem

É o método mais simples, sem nenhum programa para instalar:

1. Abra o gerenciador de arquivos pela área do cliente da sua hospedagem (no cPanel: Files › File Manager).
2. Vá até a pasta pública do seu site e envie o arquivo eclair-cms-1.7.0.zip.
3. Clique com o botão direito no arquivo e escolha a opção de extrair (no cPanel: Extract): aparece uma pasta eclair.
4. Mostre os arquivos ocultos (no cPanel: Settings › Show Hidden Files (dotfiles)), abra a pasta eclair, selecione todo o conteúdo dela, .htaccess incluído, e mova tudo um nível acima, para a pasta pública.
5. Apague a pasta eclair, agora vazia, e o arquivo ZIP.

Com um programa de FTP como o FileZilla

1. Obtenha os dados de acesso FTP na área do cliente da sua hospedagem: servidor, usuário e senha (e a porta 22, se a hospedagem oferecer SFTP, que é mais seguro).
2. Conecte-se com o FileZilla, que é gratuito, e abra a pasta pública do seu site na coluna da direita.
3. Ative a opção que força a exibição de arquivos ocultos (Server › Force showing hidden files): sem ela, o .htaccess pode não ser enviado.
4. Na coluna da esquerda, abra a pasta eclair, selecione todo o conteúdo dela e arraste para a direita.

E em uma subpasta ou em um subdomínio?

Funciona também. Para um site no endereço exemplo.com.br/site/, basta enviar os arquivos para a pasta site: o Éclair detecta a subpasta sozinho. Para um subdomínio como blog.exemplo.com.br, envie os arquivos para a pasta associada a esse subdomínio.

Etapa 3: responder às 4 perguntas do assistente

Para instalar o Éclair CMS, só falta abrir o endereço do seu site no navegador: o assistente de instalação começa, em português ou em um dos outros 6 idiomas oferecidos no canto superior direito.

Boas-vindas: a verificação da sua hospedagem

O assistente verifica a versão do PHP, as extensões, as permissões de escrita das pastas, o HTTPS e a reescrita de URLs. Se tudo estiver verde, clique em Vamos lá. Se algum item estiver vermelho, ele explica o que corrigir com o seu provedor de hospedagem.

Pergunta 1: seu site

Preencha o Nome do site, um Slogan opcional e o Idioma do site, depois escolha o tipo de site. Tudo pode ser alterado mais tarde.

O tipo escolhido determina as primeiras páginas criadas para você:

Pergunta 2: sua conta

Seu nome, seu e-mail e uma senha de pelo menos 10 caracteres. Senhas comuns demais são recusadas, e um medidor indica a força da sua senha.

Pergunta 3: sua visibilidade

• O Google e o Bing podem indexar meu site: desmarque se preferir construir seu site com calma antes de mostrá-lo.
• As inteligências artificiais (ChatGPT, Perplexity, Gemini…): Boas-vindas (elas podem ler e citar seu site, recomendado), Somente citações (elas citam você, mas não treinam os próprios modelos com os seus textos) ou Não, obrigado.
• Endereço da sua administração: troque admin por uma palavra sua, ou clique em Gerar endereço secreto. Um endereço próprio afasta os robôs maliciosos.

Pergunta 4: o resumo

Revise suas escolhas e clique em Criar meu site ⚡. O Éclair cria suas páginas, um artigo de exemplo, sua conta, o sitemap e os ícones do site.

Seu site está no ar!

Chuva de confete, e seu site está publicado. Anote bem o endereço da sua administração (por exemplo, https://seu-site.com.br/estudio) e salve-o nos favoritos: é por ali que você vai entrar daqui em diante.

Etapa 4: seus primeiros ajustes em 10 minutos

O painel recebe você com uma lista Primeiros passos: cada linha leva você à tela certa.

1. Adicione seu logo e sua cor (Configurações › Aparência): o contraste das cores continua legível automaticamente.
2. Personalize a página inicial: troque os textos de exemplo pela sua própria oferta.
3. Escreva seu primeiro artigo, com a ajuda das notas de SEO e GEO do editor.
4. Complete seu perfil de autor: foto, cargo e biografia reforçam a confiança do Google e das IAs.
5. Ative a autenticação de dois fatores (Meu perfil › Autenticação de dois fatores).
6. Complete o aviso legal, obrigatório na França e na Espanha.
7. Conecte seu site ao Google Search Console (Configurações › SEO): cole a tag de verificação e o Éclair extrai o código.

Acrescente uma oitava etapa: em Segurança, clique em Verificar endereço do site. Depois que o endereço for confirmado, o Éclair redireciona os visitantes para o endereço oficial (com ou sem www) e passa a exigir HTTPS.

Cada configuração é detalhada em Primeiros passos após a instalação.

O que fazer se a instalação não começar?

Para todo o resto, consulte o guia de solução de problemas ou escreva para mim.

Instalar o Éclair na o2switch, passo a passo