Documentação técnica oficial

O que o Codex faz de melhor em WordPress

O Codex, um desenvolvedor WordPress automatizado, é capaz de realizar uma vasta gama de tarefas, tornando o desenvolvimento de plugins e temas mais eficiente.

O Codex consegue:

Exemplo real do que você pode pedir ao Codex

Você pode, literalmente, escrever um prompt como este:

“Crie um plugin WordPress que registre um widget Elementor chamado Hero, com campo de título, descrição, botão e imagem, baseado neste HTML”

E, ao colar seu HTML, o Codex irá gerar:

Fluxo ideal usando Codex + WordPress (recomendado)

1) Criar estrutura inicial do plugin

Peça ao Codex:

Create a WordPress plugin called Ridolfi Builder that registers custom Elementor widgets. Use best practices and modern structure.

Ele cria:

ridolfi-builder/
  ridolfi-builder.php
  widgets/
  assets/

2) Converter seus layouts HTML em widgets Elementor

Você manda:

Convert this HTML section into an Elementor widget.

Cole seu HTML. Ele gera:

3) Criar builder próprio (nível avançado)

Você pode criar seu próprio “Elementor custom” com Codex.

Exemplo de prompt:

Create a WordPress plugin that acts as a visual builder using Elementor API and custom widgets.

Ele também pode gerar projeto WordPress completo

Exemplo:

Create a custom WordPress theme from this HTML layout

Ele converte para:

Inclusive o WordPress tem ferramentas oficiais de scaffold automático como o @wordpress/create-block, que gera plugins completos com PHP, JS e CSS já configurados. Mas o Codex faz isso ainda mais rápido e customizado.

Melhor uso no seu caso específico (Luciano / Ridolfi)

Você deveria usar Codex para criar:

  1. Ridolfi Builder (seu próprio builder baseado em Elementor) com widgets:
    • Hero
    • CTA
    • Pricing
    • FAQ
    • Features
    • Testimonial
    • Section layouts
  2. Converter seus layouts HTML em widgets Elementor

    Você manda:

    Convert this HTML section into an Elementor widget.

    Cole seu HTML. Ele gera:

    • Controles (texto, imagem, botão)
    • render()
    • Registro do widget
    • CSS com escopo
  3. Criar builder próprio (nível avançado)

    Você pode criar seu próprio “Elementor custom” com Codex.

    Exemplo prompt:

    Create a WordPress plugin that acts as a visual builder using Elementor API and custom widgets.

Prompt “cirúrgico” (copiar e colar no Codex) para iniciar um projeto WordPress

Este prompt é focado em criar um plugin “builder” de widgets para Elementor, com estrutura profissional, assets (CSS/JS) bem carregados e pronto pra você ir adicionando seções (Hero, CTA, FAQ etc.).

Dica: Cole esse prompt no Codex e rode no diretório onde você quer criar o plugin (ex.: dentro de wp-content/plugins/).

Você é um engenheiro WordPress sênior. Crie um plugin WordPress do zero chamado "Ridolfi Builder" focado em registrar widgets customizados do Elementor.

OBJETIVO
- Plugin OOP (orientado a objetos), organizado em pastas.
- Registrar pelo menos 1 widget Elementor (Hero) como exemplo.
- Preparar arquitetura para adicionar vários widgets depois.
- Enfileirar CSS/JS somente quando necessário (frontend), evitando carregar globalmente sem necessidade.
- Compatível com Elementor (versões atuais) e WordPress moderno.

REQUISITOS TÉCNICOS
1) Estrutura de pastas:
- ridolfi-builder/
  - ridolfi-builder.php (arquivo principal do plugin)
  - includes/
    - Plugin.php (classe principal)
    - Elementor/
      - Elementor.php (bootstrap de integração com Elementor)
      - Widgets/
        - Hero.php (widget de exemplo)
  - assets/
    - css/
      - hero.css
    - js/
      - hero.js
  - readme.md

2) O arquivo principal ridolfi-builder.php deve:
- Definir constants (versão, path, url).
- Carregar autoload simples via require dos arquivos.
- Inicializar a classe principal.

3) Integração Elementor:
- Verificar se o Elementor está ativo (plugin loaded).
- Registrar widgets no hook correto do Elementor.
- Não quebrar o site caso Elementor não esteja instalado: mostrar admin_notice amigável.

4) Widget Hero (Elementor\\Widget_Base):
- Controles:
  - Title (text)
  - Subtitle (textarea)
  - Button text (text)
  - Button URL (url control)
  - Image (media)
  - Alignment (choose: left/center/right)
  - Background color (color)
- Render no frontend com HTML semântico e classes com prefixo rb- (ex.: rb-hero, rb-hero__title).
- CSS básico em assets/css/hero.css com escopo para não vazar estilo.
- JS básico em assets/js/hero.js (pode ser só um console.log por enquanto), mas preparado para futuras interações.

5) Enqueue de assets:
- Carregar hero.css e hero.js somente quando o widget Hero estiver presente na página.
- Se isso for complexo, implemente uma abordagem segura:
  - Registre os assets no widget e enfileire no método get_style_depends()/get_script_depends() do widget.
  - Garanta versionamento usando a versão do plugin.

6) Padrões:
- Use namespace (ex.: RidolfiBuilder\\...).
- Use strict_types quando apropriado.
- Sanitização e escaping no render (esc_html, esc_url, wp_kses_post etc.).
- i18n pronto (text-domain ridolfi-builder) – pode deixar só preparado.

ENTREGÁVEIS
- Crie TODOS os arquivos com o conteúdo completo.
- No final, mostre:
  1) Tree de arquivos
  2) Instruções de instalação (copiar pasta para wp-content/plugins e ativar)
  3) Como testar: abrir Elementor e procurar widget "RB Hero" na categoria "Ridolfi Builder"
  4) Checklist de validação (Elementor ativo/inativo; página com widget e sem widget; sem erros no console)

IMPORTANTE
- Não use frameworks externos.
- Não use Composer (a menos que seja estritamente necessário; preferir sem).
- Não inclua nada de tema; é somente plugin.
- Escreva código limpo e pronto para produção.

Prompt extra (para converter seu HTML em widget automaticamente)

Depois que o plugin base existir, use este prompt no Codex para cada seção:

Converta este bloco HTML/CSS/JS em um novo widget Elementor dentro do plugin Ridolfi Builder.

REGRAS
- Criar arquivo em includes/Elementor/Widgets/NOME.php com classe seguindo o padrão dos outros widgets.
- Adicionar na lista de registro de widgets.
- Criar assets/css/nome.css e assets/js/nome.js.
- Usar get_style_depends() e get_script_depends().
- Transformar textos, imagens e links em Controls do Elementor.
- Prefixar classes CSS com rb-nome.

AQUI ESTÁ O HTML:
[cole aqui]

AQUI ESTÁ O CSS:
[cole aqui]

AQUI ESTÁ O JS:
[cole aqui]

Prompt “modo produto” (pra você vender isso como pacote de widgets)

Se você já quer nascer com várias seções padrão:

No plugin Ridolfi Builder, crie 6 widgets Elementor prontos:
1) Hero
2) Features (repeater)
3) CTA
4) FAQ (repeater + accordion)
5) Testimonials (repeater)
6) Pricing (repeater com 3 colunas)

Cada widget deve ter:
- controles completos
- HTML semântico
- CSS escopado
- JS opcional apenas se necessário
- categoria "Ridolfi Builder"
- assets via get_style_depends/get_script_depends
- escaping e sanitização
- sem dependências externas
Mostre todos os arquivos criados e a árvore final.
← Início da base