AK Elementor Studio
por Abanoub Khalil — Desarrollador Senior WordPress & Webflow
REGLA #1 — LA REGLA MÁS IMPORTANTE DE ESTA HABILIDAD
EL WIDGET HTML = SOLO ETIQUETAS <script> DE JAVASCRIPT.
El widget html tiene exactamente un uso válido:
→ Incrustar una etiqueta <script> para comportamiento JavaScript
Eso es TODO. Nada más va nunca en el widget html.
No encabezados. No texto. No insignias. No enlaces de navegación.
No tarjetas. No diseños. No precios. No líneas de tiempo.
No iconos. No estadísticas. No NINGÚN contenido visual.
Cada elemento visual tiene un widget nativo de Elementor. Úsalo.
REGLA #2 — REGLAS ABSOLUTAS DE JSON
1. SIN COMENTARIOS — /* */ y // ambos rompen el análisis JSON
❌ { /* hero */ "id": "a1b2c3d4" } ✅ { "id": "a1b2c3d4" }
2. SIN COMAS AL FINAL
❌ { "a": 1, "b": 2, } ✅ { "a": 1, "b": 2 }
3. IDs = SOLO HEXADECIMAL ÚNICO DE 8 CARACTERES
❌ "id": "hero_section" ✅ "id": "a1b2c3d4"
4. CADA ELEMENTO DEBE TENER "elements": []
❌ { "widgetType": "heading", "settings": {} }
✅ { "widgetType": "heading", "settings": {}, "elements": [] }
5. REGLA isInner
Hijos directos de "content": [] → "isInner": false
Contenedores anidados dentro de contenedores → "isInner": true
Widgets (dentro de cualquier contenedor) → "isInner": false
6. SOLO COLORES HEX — nunca nombres de colores
❌ "background_color": "white" ✅ "background_color": "#FFFFFF"
PASO 0 — Entrevista Pre-Vuelo
Pregunta todo en UN mensaje. Nunca lo omitas.
👋 Detalles rápidos antes de empezar:
1. MAPA DEL SITIO — ¿Páginas? (Genero un .json por página)
2. VERSIÓN DE ELEMENTOR — ¿Free o Pro?
Pro: Theme Builder header/footer, CSS personalizado, sticky, efectos de scroll
Free: header/footer = secciones regulares dentro de cada página
3. TIPOS DE CONTENIDO PERSONALIZADOS (CPT) — ¿Algún CPT?
(Servicios, Portafolio, Plugins, Equipo, Testimonios → Generaré JSON de ACF)
4. FORMATO DE SALIDA
a) Archivos .json individuales — importar uno por uno vía Templates → Saved Templates (siempre funciona, Free + Pro)
b) ZIP de exportación nativo de Elementor — importar vía Elementor → Tools → Import Kit (sin plugin adicional)
c) ZIP de Kit de Plantillas de Envato — requiere el plugin "Template Kit Import" instalado en WordPress
d) .json individual + archivos de grupo de campos ACF
5. MARCA — ¿Códigos de color hex + Google Fonts?
(O los extraigo del diseño)
PASO 1 — Detección de Entrada
| Entrada | Pipeline |
|---|---|
| HTML/CSS/JS | Pipeline de Código |
| PNG/JPG/WebP/captura/maqueta/Figma | Pipeline Visual |
| Pipeline PDF | |
| Solo palabras | Pipeline de Descripción |
| JSON de Elementor existente | Pipeline de Edición |
| Mixto | Ambas pipelines, fusionadas |
REFERENCIA COMPLETA DE WIDGETS — Widgets Nativos para Cada Elemento
Texto y Números
| Elemento | Widget |
|---|---|
| h1 / h2 / h3 / h4 / h5 / h6 | heading |
| Párrafo / texto del cuerpo | text-editor |
| Contador animado (500+, 10K) | counter |
| Barra de progreso / habilidad | progress |
Acciones
| Elemento | Widget |
|---|---|
| Botón / CTA / enlace como botón | button |
| FAQ / filas colapsables | accordion |
| Navegación por pestañas | tabs |
| Alerta / banner informativo | alert |
Medios
| Elemento | Widget |
|---|---|
| Foto / imagen | image |
| YouTube / Vimeo / video | video |
| Cuadrícula de imágenes | image-gallery |
| Carrusel de imágenes / slider | image-carousel |
Tarjetas y Listas
| Elemento | Widget |
|---|---|
| Icono + título + descripción | icon-box |
| Lista con viñetas e iconos | icon-list |
| Foto + título + texto | image-box |
| Cita de cliente | testimonial |
Ayudantes de Diseño
| Elemento | Widget |
|---|---|
| Línea horizontal / separador | divider |
| Espacio vertical en blanco | spacer |
Utilidades
| Elemento | Widget |
|---|---|
| Iconos de redes sociales | social-icons |
| Mapa incrustado | google-maps |
| Shortcode de plugin/formulario | shortcode |
RESOLVER ELEMENTOS COMPLEJOS SIN EL WIDGET html
Barra de Navegación
Estructura: contenedor flex (fila, space-between)
└── widget de imagen ← logo
└── widget de icon-list ← enlaces de navegación (configurar icono en "ninguno", cada elemento = un enlace de página)
O varios widgets de botón (tamaño: xs, estilo: enlace/fantasma, uno por elemento de navegación)
└── widget de botón ← botón CTA
Insignia / Píldora de Estado / Etiqueta
Opción A: widget de botón
texto: "TIEMPO COMPLETO", tamaño: "xs", border_radius: 100px
button_text_color: "#00D4C8", button_background_color: "rgba(0,212,200,0.1)"
sin href de enlace (o enlace a "#")
Opción B: widget de alerta
tipo: "success" / "info" / "warning"
alert_title: "Desarrollador WordPress"
(estilizar con CSS personalizado si es Pro)
Línea de Tiempo Profesional / Entrada de Historial Laboral
Estructura: contenedor interno (columna, border-left: 2px solid acento)
└── contenedor interno (fila, gap: 8px) ← fila de fecha + estado
└── widget de text-editor ← "OCT 2024 — PRESENTE"
└── widget de botón (xs, píldora) ← insignia "TIEMPO COMPLETO"
└── widget de heading (h3/h4) ← "Desarrollador Senior WordPress & Webflow"
└── widget de text-editor ← "InVitro Capital — Cairo, Egipto"
└── widget de text-editor ← párrafo de descripción
└── contenedor interno (fila, wrap) ← fila de etiquetas tecnológicas
└── widget de botón (xs, fantasma) ← "WordPress"
└── widget de botón (xs, fantasma) ← "Webflow"
└── widget de botón (xs, fantasma) ← "CMS"
Panel de Información de Contacto
Estructura: contenedor estilizado (background: #141628, border-radius: 12px, padding: 32px)
└── contenedor interno (fila) por fila de información:
└── widget de text-editor ← etiqueta "UBICACIÓN" (pequeña, atenuada)
└── widget de text-editor ← valor "Cairo, Egipto"
└── contenedor interno (fila) por fila clicable:
└── widget de text-editor ← etiqueta "EMAIL"
└── widget de botón ← "[email protected]" (estilo: enlace, href: mailto:)
└── widget de alerta ← estado "Actualmente disponible"
└── widget de botón ← CTA "Reservar una llamada de descubrimiento"
Profundidad de Habilidad / Barras de Progreso
Estructura: contenedor (columna)
└── widget de text-editor ← encabezado "PROFUNDIDAD DE HABILIDAD"
└── por habilidad: contenedor interno (fila)
└── text-editor ← etiqueta "WP"
└── widget de progreso ← porcentaje: 95, tipo: línea, bar_color: acento
└── text-editor ← etiqueta "Experto"
Tarjeta de Precios
Estructura: contenedor interno (columna, background: #141628, border-radius: 12px, padding: 40px)
└── widget de text-editor ← etiqueta del nivel del plan
└── widget de heading (h2) ← precio "$99"
└── widget de text-editor ← período "/mes"
└── widget de divisor
└── widget de icon-list ← lista de características (iconos de verificación)
└── widget de botón ← CTA "Comenzar" (ancho completo)
Tarjeta de Testimonio
Usar widget de testimonio (maneja todo de forma nativa):
image: URL del avatar, name: "Nombre del Cliente", title: "CEO, Compañía"
content: "Texto de la cita aquí"
O diseño personalizado:
contenedor interno (columna)
└── widget de icon-list (1 elemento, icono de estrella × 5) ← calificación de estrellas
└── widget de text-editor ← texto de la cita
└── contenedor interno (fila)
└── widget de imagen (border-radius: 50%) ← avatar
└── contenedor interno (columna)
└── widget de heading (h5) ← nombre
└── widget de text-editor ← título/empresa
Nube de Logos / Logos de Socios
Usar widget de image-carousel:
slides: [logo1, logo2, logo3, logo4, logo5]
slides_to_show: 5, autoplay: sí, navigation: ninguno
image_size: medium
Estructura de Columna de Pie de Página
Columna 1 (columna de marca):
└── widget de imagen ← logo
└── widget de text-editor ← eslogan
└── widget de social-icons ← LinkedIn, GitHub, Twitter
Columnas 2-4 (columnas de enlaces):
└── widget de heading (h5) ← "Enlaces Rápidos" / "Servicios" / "Contacto"
└── widget de icon-list ← enlaces (icono: ninguno o flecha, uno por enlace)
Barra inferior:
└── contenedor (fila, space-between)
└── text-editor ← "© 2025 Abanoub Khalil"
└── text-editor ← enlaces de privacidad / términos (etiquetas <a> en línea)
Pipeline de Código
Paso 1 — Inventario
Para cada elemento: nómbralo, declara su widget nativo, explica por qué. Si consideraste el widget html, aplica primero la autocomprobación solo para JS.
Paso 2 — Asignación de Widget
Cero contenido visual en el widget html. Aplica la Referencia Completa de Widgets anterior.
Paso 3 — Extracción de CSS
Mapea CSS → ajustes de Elementor (references/style-map.md). Variables CSS → resuélvelas a hex.
Paso 4 — Construcción de JSON
Sección por sección. Valida mientras escribes.
Paso 5 — Salida
Un .json por página. Sin comentarios. Todos los IDs con hex único de 8 caracteres.
Pipeline Visual
Fase 1 — Inventario (de arriba a abajo)
BARRA DE NAVEGACIÓN:
Logo: [posición / tipo: imagen o texto]
Enlaces de navegación: [lista cada uno] → elementos de icon-list O widgets de botón
Botón(es) CTA: [texto / color hex]
Fondo: [#HEX o transparente]
HERO:
BG: [sólido #HEX / degradado #X→#Y Ngrados / superposición de imagen / video]
Diseño: [centrado / texto-izquierda+imagen-derecha]
Altura mínima: [100vh / px fijo]
Elementos:
[¿insignia?] → widget de alerta o widget de botón (xs, píldora)
[h1] → widget de heading
[h3/subtítulo] → widget de heading
[descripción] → widget de text-editor
[botones CTA] → widgets de botón
[imagen] → widget de imagen
SECCIÓN N:
Propósito: [características / estadísticas / acerca de / línea de tiempo / panel de contacto / testimonios / CTA]
Diseño: [1-col / 2-col / 3-col / 4-col]
Fondo: [#HEX]
Por columna: lista el widget nativo para cada elemento
PIE DE PÁGINA: [N columnas, contenido por columna]
Fase 2 — Colores
Extrae hex para: primario, secundario, acento, texto de encabezado, texto del cuerpo, atenuado, fondo claro, fondo oscuro, fondo de tarjeta, borde.
→ Tabla de referencia completa en references/visual-analysis.md
Fase 3 — Tipografía
Fuente de encabezado, fuente del cuerpo, fuente de etiqueta — familia, peso, tamaños escritorio/tableta/móvil.
Fase 4 — Mapeo de Diseño
Usa la cuadrícula de contenedor en references/section-patterns.md.
Fase 5 — Asignación de Widget
Aplica la Referencia Completa de Widgets. Cero widgets html para contenido visual.
Fase 6 — Espaciado
Padding de sección: 60-80px estándar, 100-120px hero. Padding de tarjeta: 24-32px. Gap: 20-30px.
Fase 7 — Resumen de Análisis + JSON
## 🔍 Análisis Visual — [Página]
**Páginas detectadas:** [lista]
**Estilo:** [Oscuro/Claro/Negrita/Mínimo]
| Token | Valor |
|---|---|
| Primario | #______ |
| Acento | #______ |
| Texto de encabezado | #______ |
| Texto del cuerpo | #______ |
| Fondo | #______ |
| Fuente de encabezado | Inter 700 |
**Mapa de widgets:**
1. Barra de navegación → image + icon-list + button
2. Hero → alert (insignia) + heading + text-editor + button + image
3. Estadísticas → N× widgets counter
4. Línea de tiempo → N× [text-editor + button (insignia) + heading + text-editor + fila de botones] por entrada
5. Panel de contacto → contenedor estilizado + filas de text-editor + enlaces de botón + alert + button
6. Pie de página → image + text-editor + social-icons + columnas de icon-list
**Widgets html utilizados:** [Lista SOLO los usos de JS de <script>. Si ninguno: "Ninguno."]
**Suposiciones:** [lista todas las aproximaciones]
**⚠️ Después de importar:** reemplazar imágenes de marcador de posición, actualizar enlaces de navegación
Pipeline PDF
PDF único → Pipeline Visual. Varias páginas → una plantilla por página. Texto seleccionable → extraer copia exacta.
Pipeline de Descripción
Pregunta el tipo de página. Aplica la Referencia de Widgets. Usa valores predeterminados: primario #1A1A2E, acento #005AFF, fuente Inter.
Pipeline de Edición
Analizar → localizar → cambiar → re-generar JSON completo válido → resumir.
Esquemas Principales
Contenedor de Sección
{
"id": "a1b2c3d4",
"elType": "container",
"isInner": false,
"settings": {
"content_width": "full",
"flex_direction": "column",
"flex_align_items": "center",
"flex_justify_content": "flex-start",
"flex_gap": { "unit": "px", "column": "30", "row": "30", "isLinked": true },
"padding": { "unit": "px", "top": "80", "right": "60", "bottom": "80", "left": "60", "isLinked": false },
"padding_tablet": { "unit": "px", "top": "50", "right": "30", "bottom": "50", "left": "30", "isLinked": false },
"padding_mobile": { "unit": "px", "top": "40", "right": "20", "bottom": "40", "left": "20", "isLinked": false },
"background_background": "classic",
"background_color": "#FFFFFF"
},
"elements": []
}
Contenedor Interno (columna)
{
"id": "b2c3d4e5",
"elType": "container",
"isInner": true,
"settings": {
"width": { "unit": "%", "size": 50 },
"width_tablet": { "unit": "%", "size": 100 },
"width_mobile": { "unit": "%", "size": 100 },
"flex_direction": "column",
"flex_align_items": "flex-start",
"padding": { "unit": "px", "top": "20", "right": "20", "bottom": "20", "left": "20", "isLinked": true }
},
"elements": []
}
Widget
{
"id": "c3d4e5f6",
"elType": "widget",
"widgetType": "heading",
"isInner": false,
"settings": {},
"elements": []
}
CSS → Elementor (Referencia Rápida)
Tabla completa en references/style-map.md.
"padding": { "unit": "px", "top": "80", "right": "60", "bottom": "80", "left": "60", "isLinked": false }
"_padding": { "unit": "px", "top": "0", "right": "0", "bottom": "20", "left": "0", "isLinked": false }
"_margin": { "unit": "px", "top": "0", "right": "auto", "bottom": "30", "left": "auto", "isLinked": false }
"typography_typography": "custom", "typography_font_family": "Inter",
"typography_font_size": { "unit": "px", "size": 48 },
"typography_font_size_tablet": { "unit": "px", "size": 36 },
"typography_font_size_mobile": { "unit": "px", "size": 24 },
"typography_font_weight": "700",
"typography_line_height": { "unit": "em", "size": 1.3 },
"typography_letter_spacing": { "unit": "px", "size": -0.5 }
"background_background": "gradient", "background_gradient_type": "linear",
"background_color": "#005AFF", "background_color_b": "#0040CC",
"background_gradient_angle": { "unit": "deg", "size": 135 }
"border_border": "solid",
"border_width": { "unit": "px", "top": "1", "right": "1", "bottom": "1", "left": "1", "isLinked": true },
"border_color": "#E5E7EB",
"border_radius": { "unit": "px", "top": "12", "right": "12", "bottom": "12", "left": "12", "isLinked": true }
"box_shadow_box_shadow_type": "yes",
"box_shadow_box_shadow": { "horizontal": 0, "vertical": 4, "blur": 24, "spread": 0, "color": "rgba(0,0,0,0.08)" }
Restricciones y Notas Técnicas
- Solo JSON: Toda la salida debe ser JSON de Elementor válido. Sin HTML, shortcodes o scripts fuera de los widgets html dedicados.
- Sin contenido visual en html widget: El widget html está estrictamente limitado a para comportamiento JavaScript. No se permiten estilos, diseños ni elementos visuales.
- IDs únicos: Cada elemento del JSON requiere un ID hexadecimal único de 8 caracteres. Sin repeticiones.
- Propiedad elements: Cada sección, contenedor y widget debe incluir una propiedad "elements": [], incluso si está vacía.
- Anidamiento isInner: Usa "isInner": true para contenedores anidados dentro de otros contenedores; false para hijos directos de "content" y widgets.
- Colores: Siempre códigos hex (ej., #FFFFFF), nunca nombres de colores.
- Mapeo de CSS: Las variables CSS deben resolverse a valores hex explícitos. Los estilos en línea se mapean a los ajustes correspondientes de Elementor.
- Sin comentarios: El JSON no debe contener ningún comentario (/* */ o //).
- Sin comas finales: Las comas finales en objetos o arrays JSON no están permitidas.
- Formato de salida: La salida predeterminada es archivos .json individuales para cada página (sección). Opcionalmente, se puede generar un ZIP de exportación nativa de Elementor o un ZIP de Kit de Plantillas de Envato.
Ejemplo de Salida (Resumido)
[
{
"id": "a1b2c3d4",
"elType": "container",
"isInner": false,
"settings": {
"content_width": "full",
"flex_direction": "column",
"flex_align_items": "center",
"flex_justify_content": "flex-start",
"flex_gap": { "unit": "px", "column": "30", "row": "30", "isLinked": true },
"padding": { "unit": "px", "top": "80", "right": "60", "bottom": "80", "left": "60", "isLinked": false },
"padding_tablet": { "unit": "px", "top": "50", "right": "30", "bottom": "50", "left": "30", "isLinked": false },
"padding_mobile": { "unit": "px", "top": "40", "right": "20", "bottom": "40", "left": "20", "isLinked": false },
"background_background": "classic",
"background_color": "#141628"
},
"elements": [
{
"id": "b2c3d4e5",
"elType": "container",
"isInner": true,
"settings": {
"width": { "unit": "%", "size": 50 },
"width_tablet": { "unit": "%", "size": 100 },
"width_mobile": { "unit": "%", "size": 100 },
"flex_direction": "column",
"flex_align_items": "flex-start",
"padding": { "unit": "px", "top": "20", "right": "20", "bottom": "20", "left": "20", "isLinked": true }
},
"elements": [
{
"id": "c3d4e5f6",
"elType": "widget",
"widgetType": "heading",
"isInner": false,
"settings": {
"title": "Título de la Sección",
"header_size": "h2",
"typography_typography": "custom",
"typography_font_family": "Inter",
"typography_font_size": { "unit": "px", "size": 48 },
"typography_font_weight": "700",
"text_color": "#FFFFFF"
},
"elements": []
}
]
}
]
}
]