manifest / builders / builder-converter

Builder Converter

O Builder Converter é uma plataforma abrangente de migração que auxilia na migração de sites WordPress do Avada Theme com Fusion Builder para Elementor Pro.

by Mateus Botelho · github.com/botelllhx/builder-converter · website

★ 0stars

0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/botelllhx/builder-converter/archive/refs/heads/main.zip

Readme github.com/botelllhx/builder-converter ↗

Plataforma Profissional de Migração: Avada/Fusion Builder → Elementor Pro

Resumo Executivo

O Builder Converter é um plugin e plataforma profissional de migração desenvolvida para agências, empresas e projetos WordPress de grande escala. Diferente de plugins "mágicos" que prometem 100% de automação, o Builder Converter oferece migração inteligente e assistida com controle total e transparência.

Proposta de Valor

Migrações Previsíveis: Reduzir o risco de migração através de análise abrangente e planejamento
Economia de Tempo: Automatizar conversão de páginas simples e de complexidade média
Confiança Técnica: Visibilidade clara do que pode e não pode ser automatizado
Pronto para Enterprise: Arquitetura modular projetada para extensibilidade e escalabilidade

Visão Geral

O que é o Builder Converter?

O Builder Converter é uma plataforma abrangente de migração que auxilia na migração de sites WordPress do Avada Theme com Fusion Builder para Elementor Pro. Oferece:

Auditor de Migração: Análise abrangente e avaliação de risco
Conversor Assistido: Conversão automatizada com pontos de revisão manual
Gerador de Templates: Detecção de padrões e criação de templates reutilizáveis
Blueprint de Migração: Planejamento e acompanhamento passo a passo da migração
Dashboard Executivo: Métricas do projeto e acompanhamento de progresso

Filosofia de Design

Transparência sobre Promessas: Comunicamos claramente o que pode ser automatizado e o que requer intervenção manual.

Segurança em Primeiro Lugar: Toda conversão cria backups automáticos. Nenhuma página de produção é modificada sem confirmação explícita.

Nível Profissional: Construído para agências e empresas que precisam de processos de migração previsíveis e confiáveis.

Funcionalidades Principais

1. Auditor de Migração

Análise Abrangente do Site

Escaneia todas as páginas e posts criados com Avada/Fusion Builder
Identifica uso do Fusion Builder, shortcodes e elementos visuais
Classifica páginas por complexidade:
- 🟢 Simples: Conversão automática disponível
- 🟡 Média: Requer revisão pós-conversão
- 🔴 Complexa: Requer conversão manual

Critérios de Análise

Contagem e tipos de shortcodes
Complexidade dos elementos
Análise da estrutura de grid
Dependências de CSS customizado
Integrações de terceiros

Saída

Relatório geral de migração
Lista de páginas com níveis de risco
Esforço estimado por página
Avaliação do potencial de automação

2. Conversor Assistido

Conversão Automatizada de Elementos

Seções → Containers Elementor (Pro) ou Seções (Free)
Colunas → Colunas/Containers Elementor
Texto → Widgets Text Editor / Heading
Imagens → Widgets Image
Botões → Widgets Button

Conversão em Lote

Selecionar múltiplas páginas para conversão
Visualizar seleção antes de converter
Filtrar por complexidade, status ou busca
Acompanhamento do progresso da conversão
Resultados detalhados com relatórios de sucesso/falha

Recursos de Segurança

Criação automática de backup antes de cada conversão
Capacidade de rollback
Preservação de conteúdo
Manutenção da hierarquia estrutural
Elementos que requerem revisão são claramente marcados

Limitações Conhecidas

Animações complexas não são convertidas
Layouts extremamente customizados podem requerer trabalho manual
CSS inline específico do Avada não é convertido
Shortcodes de plugins terceiros são preservados mas não convertidos

3. Gerador de Templates Elementor

Detecção de Padrões

Identifica padrões comuns de páginas:
- Seções Hero
- Landing pages
- Páginas institucionais
- Páginas de conteúdo

Criação de Templates

Gera templates Elementor reutilizáveis
Aplicação em lote para múltiplas páginas
Substituição de templates para páginas existentes

4. Blueprint de Migração

Planejamento Passo a Passo

Organizado por fases de complexidade:
- Fase 1: Páginas simples (comece aqui)
- Fase 2: Páginas de complexidade média
- Fase 3: Páginas complexas que requerem trabalho manual

Recursos

Checklist por página
Acompanhamento de status de validação
Campo de notas técnicas
Visualização de progresso
Estimativa de tempo

5. Dashboard Executivo

Métricas do Projeto

