Como converter HTML num tema WordPress: o guia do app html2wp

Instalar o app que converte HTML para WordPress

Baixe o app html2wp para um Mac com Apple silicon (M1 ou mais novo) ou para Windows e instale como qualquer outro aplicativo. A versão para Windows ainda é uma Preview (versão prévia), e a versão para Linux vem depois.

Na primeira abertura, clique em “Prepare environment” (preparar o ambiente). O app então baixa tudo de que precisa. Isso acontece uma vez só e leva um tempo.

Para trabalhar, o app precisa do Docker Desktop, um programa gratuito. O Docker roda um WordPress temporário, e o app instala o tema ali e o testa. Se você não tem o Docker, o app baixa e inicia o instalador para você. O seu computador pode pedir a sua senha no caminho.

Login com o ChatGPT

Quem faz a conversão é a IA da sua assinatura do ChatGPT, então você não nos paga por créditos nem por tokens.

No app, clique em “Connect with ChatGPT” (conectar com o ChatGPT). O app mostra um código de 9 caracteres e abre uma página da OpenAI no seu navegador. Lá, escolha a sua conta do ChatGPT ou faça login.

Em seguida, a página pede um código “do terminal” e cita o Codex CLI. Está tudo certo: o html2wp usa o Codex, e o código que a página quer é o do app. Cole o código (clique nele no app para copiar) e clique em “Continue” (continuar). Depois do login, o app se atualiza sozinho.

Novo projeto: o HTML que você converte em tema

Clique em “New project” (novo projeto) e escolha a pasta ou o ZIP com o seu site. Pode ser uma exportação do Lovable, Bolt ou v0, um design do Claude ou um site em HTML puro. O app não aceita o endereço de um site (URL), porque precisa dos arquivos de que o site é feito.

O app descobre sozinho qual página é a inicial e qual é o blog, um artigo ou um produto.

Depois, escolha o que você quer receber. Em geral, você converte o HTML num tema WordPress, no modo Flash ou Full. Se você não precisa de WordPress, escolha um projeto Astro 5. Essa conversão é mais curta, e você pode publicar o site pronto direto do app no Cloudflare Pages, onde a hospedagem pode ser gratuita.

Flash ou Full: duas formas de converter HTML para WordPress

O Flash é a conversão rápida e o padrão do app. Cada etapa roda uma vez. Menus, blog, loja e formulários são reconhecidos e ligados na hora. As verificações também rodam uma vez, e os resultados ficam no relatório. Leva cerca de meia hora e serve para a maioria dos sites, e também para um teste rápido.

O Full é a conversão completa. Ele roda todas as verificações e tenta corrigir os erros que encontra. Leva cerca de uma hora e usa mais do limite da sua assinatura do ChatGPT. Por isso, compensa em sites mais complexos, ou quando o Flash deixou muitos pontos para ajustar no relatório.

Os dois modos convertem o seu HTML num tema WordPress utilizável e acrescentam uma nota sobre o que ficou pendente. O tempo exato depende do número de páginas e da velocidade do seu computador.

Escolher o modelo para converter HTML em tema

No app, você escolhe o modelo de IA e o nível de raciocínio (“Reasoning effort”).

• GPT-6-Luna em “Extra high” basta para conversões comuns. É barato, usa pouco do limite da sua assinatura e dá conta da maioria dos sites sozinho.
• GPT-6-Sol em “Medium” ou “High” é o que recomendamos quando algo precisa de correção, por exemplo numa conversão Full ou em ajustes pelo chat.
• GPT-6-Astra é o modelo mais forte e mais caro. Você não precisa dele no trabalho comum, mas ele ajuda quando nem o Sol resolve um problema.

Você pode trocar o modelo sempre que nenhuma conversão estiver rodando. Cada projeto pode ter o seu.

Conferir o tema WordPress contra o seu HTML

Quando a conversão termina, o app avisa. Se algo não der certo, ele primeiro tenta corrigir sozinho. De qualquer forma, ele sempre entrega um tema utilizável, com uma nota sobre o que ajustar.

Na aba “Preview” (pré-visualização), clique em “Open website” (abrir o site) e veja o site novo no seu navegador. A aba “Compare” (comparar) mostra o original e a conversão lado a lado, com a diferença em porcentagem. Escreva no chat o que não estiver bom, e o app corrige. Depois, salve as alterações prontas como nova versão com “Make release” (criar versão).

