# Adicionar um CMS a um site HTML pronto: cinco caminhos comparados
> Versão em Markdown de https://qixoo.app/pt/articles/add-cms-to-html-site.html
## Resposta curta
O jeito mais rápido de adicionar um CMS a um site HTML que já existe é acoplar uma
camada de edição hospedada com uma única tag de script. A marcação, os estilos e a
hospedagem ficam exatamente como estão, e o conteúdo passa a ser editável no lugar,
normalmente em menos de cinco minutos.
Todas as alternativas significam mexer no build. Refazer em WordPress troca a forma
como as páginas são geradas. Um CMS sobre git exige repositório e pipeline de deploy.
Um CMS headless exige alguém para modelar o conteúdo e ligá-lo aos templates. Um CMS
PHP de arquivos planos exige PHP no servidor e permissão de escrita na raiz web.
Decida com duas perguntas: **o código precisa mudar?** e **o cliente precisa de conta
em algum lugar?** Todo o resto é detalhe.
## As cinco opções lado a lado
| | Camada por tag de script | Refazer em WordPress | CMS sobre git | CMS headless | PHP de arquivos planos |
|---|---|---|---|---|---|
| Exemplos | Qixoo | WordPress + um tema | TinaCMS, Decap, CloudCannon, Sveltia | Contentful, Sanity, Storyblok, Prismic | Sitecake, CouchCMS, GetSimple |
| Implantação realista | ~5 minutos | 1–3 dias | 2–6 horas | 1–2 dias de dev | 1–2 horas |
| Precisa mexer no código? | Uma linha | Refeito do zero | Os templates são anotados | Templates reescritos | Tags de comentário por região |
| O site muda de lugar? | Não: fica onde está | Geralmente sim | Exige git e um build | Exige um build ou um servidor | Exige hospedagem com PHP |
| O cliente precisa de conta | Não: link de convite | Sim, um usuário do WordPress | Sim, normalmente um login de git | Sim, um assento no CMS | Sim, uma senha do CMS |
| De quem é a marca do editor | Neutra, ou a sua com o módulo white-label | WordPress | Varia, muitas vezes a do fornecedor | A do fornecedor | A da ferramenta |
| Manutenção contínua | Nenhuma do seu lado | Atualizações de core, tema e plugins | Manter o pipeline de build | Manter a integração | Atualizações de PHP e permissões |
| Custo típico | US$ 0–99/mês, o plano grátis cobre 1 site | Hospedagem mais o seu tempo | Grátis–US$ 100/mês | US$ 100–500+/mês | Licença de pagamento único |
| O conteúdo fica no HTML de origem | Reaplicado no navegador | Sim | Sim, no build | Sim, se renderizado no servidor | Sim, gravado no arquivo |
Os tempos pressupõem um site institucional de cinco páginas entregue a um cliente não
técnico, por alguém que já usou a ferramenta antes.
## Quando cada um é a escolha errada
**Camada por tag de script: passe longe se o conteúdo é o produto.** Um blog com um
post por dia, uma loja com mil SKUs, um portal de vagas: qualquer coisa em que o
conteúdo é produzido em volume e precisa estar no HTML de origem assim que muda
pertence a um CMS de verdade, com templates e banco de dados. Passe longe também se
você precisa de fluxo editorial: rascunhos, revisão, publicação agendada, aprovações.
Serve para sites institucionais, landing pages e sites de negócio local que mudam
algumas vezes por mês.
**Refazer em WordPress: passe longe se for para um cliente só.** Refazer um site já
pronto custa dias, e no dia em que você termina adotou um trabalho de manutenção:
atualizações de core, atualizações de plugins, segurança, backups. Serve para sites que
realmente precisam de plugins: assinaturas, agendamentos, uma loja de verdade.
**CMS sobre git: passe longe se o cliente não for técnico.** Decap, Tina e CloudCannon
mantêm o conteúdo no seu repositório, mas pressupõem repositório, build e um deploy que
roda quando o conteúdo muda. Quando o build quebra, a edição do cliente não aparece e
quem recebe a ligação é você. Serve para sites tocados por desenvolvedores,
documentação e times que já vivem no git.
**CMS headless: passe longe num site de cinco páginas.** Contentful, Sanity e Storyblok
foram feitos para conteúdo em escala espalhado por vários canais. Para um restaurante
com um cardápio e um bloco de horários você vai gastar um dia modelando tipos de
conteúdo para resolver um problema que cabia numa frase, com um custo mensal de outra
ordem de grandeza. Serve para conteúdo multicanal e vários sites compartilhando um
mesmo acervo.
**PHP de arquivos planos: passe longe se o site não estiver em hospedagem com PHP.**
Sitecake e CouchCMS escrevem direto nos seus arquivos HTML, o que é elegante, e exige
PHP, permissão de escrita na raiz web e uma hospedagem que tolere as duas coisas.
Netlify, Vercel e Cloudflare Pages não toleram. Várias ferramentas dessa categoria estão
há anos sem uma atualização de verdade. Serve para hospedagem compartilhada clássica
com cPanel e FTP.
**Regra prática.** Se quem edita o site é desenvolvedor, coloque o conteúdo no git. Se
um time de marketing edita todo dia, compre um CMS de verdade. Se é o dono de um
restaurante que quer mudar um preço num domingo e nunca fez login em nada, deixe a
edição na própria página. A resposta errada é sempre «me manda as alterações que eu
faço».
## O caminho da tag de script, na prática
1. **Uma linha na página.** Cole uma vez antes de `` em cada página, ou no campo
de código personalizado do head da plataforma que hospeda o site:
``
2. **Clique no que deve ser editável.** Abra o site no ar logado e clique num título,
num parágrafo, numa imagem ou num link para alterar. O conteúdo salvo é reaplicado a
cada carregamento da página.
3. **Mande um link ao cliente.** Ele abre o próprio site e edita num editor reduzido e
sem marca da Qixoo. Sem conta, sem painel e sem código.
**O que «editável» abrange:** textos e títulos, imagens, links, botões, itens de lista,
menus, galerias e sliders. Você também pode inserir blocos prontos sem escrever
marcação.
**O que ele de propósito não faz:** não reestrutura o seu layout e não é uma caixa de
permissões — o editor do cliente é uma interface reduzida que esconde os recursos
reservados ao operador, não uma tranca sobre o conteúdo da página. Ele também não
hospeda o seu site; quem serve o HTML continua sendo a sua hospedagem.
**Sobre SEO.** A sua hospedagem continua servindo o HTML que você escreveu, então um
crawler sempre recebe uma página completa. O conteúdo editado pela camada é reaplicado
no navegador, o que significa que uma edição pode demorar mais para ser captada do que
uma mudança no arquivo de origem. Para um título que muda algumas vezes por ano, isso
não é problema. Se o conteúdo inteiro de uma página precisa ser indexado no dia em que
muda, edite também o HTML.
## Perguntas frequentes
**Preciso refazer o site para adicionar um CMS?**
Não. Uma camada de edição por tag de script se acopla ao HTML que você já publicou:
marcação, estilos e hospedagem ficam como estão. Refazer só é necessário no caminho do
WordPress ou do headless.
**Adicionar um CMS assim prejudica o SEO?**
O HTML original continua sendo servido pela sua hospedagem, então a página que um
crawler recebe é a que você escreveu. Um texto alterado pode ser visto mais tarde do
que uma mudança estática. Ótimo para textos que mudam de vez em quando; edite também a
origem se a página precisa ser indexada no dia em que muda.
**Meu cliente precisa de conta para editar o site?**
Com a Qixoo, não: você manda um link de convite e ele edita o próprio site no ar. Com
os Client Seats do Webflow, com WordPress ou com um CMS headless, cada pessoa que edita
precisa de conta naquela plataforma.
**Funciona em Webflow, Framer, WordPress ou Netlify?**
Funciona em qualquer site que sirva HTML, seja qual for a hospedagem. Em sites
hospedados no Webflow a tag vai em Site Settings → Custom Code, o que exige um plano
pago de site do Webflow.
**O que acontece com o site se eu parar de pagar?**
Ele continua no ar com todas as edições salvas intactas. Só a edição pausa até haver um
plano ativo de novo. Nada é apagado.
**Funciona num single-page app em React?**
Na medida do possível. Apps que renderizam o DOM de novo depois do carregamento podem
sobrescrever o conteúdo injetado, então teste uma página antes de prometer a um
cliente.
**Existe um jeito grátis de fazer isso?**
Vários. Decap CMS e TinaCMS são grátis e open source se o site vive num repositório
git. O plano grátis da Qixoo cobre um site sem prazo. O software do WordPress é grátis;
hospedagem, tempo de migração e manutenção não são.
Veja também: [Substituição do Editor legado do Webflow](https://qixoo.app/pt/articles/webflow-alternative.md) ·
[Qixoo em português](https://qixoo.app/pt/index.md) ·
[Documentação](https://qixoo.app/pt/docs/index.md)