Total de páginas analisadas
Percentual automaticamente migrável
Horas estimadas economizadas
Avaliação de risco técnico
Distribuição de complexidade
Progresso da migração

Requisitos do Sistema

Requisitos Mínimos

Componente	Versão	Status
WordPress	6.0+	Obrigatório
PHP	7.4+	Obrigatório
Elementor (Free)	Mais recente	Obrigatório
Node.js	16.x+	Para desenvolvimento
npm	Mais recente	Para desenvolvimento

Componente	Versão	Status
Elementor Pro	Mais recente	Recomendado
PHP	8.0+	Recomendado
MySQL	5.7+	Recomendado

Compatibilidade

Avada Theme: Todas as versões com Fusion Builder
Elementor Pro: 3.0+ (testado até 3.21.0)
WordPress Multisite: Suportado
PHP 8.0+: Totalmente suportado

Guia de Instalação

Pré-requisitos

Verificar Versão do PHP
```
php -v
# Deve ser 7.4 ou superior
```
Verificar Instalação do Node.js (para desenvolvimento)
```
node -v
npm -v
```
Instalar Elementor
- Opção A: Elementor Free (Modo de Compatibilidade)
- Opção B: Elementor Pro (Recursos Completos) - Recomendado

Passos de Instalação

Passo 1: Instalar Elementor

Elementor Free (Modo de Compatibilidade)

Navegue até: Plugins → Adicionar Novo
Busque por "Elementor"
Instale e ative

Elementor Pro (Recomendado)

Adquira licença em Elementor.com
Faça upload via: Plugins → Adicionar Novo → Enviar Plugin
Ative e licencie em: Elementor → Configurações → Licença

Passo 2: Instalar Builder Converter

Opção A: Git Clone (Desenvolvimento)

git clone https://github.com/your-org/builder-converter.git
cd builder-converter
npm install
npm run build

Opção B: Download Direto

Baixe o plugin ZIP
Extraia para wp-content/plugins/
Renomeie a pasta para builder-converter se necessário

Passo 3: Compilar Assets

⚠️ CRÍTICO: O plugin não funcionará sem assets compilados!

cd wp-content/plugins/builder-converter
npm install
npm run build

Verificar Build

Verifique se existe o diretório build/ contendo:
- build/index.js
- build/index.css
- build/index.asset.php

Passo 4: Ativar Plugin

Navegue até: Plugins → Plugins Instalados
Encontre "Builder Converter"
Clique em "Ativar"

Passo 5: Verificar Requisitos

Após ativação, o plugin verifica automaticamente:

✅ Versão do PHP (CRÍTICO - bloqueia se incompatível)
✅ Versão do WordPress (CRÍTICO - bloqueia se incompatível)
✅ Elementor instalado (CRÍTICO - bloqueia se ausente)
⚠️ Elementor Pro instalado (AVISO - informa limitações)
⚠️ Arquivos de build presentes (AVISO - limita funcionalidades)

Tipos de Avisos

Erro (Vermelho): Requisito crítico não atendido - plugin não funcionará
Aviso (Amarelo): Funcionalidade limitada, mas plugin continua funcionando
Info (Azul): Informação sobre modo de compatibilidade

Passo 6: Acessar Dashboard

Na barra lateral do WordPress, clique em "Builder Converter"
O Dashboard exibe estatísticas (após primeira análise)

Checklist Pós-Instalação

[ ] Elementor Pro está ativo e licenciado (ou Free em modo de compatibilidade)
[ ] Sem avisos de requisitos no admin do WordPress
[ ] Menu "Builder Converter" aparece
[ ] Dashboard carrega sem erros
[ ] Arquivos em build/ existem e estão atualizados

Arquitetura e Detalhes Técnicos

Estrutura de Diretórios

