1. Proposito
Este documento establece las normas y configuraciones tecnicas que Antigravity (el agente IA de desarrollo) debe seguir al publicar contenido en WordPress via REST API. Garantiza que todo el contenido sea editable en el editor visual (Gutenberg) y mantenga los estandares de diseno del Ecosistema IDEA.
2. Credenciales y Endpoint
Parametro Valor
Endpoint base https://produccion.aeroidea.net/wp-json/wp/v2/kbx_knowledgebase
Autenticacion Basic Auth (Application Password)
Metodo para crear POST al endpoint base
Metodo para editar POST al endpoint + /{id}
Categorias /wp-json/wp/v2/kbx_category
Tags /wp-json/wp/v2/kbx_tag
3. Formato Obligatorio: Bloques Gutenberg
Todo contenido publicado via API debe usar bloques Gutenberg (block comments). Si no se usan, el editor de WordPress muestra todo como un solo bloque clasico que no se puede editar visualmente.
3.1 Parrafo
<!-- wp:paragraph -->
<p>Texto del parrafo aqui.</p>
<!-- /wp:paragraph -->
3.2 Encabezados
<!-- wp:heading -->
<h2>Titulo H2</h2>
<!-- /wp:heading -->
<!-- wp:heading {"level":3} -->
<h3>Titulo H3</h3>
<!-- /wp:heading -->
<!-- wp:heading {"level":4} -->
<h4>Titulo H4</h4>
<!-- /wp:heading -->
3.3 Tabla nativa
<!-- wp:table -->
<figure class="wp-block-table"><table><thead><tr>
<th>Columna 1</th><th>Columna 2</th>
</tr></thead><tbody>
<tr><td>Dato</td><td>Dato</td></tr>
</tbody></table></figure>
<!-- /wp:table -->
3.4 Lista
<!-- wp:list -->
<ul class="wp-block-list">
<!-- wp:list-item -->
<li>Elemento 1</li>
<!-- /wp:list-item -->
</ul>
<!-- /wp:list -->
3.5 Separador, Cita y Codigo
<!-- wp:separator -->
<hr class="wp-block-separator has-alpha-channel-opacity"/>
<!-- /wp:separator -->
<!-- wp:quote -->
<blockquote class="wp-block-quote"><p>Cita.</p></blockquote>
<!-- /wp:quote -->
<!-- wp:code -->
<pre class="wp-block-code"><code>codigo</code></pre>
<!-- /wp:code -->
3.6 HTML personalizado (Callout Boxes)
Para recuadros con estilo (colores, bordes), se usa el bloque HTML porque no hay bloque nativo equivalente:
<!-- wp:html -->
<div style="background:#eff6ff;border-left:4px solid #3b82f6;padding:16px 20px;margin:16px 0;border-radius:6px;color:#1e3a5f">
<h4>Titulo del callout</h4>
<p>Contenido.</p>
</div>
<!-- /wp:html -->
3.7 Tabla de Contenidos (UAGB)
<!-- wp:uagb/table-of-contents {"block_id":"ID_UNICO","classMigrate":true,"scrollOffset":30} /-->
Se auto-genera desde los headings. El block_id debe ser unico por articulo.
4. Paleta de Callout Boxes
Color Uso Background Border Text
Azul Informacion, modulo, referencia #eff6ff #3b82f6 #1e40af
Verde UX, principios, buenas practicas #f0fdf4 #22c55e #14532d
Rojo Desarrollador, admin, tecnico #fef2f2 #ef4444 #991b1b
Morado Importante, destacado, critico #faf5ff #a855f7 #581c87
Amarillo Advertencia, plan futuro, migracion #fef3c7 #f59e0b #92400e
5. IDs de Referencia
5.1 Categorias del Modulo de Usuarios (parent: 30744)
ID Nombre
30827 01. Generalidades e Instructivo Maestro
30829 02. Identidad y Estatus
30831 03. Roles, Permisos y Automatizacion
33835 04. Alertas, Notificaciones y Acciones
30835 05. Historial Financiero
30838 06. Expedientes y Fichas
30840 07. Conexion Academica
30842 08. Fidelidad y Relaciones
30844 09. Migracion y ETL
30846 10. Seguridad y Auditoria
5.2 Categorias independientes
ID Nombre
34772 Modulo de Agentes Inteligentes (IA)
34790 Modulo de Comunicaciones
1236 Manual de ERP-Produccion
5.3 Articulos clave
ID Articulo
1257138 Instructivo Maestro de Gestion de Usuarios
1277533 Alertas, Notificaciones y Acciones del Sistema
1277597 Descripcion del Modulo de Agentes Inteligentes (IA)
1277598 Instructivo General de Comunicaciones
1277605 Fidelidad, Relaciones y Gamificacion
1263052 Normas de Roles y Accesos
1277531 Matriz de Capacidades y Privilegios
6. Reglas Obligatorias
SIEMPRE publicar en formato Gutenberg (con block comments)
Tablas : usar wp:table con <figure class="wp-block-table">
Callout boxes : usar wp:html (no hay bloque nativo)
TOC : usar wp:uagb/table-of-contents (self-closing)
No dejar HTML suelto entre bloques
Verificar despues de publicar que content.raw contiene block comments