Como migrar um site WordPress para HTML puro e Cloudflare

Quando migrar faz sentido (e quando não faz)

A migração compensa quando o site muda pouco e o WordPress virou fonte de problema. Plugin desatualizado, painel invadido e lentidão são os sinais mais comuns. Um site institucional de 5 a 30 páginas é o caso típico.

Ela não compensa quando a equipe publica todo dia pelo painel e não quer mexer em arquivo. Loja com estoque, área de membros e sistema com login também pedem outra conversa. O WordPress bem cuidado ainda atende esses casos.

Se você está em dúvida entre os dois, a comparação completa está em WordPress ou HTML puro. Lá aparecem os prós e contras de cada lado, sem torcida.

Etapa 1: auditoria do site atual

A auditoria é a lista de tudo que existe hoje. Sem ela, você descobre o que faltou só quando o cliente reclama. Reserve uma planilha com uma linha por URL.

Comece pelo sitemap, que costuma ficar em /sitemap_index.xml ou /wp-sitemap.xml. Anote também as páginas que recebem tráfego no Google Analytics e no Search Console. Elas são as que não podem falhar.

Depois liste os recursos dinâmicos. Formulário de contato, busca interna, comentários, newsletter, chat e calculadoras dependem de plugin. Cada um precisa de um substituto antes da troca.

1. Baixe a lista de URLs do sitemap e cole na planilha.
2. Marque as 20 páginas com mais acessos nos últimos 12 meses.
3. Anote, para cada modelo de página, o título, a descrição e o canonical.
4. Liste cada plugin ativo e o que ele faz na página pública.
5. Defina o substituto de cada recurso dinâmico: função, serviço externo ou remoção.

Etapa 2: backup completo antes de tudo

Backup é a cópia dos arquivos e do banco de dados num lugar fora da hospedagem. Ele permite voltar atrás se algo der errado. Faça antes de instalar qualquer plugin de exportação.

Você precisa de duas partes. A primeira é a pasta inteira do site, com o wp-content. A segunda é o arquivo .sql do banco, que o painel da hospedagem exporta pelo phpMyAdmin. Guarde as duas no computador e numa nuvem.

Etapa 3: exportar o conteúdo do WordPress

O WordPress tem exportação nativa em Ferramentas, Exportar. Segundo a documentação do WordPress.org, ela gera um arquivo XML no formato WXR (WordPress eXtended RSS). O arquivo traz posts, páginas, tipos de post personalizados, comentários, campos personalizados, categorias, tags, taxonomias e usuários.

O filtro permite exportar tudo ou só posts e páginas, por categoria, autor, período e status. Para migração completa, escolha "Todo o conteúdo".

Os arquivos de imagem não ficam dentro desse XML. Eles moram na pasta wp-content/uploads, separados por ano e mês. Copie essa pasta inteira pelo gerenciador de arquivos ou por FTP.

Outra porta de saída é a API REST do WordPress. O endereço /wp-json/wp/v2/posts devolve os posts em JSON, 10 por vez, com os parâmetros per_page e page para paginar. É útil quando você vai alimentar um gerador de sites estáticos com dados.

seusite.com.br/wp-json/wp/v2/posts?per_page=50&page=1

O MundoBlá recebe uma comissão da HostGator quando você contrata a hospedagem pelo nosso link, sem custo extra para você. O escopo do site, inclusive se cabe trazer o conteúdo antigo, é combinado no WhatsApp antes de começar.

Etapa 4: converter as páginas em HTML

Converter é transformar cada post e página em arquivo HTML com o mesmo conteúdo. Há três caminhos, e o tamanho do site define o melhor.

A captura parece a saída mais rápida, mas traz junto o código pesado do tema e dos plugins. Você perde parte do ganho de velocidade. Ela serve melhor para arquivar um site antigo do que para manter um site vivo.

Para blogs, o caminho mais sustentável é o gerador. O guia geradores de sites estáticos e o Eleventy mostra como transformar arquivos Markdown em milhares de páginas.

Um modelo mínimo de página convertida fica assim:

<!doctype html>
<html lang="pt-BR">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Título igual ao do WordPress</title>
  <meta name="description" content="Mesma descrição que estava no plugin de SEO">
  <!-- troque SEU-DOMINIO pelo endereço completo do site -->
  <link rel="canonical" href="SEU-DOMINIO/meu-post/">