builder-converter/
│
├── includes/                          # Backend PHP
│   ├── modules/                      # Módulos Principais
│   │   ├── class-auditor.php         # Auditor de Migração
│   │   ├── class-converter.php       # Conversor Assistido
│   │   ├── class-template-generator.php  # Gerador de Templates
│   │   └── class-blueprint.php       # Blueprint de Migração
│   │
│   ├── class-admin.php               # Gerenciamento do Admin
│   ├── class-rest-api.php            # Endpoints REST API
│   ├── class-modules.php             # Gerenciador de Módulos
│   ├── class-autoloader.php          # Autoloader de Classes
│   ├── class-helpers.php             # Funções Auxiliares
│   ├── class-activator.php           # Ativação do Plugin
│   └── class-deactivator.php         # Desativação do Plugin
│
├── src/                              # Frontend React
│   ├── components/                   # Componentes Reutilizáveis
│   │   ├── Sidebar.js
│   │   ├── StatCard.js
│   │   ├── LoadingSpinner.js
│   │   ├── Alert.js
│   │   ├── Button.js
│   │   ├── PageList.js
│   │   ├── PageDetailsModal.js
│   │   ├── RequirementsWarning.js
│   │   └── BatchConverter.js
│   │
│   ├── pages/                       # Páginas Principais
│   │   ├── Dashboard.js
│   │   ├── Auditor.js
│   │   ├── Converter.js
│   │   ├── Templates.js
│   │   └── Blueprint.js
│   │
│   ├── utils/                       # Utilitários
│   │   └── api.js                   # Cliente API
│   │
│   ├── styles/                      # Folhas de Estilo
│   │   ├── index.css
│   │   └── batch-converter.css
│   │
│   ├── App.js                       # Componente Principal
│   └── index.js                     # Ponto de Entrada
│
├── build/                            # Assets Compilados (Gerado)
│   ├── index.js
│   ├── index.css
│   └── index.asset.php
│
├── languages/                        # Arquivos de Tradução
│   └── builder-converter.pot
│
├── builder-converter.php            # Arquivo Principal do Plugin
├── uninstall.php                    # Script de Desinstalação
├── package.json                     # Dependências Node.js
├── composer.json                    # Dependências PHP
├── webpack.config.js                # Configuração de Build
└── README.md                        # Este Arquivo

Fluxo de Dados

Fluxo de Inicialização

builder-converter.php
  └── BC_Autoloader::register()
  └── BC_REST_API::init()
  └── BC_Modules::init()
      ├── BC_Auditor::instance()
      ├── BC_Converter::instance()
      ├── BC_Template_Generator::instance()
      └── BC_Blueprint::instance()
  └── BC_Admin::init()

Comunicação Frontend → Backend

Componente React
  └── apiRequest() (utils/api.js)
      └── WordPress REST API
          └── BC_REST_API
              └── BC_Modules::get_module()
                  └── Módulo Específico (Auditor, Converter, etc.)

Processo de Conversão

1. Usuário clica em "Escanear Páginas"
   └── POST /auditor/scan
       └── BC_Auditor::scan_all_pages()
           └── BC_Auditor::analyze_page()
               └── Salvar em wp_bc_migrations

2. Usuário clica em "Converter"
   └── POST /converter/convert/{id}
       └── BC_Converter::convert_page()
           ├── BC_Converter::create_backup()
           ├── BC_Converter::convert_content()
           └── Salvar dados Elementor

3. Usuário visualiza Blueprint
   └── GET /blueprint
       └── BC_Blueprint::get_blueprint()
           └── Organizar por fases

Esquema do Banco de Dados

Tabela: `wp_bc_migrations`

CREATE TABLE wp_bc_migrations (
    id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
    post_id bigint(20) unsigned NOT NULL,
    post_type varchar(20) NOT NULL,
    complexity varchar(20) NOT NULL,
    status varchar(20) NOT NULL DEFAULT 'pending',
    converted_data longtext,
    notes text,
    created_at datetime NOT NULL,
    updated_at datetime NOT NULL,
    PRIMARY KEY (id),
    KEY post_id (post_id),
    KEY status (status),
    KEY complexity (complexity)
);

Convenções de Código

PHP

Namespaces: Prefixo BC_ para todas as classes
Métodos: camelCase para métodos privados, snake_case para públicos quando apropriado
Hooks: Prefixo bc_ para actions e filters
Options: Prefixo bc_ para opções do WordPress

JavaScript/React

Componentes: PascalCase
Funções: camelCase
Constantes: UPPER_SNAKE_CASE
Classes CSS: Prefixo bc-

Extensibilidade

Adicionar Novo Módulo

Criar classe em includes/modules/class-novo-modulo.php
Registrar em BC_Modules::register_modules()
Criar endpoints REST em BC_REST_API::register_routes()
Criar página React em src/pages/NovoModulo.js
Adicionar ao menu em src/App.js

Adicionar Suporte a Widget Elementor

Estender BC_Converter::convert_element_to_widget()
Adicionar lógica de parsing em BC_Converter::parse_fusion_elements()

Otimizações de Performance

Cache de análises no banco de dados
Carregamento lazy de módulos
Build otimizado com @wordpress/scripts
CSS minificado em produção
Queries de banco de dados eficientes com índices

Modo de Compatibilidade

Visão Geral

O Builder Converter foi projetado para funcionar de forma flexível, mesmo quando o Elementor Pro não está disponível. Isso é especialmente útil em ambientes de staging, desenvolvimento ou ao testar o plugin.

