Como Uso a IA para Estender Plugins WordPress (Sem Precisar de Forks)
Meu workflow real para usar IA na refatoração e extensão de plugins, incluindo as lições que aprendi criando o WP-AutoInsight.
Era 2023. Eu queria entender melhor a API da OpenAI. Como aprendo criando, decidi desenvolver algo útil e ligado ao que eu mais domino: WordPress. Na época, não achei nenhuma solução open-source 100% integrada que oferecesse controle fino de tom, posts cientes de categorias e um agendador próprio. O que existia eram SaaS fechados ou ferramentas pagas engessadas.
Então, construí o meu próprio plugin.
Assim nasceu o WP-AutoInsight; começou como um plugin simples que usava apenas OpenAI para gerar posts agendados. A versão 1 era básica: chave de API, um cron job e opções simples de tom. Funcionou, e os clientes adoraram.
Mas aí vieram os pedidos: "Dá para usar o Claude?", "Gera imagens também?", "Consegue transcrever áudio?".
Cada uma dessas funcionalidades poderia ter sido um plugin novo. Em vez disso, usei a própria IA (Claude, Copilot, Gemini) para me ajudar a escrever, refatorar e estender o código original. A versão 3.2.0 hoje suporta OpenAI, Claude, Gemini, Perplexity, além de DALL-E 3 e Stability AI para imagens.
Nada disso estava no plano original da versão 1.
Comece pelo Plugin Certo
Antes de usar a IA para estender qualquer coisa, a primeira pergunta é: você está mexendo no plugin certo?
Parece óbvio, mas é uma armadilha comum: você acha um plugin que faz 60% do que o cliente quer, tenta fechar os 40% com código de IA e, três horas depois, está debugando hooks que nunca foram feitos para serem acessados externamente. Muitas vezes já existe outro plugin com 80% da solução e pontos de extensão documentados. Comece pesquisando por ele.
Um bom sinal é a documentação. Plugins bem documentados costumam ter estruturas de hooks limpas, o que facilita muito a vida da IA na hora de gerar um código compatível.
Mantenha seu Código Fora da Pasta do Plugin Original
A decisão arquitetural importa mais que o código em si. O instinto é colar o código customizado no functions.php. Funciona, até você trocar de tema e perder tudo.
O melhor padrão, seja o código escrito por você ou pela IA, é criar um plugin complementar (companion plugin) que se conecta ao plugin alvo via ações e filtros. A IA é ótima para criar esse esqueleto rapidamente. Dê a ela o código-fonte ou a documentação, descreva o que quer interceptar e peça para ela escrever o plugin complementar. O que levaria um dia inteiro, você resolve em uma tarde.
Isso também torna a manutenção sustentável. Quando o plugin original atualiza, você só precisa checar se os seus hooks continuam lá, sem precisar mexer na arquitetura de terceiros.
Onde a IA Ajuda e Onde Ela Falha
Usar IA para estender plugins não é o mesmo que deixar a IA construir tudo sozinha. Você ainda precisa ser o arquiteto.
O que funciona bem: Refatoração. Entregue para o Claude Code uma função que ficou complexa demais e peça para ele limpar a estrutura mantendo o comportamento. Ele respeita muito bem as convenções do WordPress (sanitização, nonces, hooks).
Onde ela falha: Casos de borda e suposições de ambiente. A IA não sabe que a hospedagem do seu cliente bloqueia certas funções PHP, ou que existe outro plugin gerando conflito. Você ainda precisa conhecer o ambiente e, acima de tudo, testar em staging antes de qualquer coisa chegar perto da produção.
O Caso WP-AutoInsight
O WP-AutoInsight é o maior exemplo desse workflow. Adicionar suporte ao Gemini em um plugin que já tinha OpenAI e Claude significou adaptar implementações existentes. O Claude cuidou da adaptação estrutural, enquanto eu foquei nos bugs de roteamento e nas sutilezas de como cada modelo retorna o texto.
O plugin agora tem funções que eu nunca imaginei no início, e isso só foi possível porque a IA absorveu o trabalho braçal, me deixando livre para focar no que exige julgamento técnico.
Um Alerta Necessário
Código gerado por IA precisa de revisão de segurança como qualquer outro. Verifique sanitização de entradas, valide permissões e nunca confie cegamente. Gastar 5 minutos revisando pode evitar horas de dor de cabeça no site do cliente.
Se você trabalha com WordPress e precisa de extensões personalizadas, refatoração de código antigo ou integração com IA, é exatamente isso que eu faço.