ThemeForge Pro / Agent Kit

Marcação ThemeForge

O ThemeForge constrói um tema WordPress clássico a partir de HTML estático. Você marca as partes editáveis com atributos HTML: fld-* para campos de uma página, opt-* para configurações do site inteiro, tax-* para campos de uma categoria, wp-* para o próprio WordPress (posts, menus, produtos). O gerador transforma-os em campos de administração, modelos de página e as telas de admin que o dono do site edita. O design permanece da pessoa.

As regras estão em https://themeforge.pro/ai e mudam com o gerador. Não marque de memória ou a partir deste arquivo: busque as regras a cada sessão. Este skill apenas informa a ordem do trabalho.

1. Combine o mapa do site primeiro

Antes de escrever a marcação, responda com um mapa do site e aguarde confirmação:

• cada arquivo de página com seu slug (index.html, menu.html, contacts.html…) — o nome do arquivo decide o template do WordPress, então blog.html é uma página chamada blog, não o feed do blog;
• tipos de conteúdo: posts do blog, produtos, seus próprios tipos e suas categorias;
• o que é do site inteiro (cabeçalho, rodapé, contatos) — vai para theme-options.html;
• idiomas.

2. Busque as regras que você precisa

GET https://themeforge.pro/ai              a página de entrada: leia-a primeiro
GET https://themeforge.pro/ai?m=core       sempre, antes de qualquer marcação
GET https://themeforge.pro/ai?m=build      quando você GERA o site em vez de anotar um
GET https://themeforge.pro/ai?m=<módulo>   páginas · blog · cpt · woocommerce · deploy · legado

Carregue apenas os módulos que este site precisa: um café sem loja nunca lê woocommerce.

3. Marque enquanto avança

Atribua cada seção enquanto a escreve ou lê, não em uma segunda passada. As verificações que pegam a maioria dos erros, nas palavras das regras:

• toda página tem wp-fields-group no <body>, ou não recebe campos;
• todo campo tem um nome; um link e sua legenda têm nomes diferentes (Botão / Texto do botão);
• em uma lista (fld-loop) cada cartão carrega os atributos, não apenas o primeiro;
• campos do site inteiro são declarados em theme-options.html.

4. Verifique, gratuitamente e sem conta

Envie o conjunto completo de páginas em uma única requisição e repita até "ok": true:

POST https://themeforge.pro/api/validate-markup
Content-Type: application/json

{"pages":[{"name":"index.html","html":"…"},{"name":"theme-options.html","html":"…"}]}

Ou execute node scripts/validate.mjs <pasta-do-site> a partir deste kit. error quebra o tema, warning significa que algo é silenciosamente descartado, hint é bom saber. Nada é armazenado.

5. Entregue

Siga ?m=deploy: um único ZIP com o conteúdo do site (index.html na raiz). A pessoa envia para um projeto em https://themeforge.pro, abre o admin do WordPress do tema no navegador gratuitamente e baixa o tema com uma assinatura. Se eles fornecerem o id do projeto e o token, o módulo deploy mostra como construir o tema via HTTP você mesmo.

Referências

• Referência de atributos para pessoas: https://themeforge.pro/docs
• Guia de marcação: https://themeforge.pro/docs/ai-guide
• Dicionário de atributos como JSON: https://themeforge.pro/api/attributes
• Um exemplo completo com marcação: examples/warm-corner/ neste kit