Suporte ao Elementor Free

O plugin funciona perfeitamente com apenas o Elementor (versão gratuita) instalado. Quando o Elementor Pro não é detectado, o plugin entra automaticamente em Modo de Compatibilidade.

O que Funciona no Modo de Compatibilidade

Funcionalidade Completa (Mesmo Sem Pro)

Auditor de Migração
- ✅ Escaneamento completo de páginas
- ✅ Análise de complexidade
- ✅ Classificação de páginas
- ✅ Estatísticas e relatórios
- ✅ Identificação de elementos
Conversor Básico
- ✅ Conversão de seções para seções tradicionais do Elementor
- ✅ Conversão de colunas para colunas tradicionais
- ✅ Conversão de texto, imagens e botões
- ✅ Criação automática de backup
- ✅ Estrutura básica do Elementor
Blueprint de Migração
- ✅ Visualização de fases
- ✅ Checklist por página
- ✅ Status de migração
- ✅ Notas técnicas
Dashboard
- ✅ Estatísticas gerais
- ✅ Métricas de complexidade
- ✅ Progresso da migração

Limitações Sem Elementor Pro

Funcionalidades que Requerem Pro

Containers do Elementor Pro
- ❌ Não disponíveis
- ✅ Usa seções/colunas tradicionais do Elementor
- ✅ Funciona perfeitamente, apenas estrutura diferente
Geração de Templates
- ❌ Requer Elementor Pro
- ✅ Você ainda pode criar templates manualmente no Elementor
- ✅ Análise e blueprint funcionam normalmente
Widgets Avançados do Pro
- ❌ Alguns widgets podem não estar disponíveis
- ✅ Widgets básicos do Elementor funcionam normalmente
- ✅ Conversão usa widgets padrão

Comportamento de Conversão

Com Elementor Pro

Usa Containers (estrutura moderna do Elementor Pro)
Acesso a todos os widgets avançados
Templates podem ser gerados automaticamente

Com Elementor Free (Modo de Compatibilidade)

Usa Seções e Colunas (estrutura tradicional do Elementor)
Funciona perfeitamente, apenas estrutura diferente
Mesma funcionalidade, layout ligeiramente diferente

Casos de Uso para Modo de Compatibilidade

Ideal Para:

✅ Ambientes de staging
✅ Desenvolvimento e testes
✅ Análise inicial
✅ Testes temporários quando Pro não está disponível

Atualizar para Pro Quando:

⭐ Em produção
⭐ Precisa de todos os recursos
⭐ Requer geração automática de templates
⭐ Quer estrutura moderna de containers

Migrando para Elementor Pro

Quando você instalar o Elementor Pro:

Detecção Automática
- Plugin detecta automaticamente
- Modo de compatibilidade é desativado
- Todos os recursos ficam disponíveis
Páginas Convertidas
- Páginas convertidas em modo de compatibilidade continuam funcionando
- Você pode editá-las normalmente no Elementor
- Pode converter para containers se desejar
Sem Perda de Dados
- Nada é perdido
- Tudo continua funcionando
- Mais recursos ficam disponíveis

Comparação de Compatibilidade

Funcionalidade	Elementor Free	Elementor Pro
Auditor	✅ Completo	✅ Completo
Conversor Básico	✅ Funciona	✅ Funciona
Estrutura	Seções/Colunas	Containers
Templates	❌ Manual	✅ Automático
Blueprint	✅ Completo	✅ Completo
Dashboard	✅ Completo	✅ Completo

Verificação de Modo

O plugin indica claramente quando está em modo de compatibilidade:

Aviso no Admin do WordPress
- Aviso amarelo (não erro)
- Informa sobre limitações
- Explica recursos disponíveis
Banner no Dashboard do Plugin
- Banner informativo
- Status de compatibilidade
- Recursos ativos
Indicadores Visuais
- Badges de status
- Mensagens informativas
- Ajuda contextual

Guia do Usuário

Avisos Críticos

⚠️ LEIA COM ATENÇÃO ANTES DE USAR:

🚨 SEMPRE TESTE EM STAGING PRIMEIRO
- Nunca execute conversões diretamente em produção
- Use ambiente de desenvolvimento/staging
- Teste completamente antes de aplicar em produção
💾 BACKUP COMPLETO DO SITE
- Backup completo do banco de dados
- Backup dos arquivos do WordPress
- Plugin cria backups individuais, mas backup geral é essencial
🔍 NÃO É CONVERSÃO 100% AUTOMÁTICA
- Plugin converte elementos básicos automaticamente
- Elementos complexos precisarão de ajuste manual
- Revise TODAS as páginas após conversão
⏱️ TEMPO NECESSÁRIO
- Páginas simples: 5-10 min de revisão cada
- Páginas médias: 15-30 min de revisão cada
- Páginas complexas: 1-3 horas de trabalho manual
🎯 ELEMENTOR OBRIGATÓRIO
- Elementor Free mínimo (Modo de Compatibilidade)
- Elementor Pro recomendado (Recursos Completos)
- Certifique-se de ter licença ativa se usar Pro

