themeforge-pro/agent-kit

Marcado de ThemeForge

ThemeForge construye un tema clásico de WordPress a partir de HTML estático. Marca las partes editables con atributos HTML: fld-* para campos de una página, opt-* para configuraciones globales del sitio, tax-* para campos de una categoría, wp-* para elementos propios de WordPress (entradas, menús, productos). El generador las convierte en campos de administración, plantillas de página y pantallas de administración que el propietario del sitio edita. El diseño se mantiene igual.

Las reglas están en https://themeforge.pro/ai y cambian con el generador. No marques de memoria ni desde este archivo: obtén las reglas cada sesión. Esta habilidad solo te indica el orden de trabajo.

1. Acuerda primero el mapa del sitio

Antes de escribir el marcado, responde con un mapa del sitio y espera confirmación:

• cada archivo de página con su slug (index.html, menu.html, contacts.html…) — el nombre del archivo determina la plantilla de WordPress, por lo que blog.html es una página llamada blog, no el feed del blog;
• tipos de contenido: entradas del blog, productos, tus propios tipos y sus categorías;
• qué es global (encabezado, pie de página, contactos) — va en theme-options.html;
• idiomas.

2. Obtén las reglas que necesitas

GET https://themeforge.pro/ai              la página de entrada: léela primero
GET https://themeforge.pro/ai?m=core       siempre, antes de cualquier marcado
GET https://themeforge.pro/ai?m=build      cuando GENERES el sitio en lugar de anotar uno
GET https://themeforge.pro/ai?m=<module>   pages · blog · cpt · woocommerce · deploy · legacy

Carga solo los módulos que este sitio necesita: una cafetería sin tienda nunca lee woocommerce.

3. Marca sobre la marcha

Atribuye cada sección mientras la escribes o lees, no en una segunda pasada. Las comprobaciones que detectan la mayoría de errores, en palabras de las reglas:

• cada página tiene wp-fields-group en <body>, o no recibe campos;
• cada campo tiene un nombre; un enlace y su título tienen nombres diferentes (Button / Button text);
• en una lista (fld-loop) cada tarjeta lleva los atributos, no solo la primera;
• los campos globales se declaran en theme-options.html.

4. Verifica, gratis y sin cuenta

Envía el conjunto completo de páginas en una sola solicitud y repite hasta que "ok": true:

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

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

O ejecuta node scripts/validate.mjs <carpeta-del-sitio> desde este kit. error rompe el tema, warning significa que algo se omite silenciosamente, hint es bueno saberlo. No se almacena nada.

5. Entrega

Sigue ?m=deploy: un ZIP con el contenido del sitio (index.html en la raíz). La persona lo sube a un proyecto en https://themeforge.pro, abre el administrador de WordPress del tema en el navegador de forma gratuita, y descarga el tema con una suscripción. Si te proporcionan su id y token de proyecto, el módulo deploy muestra cómo construir el tema por HTTP tú mismo.

Referencias

• Referencia de atributos para personas: https://themeforge.pro/docs
• Guía de marcado: https://themeforge.pro/docs/ai-guide
• Diccionario de atributos como JSON: https://themeforge.pro/api/attributes
• Un ejemplo completo marcado: examples/warm-corner/ en este kit