As verificações automáticas pegam a maioria das diferenças, mas não todas. Por isso, olhe as páginas antes de entregar o tema a um cliente. Você salva o ZIP do tema na aba “Exports” (exportações) e envia para o WordPress em Aparência → Temas → Adicionar novo tema → Enviar tema.

Dados e privacidade

O nosso servidor gera o tema. Mas a maior parte do trabalho (medir, comparar com o original e corrigir) roda no seu computador, conduzida pela IA da sua conta do ChatGPT. A OpenAI processa o material da IA nos termos da sua conta.

O que vai para o servidor

O seu site convertido num projeto Astro (páginas, estilos, scripts, imagens e fontes), mais informações sobre cada página. A pasta original do projeto e as bibliotecas instaladas (node_modules) não são enviadas. Os dados enviados são apagados automaticamente depois de 48 horas. Fica só uma impressão digital (hash), e é por causa dela que uma reexecução conta como uma única conversão.

Arquivos com senhas e chaves

Arquivos com cara de credenciais de acesso nunca entram no pacote: .env, chaves (.pem, .key, id_rsa), .npmrc, .netrc, as pastas .ssh e .aws ou qualquer arquivo com uma chave privada. Tudo o que o app deixou de fora aparece pelo nome no relatório.

Resultados das verificações

Depois de testar o tema, o app envia só os resultados das verificações: quais passaram e quais não, contagens de páginas, a maior diferença em relação ao original e os nomes curtos das páginas que falharam (por exemplo “about”). Ele não envia o endereço do site, domínio, código, texto, capturas de tela, caminhos de arquivo, chave de licença nem o nome do site.

As verificações rodam contra o WordPress no seu computador, que o nosso servidor nunca vê. Sem esses resultados, o servidor só saberia que a conversão não travou. Por isso, a próxima conversão só começa depois que a anterior enviou os resultados. O app envia tudo automaticamente. A descrição completa está na página de privacidade.

Editar com o Visual Edit

Um site que você converte de HTML para um tema WordPress não precisa de plugin para funcionar. Páginas, blog, formulários, menus, SEO e redirecionamentos fazem parte do tema. Os redirecionamentos levam os endereços antigos para os novos: quem abre o link antigo /about.html chega em /about/, e o site mantém as posições nas buscas.

A edição por clique vem do Visual Edit, um plugin do WordPress que você mesmo adiciona. Muda exatamente o que você clica. Nenhum construtor de páginas refaz o código da página por baixo.

O Pro é uma licença anual à parte, na página de preços. Toda conversão, Free ou Pro, indica a versão Lite gratuita. Se você desligar o plugin, as páginas continuam sendo exibidas e o tema continua totalmente utilizável.

Licença, assinatura, beta

Reexecuções

Na versão gratuita, você tem 5 reexecuções no total, somando todas as conversões. Com uma licença Pro, elas são ilimitadas. Uma reexecução é o mesmo site enviado de novo. O servidor o reconhece pela impressão digital (hash), então ele conta como reexecução, não como conversão nova.

Gerenciar e cancelar a sua assinatura

Você gerencia a sua assinatura na página da assinatura. O link está no rodapé do site e em todo e-mail de licença. No portal do cliente do Paddle, você pode cancelar a assinatura, trocar o cartão, baixar faturas e mudar o Pro mensal para anual. O login no portal é por um link enviado ao e-mail da compra, então você não precisa de senha.

Cancelar interrompe a próxima renovação. A sua chave funciona até o fim do período pago, e todo tema que você converteu continua seu. Um cancelamento não é reembolso: os reembolsos seguem as condições de reembolso.

O que significa beta

O html2wp converte sites reais e é usado em trabalhos reais. O app compara cada página com a original em 1440 e 390 px e registra no relatório cada verificação que falha, com a descrição do que ficou abaixo do esperado. Junto, ele entrega o melhor tema utilizável. Antes de prometer um resultado a um cliente, revise as páginas marcadas.

Quando você encontrar um bug no próprio conversor, relate como a documentação do plugin descreve. Uma pessoa lê o relato, e as correções chegam como atualizações do serviço.