Uso Passo a Passo

Fase 1: Análise e Planejamento

1.1. Executar Análise Inicial

Navegue até: Builder Converter → Auditor
Clique no botão "Escanear Páginas"
Aguarde o processo completar (pode levar vários minutos)
Sistema analisa todas as páginas e posts

O que Acontece:

Escaneia todas as páginas/posts do site
Identifica páginas usando Fusion Builder
Analisa shortcodes, elementos e estrutura
Classifica cada página por complexidade
Salva análise no banco de dados

1.2. Revisar Resultados da Análise

Use filtros para visualizar:
- Por complexidade (Simples, Média, Complexa)
- Por status (Pendente, Convertida, Revisão Necessária)
Clique em uma página para ver detalhes:
- Contagem de shortcodes
- Elementos encontrados
- Estrutura de grid
- Presença de CSS customizado

1.3. Visualizar Dashboard

Navegue até: Builder Converter → Dashboard
Veja estatísticas gerais:
- Total de páginas analisadas
- Percentual automaticamente conversível
- Horas estimadas economizadas
- Distribuição de complexidade

Fase 2: Planejamento com Blueprint

2.1. Acessar Blueprint

Navegue até: Builder Converter → Blueprint
Visualize o plano organizado por fases:
- Fase 1: Páginas simples (comece aqui)
- Fase 2: Páginas médias
- Fase 3: Páginas complexas

2.2. Estimar Tempo e Recursos

Use o Blueprint para:
- Estimar tempo total necessário
- Priorizar páginas importantes
- Planejar cronograma de migração
- Identificar páginas que podem precisar recriação

Fase 3: Conversão (COMEÇE EM STAGING!)

3.1. Preparação

⚠️ ANTES DE CONVERTER:

[ ] Site está em ambiente de staging/desenvolvimento?
[ ] Backup completo foi feito?
[ ] Elementor está funcionando corretamente?
[ ] Você tem tempo para revisar cada página?

3.2. Converter Páginas Simples (Fase 1)

Navegue até: Builder Converter → Conversor
Filtre por "Simples" e "Pendente"
Comece convertendo uma página de teste
Clique em "Converter" na página desejada
Aguarde o processo (alguns segundos)

O que Acontece:

✅ Backup automático é criado
✅ Conteúdo é analisado e convertido
✅ Estrutura Elementor é gerada
✅ Página é atualizada para usar Elementor

3.3. Revisar Página Convertida

Abra a página no editor do Elementor
Verifique:
- ✅ Layout está correto?
- ✅ Textos foram preservados?
- ✅ Imagens estão no lugar?
- ✅ Botões funcionam?
- ✅ Responsividade está ok?
Ajuste o que for necessário
Teste em diferentes dispositivos

3.4. Continuar Conversão

Converta páginas simples em lotes (5-10 por vez)
Revise cada lote antes de continuar
Marque como "Convertida" após revisão
Use o checklist no Blueprint

3.5. Páginas Médias (Fase 2)

Requerem mais atenção
Revise detalhadamente cada elemento
Pode precisar de ajustes manuais
Considere usar templates para páginas similares

3.6. Páginas Complexas (Fase 3)

Avalie se vale converter ou recriar
Algumas podem ser mais rápidas recriando do zero
Use como referência, não tente converter tudo
Foque nas páginas mais importantes

Fase 4: Conversão em Lote

4.1. Selecionar Múltiplas Páginas

Navegue até: Builder Converter → Conversor
Clique no botão "Conversão em Lote"
Selecione páginas usando checkboxes
Use filtros para encontrar páginas específicas
Clique em "Selecionar Todas" para seleção em massa

4.2. Visualizar Seleção

Clique no botão "Revisar Seleção"
Revise o resumo:
- Total de páginas selecionadas
- Contagem automaticamente conversível
- Contagem que precisa de revisão
- Contagem não conversível
Revise detalhes de páginas individuais:
- Nível de risco
- Status de conversão
- Tempo estimado

4.3. Configurar Opções

Pular páginas não conversíveis automaticamente
Forçar conversão (mesmo para páginas complexas)
Revisar opções antes de converter

4.4. Executar Conversão em Lote