</head>
<body>
  <main>
    <h1>Título do post</h1>
    <p>Conteúdo do post.</p>
  </main>
</body>
</html>

Etapa 5: manter as mesmas URLs

Manter a URL é a regra que mais protege o tráfego. Se /servicos/ existia, ela continua existindo no site novo, com o mesmo final de barra.

No HTML puro, isso se faz com pastas. A URL /servicos/ vira a pasta servicos com um arquivo index.html dentro. No gerador estático, o campo permalink define o caminho de cada página.

Atenção às URLs que o WordPress cria sozinho: categorias, tags, páginas de autor e paginação (/page/2/). Decida quais continuam e quais serão redirecionadas. Tag com pouco conteúdo costuma ser redirecionada para a categoria mais próxima.

Etapa 6: redirecionamento 301 quando preciso

O redirecionamento 301 avisa que uma página mudou de endereço para sempre. O Google Search Central explica que o redirecionamento permanente é usado como sinal de que o destino deve ser a página canônica. O 302, temporário, não passa esse sinal.

Na Cloudflare Pages, as regras ficam num arquivo chamado _redirects, na raiz da pasta publicada. Cada linha tem origem, destino e código. Sem o código, a Cloudflare usa 302, então escreva 301 sempre que a mudança for definitiva.

/category/novidades/ /blog/ 301
/tag/promocao/ /blog/ 301
/2021/05/post-antigo/ /post-antigo/ 301

A documentação da Cloudflare limita o arquivo a 2.000 redirecionamentos estáticos e 100 dinâmicos, com 2.100 no total. Acima disso, ela recomenda o recurso Bulk Redirects. Para sites pequenos, o arquivo sobra.

Se a hospedagem for compartilhada com cPanel, o mesmo efeito sai pelo arquivo .htaccess. A lógica é igual: uma regra por URL antiga.

Etapa 7: imagens, formulário e publicação

As imagens vão na mesma estrutura de pastas de antes, para não quebrar link de imagem já indexada. Aproveite para comprimir e converter para WebP. Na Cloudflare Pages, cada arquivo pode ter até 25 MiB e o plano grátis aceita até 20.000 arquivos por site.

O formulário precisa de um destino novo, porque não há mais PHP. A página funções dinâmicas com Cloudflare Workers mostra como receber o envio com uma função pequena.

Para publicar, guarde o código num repositório do GitHub e conecte o repositório à Cloudflare Pages. A documentação oficial diz que, depois da conexão, cada push num ramo gera um deploy automático. Deploy é a publicação de uma versão nova do site. O passo a passo está em Cloudflare Pages.

1. Publique primeiro no endereço de teste que a Cloudflare oferece (subdomínio .pages.dev).
2. Navegue pelas 20 páginas principais e envie o formulário.
3. Rode um rastreador para encontrar erro 404 e link quebrado.
4. Só então aponte o domínio, como explica configurar domínio na Cloudflare.
5. Mantenha a hospedagem antiga ativa por algumas semanas, como plano de volta.

Conferir o SEO depois da troca

A conferência é o que separa uma migração tranquila de uma queda de tráfego. Faça logo depois de apontar o domínio e repita na semana seguinte.

Os detalhes de título, sitemap e indexação estão em SEO para sites HTML. Para a parte de performance, veja sites rápidos com HTML e Cloudflare.

Erros comuns na migração

1. Trocar o DNS antes de testar o site no endereço provisório.
2. Mudar a estrutura das URLs sem redirecionamento.
3. Usar 302 onde a mudança é definitiva.
4. Esquecer o formulário de contato e perder pedidos por semanas.
5. Apagar a hospedagem antiga no mesmo dia da troca.
6. Deixar sumir o título e a descrição que o plugin de SEO gerava.

Quem quer conhecer o cenário completo antes de decidir encontra a resposta curta sobre o Mundo Criação de Sites e a resposta sobre sites estáticos. Se a sua dúvida for de outro assunto, a resposta pode estar na página inicial do MundoBlá.

Se você ainda não decidiu sair do WordPress, volte ao guia Web livre sem WordPress e compare as alternativas.

Em outros Mundos

Se a migração derrubou visitas, o Mundo SEO explica como recuperar tráfego depois de uma queda. Para aprender a programar o que vier depois, passe no Mundo Programação.