Clique no botão "Converter Selecionadas"
Confirme a ação
Monitore o progresso
Revise resultados:
- Contagem de sucesso
- Contagem de falhas com motivos
- Contagem ignorada

Fase 5: Templates (Opcional)

5.1. Gerar Templates

Navegue até: Builder Converter → Templates
Identifique padrões comuns nas páginas convertidas
Selecione páginas com estrutura similar
Gere template por tipo (Hero, Landing, etc.)
Nomeie o template adequadamente

5.2. Usar Templates

Crie novas páginas usando os templates
Personalize conforme necessário
Economize tempo em páginas futuras

O que É Convertido Automaticamente

✅ Elementos Suportados:

Seções e colunas básicas do Fusion Builder
Texto simples (shortcode [fusion_text])
Imagens (shortcode [fusion_image])
Botões básicos (shortcode [fusion_button])
Estrutura de grid simples

O que NÃO É Convertido

❌ Elementos NÃO Suportados:

Animações complexas do Avada
Sliders avançados
CSS customizado específico do Avada
Shortcodes de plugins terceiros
Layouts extremamente customizados
Elementos com JavaScript customizado
Integrações específicas do Avada

Limitações Conhecidas

CSS Customizado
- CSS específico do Avada não é convertido
- Você precisará recriar estilos no Elementor
- Use o editor de CSS do Elementor quando necessário
Animações
- Animações do Avada não são convertidas
- Use animações do Elementor Pro
- Pode ser necessário recriar manualmente
Shortcodes de Terceiros
- Shortcodes de outros plugins não são convertidos
- Verifique se há equivalentes no Elementor
- Pode precisar manter shortcodes ou substituir
Layouts Complexos
- Layouts muito customizados podem quebrar
- Considere recriar do zero se muito complexo
- Use como referência visual

Checklist de Revisão Pós-Conversão

Para cada página convertida, verifique:

[ ] Layout visual está correto?
[ ] Todos os textos foram preservados?
[ ] Imagens estão no lugar e com tamanho correto?
[ ] Botões funcionam e links estão corretos?
[ ] Responsividade funciona (mobile, tablet, desktop)?
[ ] Formulários funcionam (se houver)?
[ ] Vídeos/embeds funcionam?
[ ] Navegação está correta?
[ ] Performance está adequada?
[ ] SEO não foi afetado?

Processo de Rollback

Se algo der errado:

Backup Automático
- Plugin cria backup antes de cada conversão
- Backups salvos como posts privados tipo "bc_backup"
- Acesse: Posts → Todos os Posts → Filtrar por "bc_backup"
Restaurar Backup
- Edite o post de backup
- Copie o conteúdo original
- Restaure na página convertida
- Ou use plugin de backup para restaurar página completa
Desativar Elementor na Página
- Edite a página
- Desative o modo Elementor
- Restaure conteúdo original

Dicas de Otimização

Converter em Lotes
- Não converta tudo de uma vez
- Faça em lotes de 5-10 páginas
- Revise cada lote antes de continuar
Usar Templates
- Identifique padrões comuns
- Gere templates reutilizáveis
- Economize tempo em páginas futuras
Documentar Ajustes
- Anote elementos que precisaram ajuste manual
- Use campo de notas no Blueprint
- Crie guia interno para sua equipe
Testar Continuamente
- Teste em diferentes navegadores
- Teste em diferentes dispositivos
- Teste funcionalidades específicas

Documentação da API

Endpoints REST API

Todos os endpoints são prefixados com: /wp-json/builder-converter/v1

Autenticação

Todos os endpoints requerem:

Usuário WordPress com capacidade manage_options
Nonce válido da REST API nos headers da requisição

Endpoints

Dashboard

GET /dashboard/stats - Obter estatísticas do dashboard

Auditor

POST /auditor/scan - Escanear todas as páginas
GET /auditor/pages - Obter lista de páginas (suporta parâmetros de query: complexity, status)
GET /auditor/page/{id} - Obter detalhes da página

Conversor

POST /converter/convert/{id} - Converter página única
POST /converter/batch/preview - Visualizar conversão em lote
POST /converter/batch/convert - Executar conversão em lote

Templates

GET /templates - Obter lista de templates
POST /templates/generate - Gerar template

Blueprint

GET /blueprint - Obter blueprint de migração

Exemplos de Requisição/Resposta

Escanear Páginas

POST /wp-json/builder-converter/v1/auditor/scan
Content-Type: application/json
X-WP-Nonce: {nonce}

Resposta:
{
  "success": true,
  "total": 45,
  "pages": [...]
}

Converter Página

POST /wp-json/builder-converter/v1/converter/convert/123
Content-Type: application/json
X-WP-Nonce: {nonce}

Corpo:
{
  "force": false
}

Resposta:
{
  "success": true,
  "post_id": 123,
  "backup_id": 456,
  "message": "Página convertida com sucesso"
}

Visualizar Conversão em Lote

POST /wp-json/builder-converter/v1/converter/batch/preview
Content-Type: application/json
X-WP-Nonce: {nonce}

Corpo:
{
  "page_ids": [123, 124, 125]
}

Resposta:
{
  "total": 3,
  "pages": [...],
  "summary": {
    "auto_convertable": 2,
    "needs_review": 1,
    "not_convertable": 0
  }
}

Segurança

Medidas de Segurança

Verificação de Permissões: Todos os endpoints REST API verificam current_user_can('manage_options')
Nonces: Todas as requisições requerem nonces válidos do WordPress
Sanitização de Entrada: Toda entrada sanitizada com sanitize_text_field(), wp_kses_post(), etc.
Escape de Saída: Toda saída escapada com esc_html(), esc_url(), etc.
Prepared Statements: Todas as queries SQL usam prepared statements
Validação de Arquivos: Uploads de arquivos validados e sanitizados

Boas Práticas

Sempre use HTTPS em produção
Mantenha WordPress, PHP e plugins atualizados
Use senhas fortes para contas de admin
Revise regularmente páginas convertidas para problemas de segurança
Monitore logs de segurança do WordPress

Solução de Problemas

Problemas Comuns

Problema: "Arquivos de build não encontrados"

# Solução:
cd wp-content/plugins/builder-converter
npm install
npm run build

Problema: "Elementor não encontrado"

⚠️ Isso não é um erro! Plugin funciona com Elementor Free em modo de compatibilidade
Se você vê um aviso (amarelo), plugin continua com recursos limitados
Para recursos completos, instale Elementor Pro
Verifique se Elementor (free) está instalado - isso é obrigatório
Se Elementor não está instalado, instale versão gratuita primeiro

Problema: "Erro ao carregar página do plugin"

Verifique console do navegador (F12)
Verifique se arquivos em build/ existem
Limpe cache do WordPress e do navegador

Problema: "Versão PHP incompatível"

Atualize PHP no seu servidor
Versão mínima: PHP 7.4
Recomendado: PHP 8.0 ou superior

Problema: "Página não converteu corretamente"

Verifique se página usa Fusion Builder
Verifique análise da página no Auditor
Considere conversão manual se muito complexa

Problema: "Elemento específico não foi convertido"

Verifique se elemento é suportado
Adicione manualmente no Elementor
Use widgets similares do Elementor Pro

Problema: "Erro durante conversão"

Verifique logs do WordPress
Verifique se Elementor Pro está atualizado
Verifique permissões do usuário
Tente novamente após criar backup manual

Problema: "Dashboard não carrega"

Verifique se arquivos em build/ existem
Execute npm run build novamente
Limpe cache do navegador
Verifique console do navegador (F12) para erros

Modo de Debug

Ative o modo de debug do WordPress para informações detalhadas de erro:

// wp-config.php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Verifique logs em: wp-content/debug.log

Contribuindo

Contribuições são bem-vindas! Por favor, siga estas diretrizes:

Configuração de Desenvolvimento

Faça fork do repositório
Clone seu fork
Instale dependências: npm install
Crie uma branch: git checkout -b feature/AmazingFeature
Faça suas alterações
Teste completamente
Commit: git commit -m 'Adiciona AmazingFeature'
Push: git push origin feature/AmazingFeature
Abra um Pull Request

Padrões de Código

Siga WordPress Coding Standards para PHP
Siga regras ESLint para JavaScript
Escreva mensagens de commit claras
Adicione comentários para lógica complexa
Atualize documentação conforme necessário

Testes

Antes de enviar:

Teste em WordPress 6.0+
Teste com Elementor Free e Pro
Teste conversão em vários tipos de página
Verifique se não há erros no console
Verifique design responsivo

Licença

Este plugin está licenciado sob GPL v2 ou posterior.

Copyright (C) 2024 Builder Converter

Este programa é software livre; você pode redistribuí-lo e/ou modificá-lo
sob os termos da GNU General Public License conforme publicada pela
Free Software Foundation; seja a versão 2 da Licença, ou
(a seu critério) qualquer versão posterior.

Este programa é distribuído na esperança de que seja útil,
mas SEM QUALQUER GARANTIA; sem mesmo a garantia implícita de
COMERCIABILIDADE ou ADEQUAÇÃO A UM DETERMINADO FIM. Veja a
GNU General Public License para mais detalhes.

Suporte

Obter Ajuda

Verifique este README para problemas comuns
Revise seção de solução de problemas
Verifique console do navegador (F12) para erros
Revise logs do WordPress
Abra uma issue no GitHub

Recursos

GitHub Issues: Reporte bugs e solicite funcionalidades
Documentação: Este README e comentários inline no código
WordPress.org: Fórum de suporte do plugin (se publicado)

Changelog

Versão 1.0.0

Adicionado:

Auditor de Migração com classificação de complexidade
Conversor Assistido para elementos básicos
Conversão em lote com preview
Gerador de Templates Elementor
Blueprint de Migração com fases e checklist
Dashboard Executivo com estatísticas
Interface React moderna com Lucide React
Sistema de backup automático
API REST completa
Sistema modular extensível
Modo de Compatibilidade para Elementor Free

Técnico:

Arquitetura modular
Autoloader de classes
Tabelas customizadas no banco de dados
Integração nativa com Elementor Pro
Frontend React com build @wordpress/scripts
Design minimalista inspirado em Shadcn/ui

Referência Rápida

Checklist de Instalação

[ ] WordPress 6.0+ instalado
[ ] PHP 7.4+ configurado
[ ] Node.js e npm instalados (para desenvolvimento)
[ ] Elementor instalado e ativo
[ ] Plugin Builder Converter instalado
[ ] npm install executado
[ ] npm run build executado
[ ] Arquivos em build/ existem
[ ] Plugin ativado no WordPress
[ ] Sem avisos de requisitos

Início Rápido

# 1. Instalar dependências
npm install

# 2. Compilar assets
npm run build

# 3. Ativar plugin no WordPress
# 4. Navegar até Builder Converter → Auditor
# 5. Clicar em "Escanear Páginas"
# 6. Revisar resultados
# 7. Começar conversão (EM STAGING!)

Builder Converter - Tornando migrações previsíveis, reduzindo retrabalho e aumentando confiança técnica.

Versão: 1.0.0
Última Atualização: 2024
Requisitos: WordPress 6.0+, PHP 7.4+, Elementor (Free mínimo, Pro recomendado)

Desenvolvido com ❤️ para a comunidade WordPress

Builder Converter

Install

Resumo Executivo

Proposta de Valor

Índice

Visão Geral

O que é o Builder Converter?

Filosofia de Design

Funcionalidades Principais

1. Auditor de Migração

2. Conversor Assistido

3. Gerador de Templates Elementor

4. Blueprint de Migração

5. Dashboard Executivo

Requisitos do Sistema

Requisitos Mínimos

Recomendado

Compatibilidade

Guia de Instalação

Pré-requisitos

Passos de Instalação

Passo 1: Instalar Elementor

Passo 2: Instalar Builder Converter

Passo 3: Compilar Assets

Passo 4: Ativar Plugin

Passo 5: Verificar Requisitos

Passo 6: Acessar Dashboard

Checklist Pós-Instalação

Arquitetura e Detalhes Técnicos

Estrutura de Diretórios

Fluxo de Dados

Fluxo de Inicialização

Comunicação Frontend → Backend

Processo de Conversão

Esquema do Banco de Dados

Tabela: wp_bc_migrations

Convenções de Código

PHP

JavaScript/React

Extensibilidade

Adicionar Novo Módulo

Adicionar Suporte a Widget Elementor

Otimizações de Performance

Modo de Compatibilidade

Visão Geral

Suporte ao Elementor Free

O que Funciona no Modo de Compatibilidade

Funcionalidade Completa (Mesmo Sem Pro)

Limitações Sem Elementor Pro

Funcionalidades que Requerem Pro

Comportamento de Conversão

Com Elementor Pro

Com Elementor Free (Modo de Compatibilidade)

Casos de Uso para Modo de Compatibilidade

Migrando para Elementor Pro

Comparação de Compatibilidade

Verificação de Modo

Guia do Usuário

Avisos Críticos

Uso Passo a Passo

Fase 1: Análise e Planejamento

Fase 2: Planejamento com Blueprint

Fase 3: Conversão (COMEÇE EM STAGING!)

Fase 4: Conversão em Lote

Fase 5: Templates (Opcional)

O que É Convertido Automaticamente

O que NÃO É Convertido

Limitações Conhecidas

Checklist de Revisão Pós-Conversão

Processo de Rollback

Dicas de Otimização

Documentação da API

Endpoints REST API

Autenticação

Endpoints

Exemplos de Requisição/Resposta

Segurança

Medidas de Segurança

Boas Práticas

Solução de Problemas

Tabela: `wp_bc_migrations`