Guía para administradores de contenido de tu sitio. Aprende a gestionar páginas, bloques, módulos, formularios y usuarios del CMS headless Entelgy DX Pro. Use el buscador (tecla /) para saltar a cualquier tema.

1. Panorama del producto

Entelgy DX Pro es un CMS que funciona en modo headless: WordPress se usa como panel de administración de contenido y el sitio que ve el visitante lo dibuja un frontend en React (Next.js) independiente, que consume el contenido por API.

Consecuencia práctica: lo que editas en WordPress no se ve al instante en el sitio público. Al Publicar / Actualizar y, cuando haga falta, Limpiar Cache, el frontend refresca y muestra los cambios.

Dominios del entorno (ejemplo)

Ideas clave antes de empezar

• Bloques: piezas con las que se arma cada página (banners, cards, tabs, etc.). Se insertan con el botón + del editor. Los bloques estándar de WordPress no están disponibles; solo los del proyecto.
• Módulos dinámicos: bloques cuyo contenido no se escribe dentro del bloque, sino que se alimenta de un CPT. El bloque solo define cómo se muestra (título, filtros, paginación).
• CPT (Custom Post Type / Tipo de contenido): un menú del administrador donde se cargan registros de un tipo (FAQs, documentos, envíos de formularios…).
• Bilingüe (Polylang): cada idioma (ES / EN) es una versión enlazada. Casi todo debe crearse/traducirse en ambos idiomas.
• Estado “Activo/Activa”: bandera de muchos CPT — solo los ítems activos se ven en el sitio.
• Limpiar Cache: barra superior del administrador. Úsala tras editar menús u opciones globales.

Glosario rápido

2. Header, footer, opciones de la web y medios

Configura los elementos que se repiten en todas las páginas: cabecera, pie, logos, favicon, analítica y biblioteca de archivos. No se editan dentro de cada página, sino en pantallas globales del CMS.

Tras guardar menús u opciones, usa la barra superior Limpiar Cache → Menú o → Opciones de sitio. Si el cambio no aparece, usa Toda la cache.

2.1 Header (cabecera del sitio)

El header se arma con piezas independientes. Si una falta, las demás siguen funcionando.

2.1.1 Logo del header

El logo del header no se carga en la pantalla de Menús. Vive en Más Opciones → grupo Logos → campo “Logo del sitio”.

Pasos: abre Más Opciones → elige idioma → en Logos pulsa “Logo del sitio” y selecciona/sube el archivo → Actualizar → limpia cache de Opciones de sitio.

2.1.2 Menú principal

Ruta: menú lateral Menús. El sitio público solo muestra el menú asignado a la ubicación Menú principal del idioma actual. Un menú creado pero no asignado no aparece.

Crear y asignar:

Agregar y ordenar ítems:

Campos extra de cada ítem (si no ves “Clases CSS”, actívalo en Opciones de pantalla):

Botón destacado (CTA): el frontend saca del listado el ítem que tenga la clase CSS convenida (más un icono) y lo pinta como botón resaltado (escritorio y panel móvil). Si falta la clase, el enlace queda como uno más del menú.

2.1.3 Selector de idioma

No se configura en Menús ni en Más Opciones. El header muestra ES/EN según las traducciones de la página que el visitante está viendo. Si falta la traducción, el destino no es correcto: hay que traducir la página en Polylang.

2.2 Footer (pie de página)

Todo el footer sale de Más Opciones (no existe un “menú footer” de WordPress). Ruta: Más Opciones → elegir idioma → completar grupos → Actualizar → Limpiar Cache.

2.2.1 Logos y holding

2.2.2 Canales de contacto

Grupo Canales. Primera columna de contenido del footer (en móvil se abre como acordeón).

La columna solo se pinta si hay al menos un renglón con contenido.

2.2.3 Navegación del footer

Grupo Navegación. Segunda columna: avisos legales, privacidad, etc.

Si no hay filas, la columna no se muestra.

2.2.4 Copyright

2.3 Opciones de la web

No mezcles el uso de estas pantallas:

Más Opciones es multi-idioma: el interruptor está arriba. Un cambio en español no se copia solo al inglés.

2.3.1 Recorrido de Más Opciones (todos los grupos)

Completa primero “Español”, pulsa Actualizar, cambia a “English” y repite.

2.3.2 ID de Google Tag

2.3.3 Nombre, lema y favicon

Ruta: Ajustes → Generales. Estos valores alimentan SEO de respaldo y el icono de la pestaña.

Usa un PNG cuadrado (recomendado 512×512).

2.3.4 Chatbot

El globo de chat se controla en el menú Chatbot, no en Más Opciones.

Textos por idioma: Chatbot → Traducción de textos, pestañas ES/EN (título, subtítulo, bienvenida, placeholder, sin resultados, despedida, error, textos ARIA). Pulsa “Guardar textos” en cada pestaña. La Configuración (URL y API key) es del equipo técnico.

2.4 Medios (biblioteca)

Ruta: Medios → Biblioteca. Usa FileBird (carpetas a la izquierda). Mover un archivo de carpeta no lo duplica ni rompe los bloques que ya lo usan (el ID del medio no cambia).

2.4.1 Subir un archivo

2.4.2 Carpetas FileBird, formatos y reemplazo

• Nueva carpeta agrupa archivos; arrastrar cambia la ubicación sin romper los bloques; eliminar carpeta manda los archivos a “Sin categoría” (no los borra); eliminar archivo sí lo quita del sitio.
• Formatos: SVG (logos/iconos, solo administrador), PNG/WebP (fotos, banners, favicon), JPG (fotografías), PDF (documentos). Comprime antes de subir.
• Reemplazar un logo: sube el nuevo a la misma carpeta, cámbialo en Más Opciones o en el ítem, guarda y limpia cache. No reemplaces por FTP.

3. Creación y configuración de páginas

Las páginas son las secciones del sitio (Inicio, Nosotros, Servicios, etc.). Se crean con el editor de bloques del proyecto. Al ser headless, los cambios aparecen en el sitio público tras guardar/publicar (y, si aplica, limpiar caché).

3.1 Acceder al listado de páginas

Inicia sesión en cms.misitio.com.pe con tus credenciales. En el menú lateral ve a Páginas → Todas las páginas. Desde aquí puedes ver todas las páginas, filtrar por estado, buscar por título y abrir una para editar.

3.2 Crear una página nueva

Ve a Páginas → Añadir nueva. Escribe el título; el sistema genera el enlace permanente (slug). Revísalo y ajústalo si hace falta.

3.3 Componer el contenido con bloques

El contenido se arma solo con los bloques del proyecto. Inserta con el botón + y busca por nombre o por categorías:

• Layout / estructura: Contenedor, Grilla, Cabecera, Banners (Hero, Galería, Scroll), Acordeón, Carrusel, Tabs, Cards, Feature, Accesos directos, Detalle de mapa.
• Módulos: Preguntas Frecuentes, Documentos y reportes.
• Formularios del sitio: Contacto, Negocios, Reclamo/Sugerencia, Recurso Impugnatorio.

Selecciona el bloque, completa sus campos y ordénalos arrastrando.

Algunos módulos (FAQs, documentos, etc.) no se crean como páginas: se gestionan en sus propios menús del administrador y se muestran en la página mediante el bloque correspondiente (ver sección 5).

3.4 Configurar el enlace permanente (slug / URL)

El slug es la parte de la URL pública.

Edítalo en el editor (icono de lápiz). Buenas prácticas: usa slugs cortos y estables; sin tildes, ñ ni caracteres especiales; evita cambiarlos una vez publicada la página.

3.5 Página superior (jerarquía)

En el panel lateral, en Página → Página superior (Atributos de página), puedes asignar una página padre. Sirve para organizar el listado, definir jerarquías y apoyar menús/listados de subpáginas. Ejemplo: crea la página padre “Servicios” y cada servicio como subpágina.

3.6 Idioma de la página (Polylang)

Cada idioma se gestiona como una página distinta vinculada a su traducción. En el panel lateral localiza el bloque Idiomas (Polylang), indica el idioma y usa el icono “añadir traducción” para crear la otra versión. Mantén la misma estructura de bloques cuando el diseño deba ser equivalente y revisa el slug en cada idioma (“servicios” / “services”).

3.7 Configuración SEO de la página

El SEO y Open Graph se configuran en las cajas meta al pie de la página.

Buenas prácticas: título SEO claro; descripción de 140–160 caracteres; imagen OG adecuada si la página se comparte.

3.8 Guardar, publicar y actualizar

Solo las páginas Publicadas se muestran en el frontend. Si el cambio no se ve, verifica el estado y usa Limpiar Cache.

4. Descripción de bloques (detallada)

Los bloques son las piezas con las que se arma el contenido de cada página. Tres familias: Estructura (organizan el layout), Contenido visual (textos/imágenes editados en el propio bloque) y Módulos (datos de un CPT — sección 5).

Muchos bloques comparten opciones de espaciado (padding/margin/gap por dispositivo), bordes/radio y color de fondo. Aquí se listan de forma completa en Contenedor, Grilla y Carrusel; en el resto se documentan sus opciones propias.

4.1 Contenedor

Para qué sirve: bloque base de estructura. Agrupa otros bloques en un área con columnas, espaciado, fondo y anchos responsivos. Cómo usarlo: insértalo, añade bloques hijos dentro y ajusta columnas, gaps, padding y fondo.

Opciones — Ancho del contenedor

Opciones — Columnas del contenedor

Opciones — Distribución de bloques hijos

Opciones — Espaciado (gap)

Opciones — Alineación de elementos

Opciones — Estilos / Dimensiones

4.2 Grilla

Para qué sirve: diseño en filas y columnas con posicionamiento visual de cada hijo (mosaicos, proporciones desiguales: 50/50, 1/3–2/3, sidebar). Cómo usarlo: define filas/columnas por dispositivo, coloca cada hijo y asígnale posición (fila, columna, span) en el constructor.

Opciones — Ancho del contenedor: iguales a las del Contenedor (ancho %, alineación, max/min width y unidades).

Opciones — Vista previa en editor

Opciones — Estructura de grilla

Opciones — Ancho de columnas (por dispositivo)

Opciones — Constructor visual

Opciones — Alineación de contenidos (por viewport activo): horizontal en celda (Izq/Centro/Der/Estirar), vertical en celda (Arriba/Centro/Abajo/Estirar) y posición del grupo en la fila. Gap y Estilos/Dimensiones: iguales al Contenedor.

4.3 Cabecera

Para qué sirve: encabezado de sección con icono opcional, título de dos colores y descripción. Cómo usarlo: completa el título compuesto, la descripción y el icono; define la etiqueta SEO (h1 solo si es el título principal de la página).

4.4 Banner Hero

Para qué sirve: hero principal con imagen de fondo responsiva, badge, título, descripción y botón. Cómo usarlo: sube imágenes por dispositivo y completa el contenido. Varios Banner Hero seguidos pueden comportarse como slider.

4.5 Banner Scroll

Para qué sirve: banner con efecto scroll/parallax: fondo + badge + título + contenido. Cómo usarlo: sube fondos por dispositivo y completa badge, título y contenido (WYSIWYG).

4.6 Banner Galería

Para qué sirve: sección con título compuesto, descripción, CTA y galería distinta para desktop y mobile. Cómo usarlo: configura título y CTA (enlace o descarga) y carga ambas galerías (el orden de las imágenes es el de aparición).

4.7 Accesos Directos

Para qué sirve: tarjeta compacta de acceso rápido (icono + enlace). Se usa en grupos dentro de Grilla o Carrusel. Cómo usarlo: inserta varios; en cada uno sube icono y configura el enlace (el title del enlace es el título visible).

4.8 Card

Para qué sirve: tarjeta de contenido en dos variantes: Por Defecto o Información Destacada. Cómo usarlo: elige el tipo y completa solo los campos de esa variante; agrupa varias en Contenedor/Carrusel para un listado.

4.9 Tarjetas Comerciales

Para qué sirve: tarjeta de local/tienda/comercio (logo, nombre, ubicación, icono). Cómo usarlo: una tarjeta por local, o varias en carrusel/grilla.

4.10 Card Recomended

Para qué sirve: tarjeta de recomendación vertical u horizontal, con borde, icono y enlace. Cómo usarlo: elige orientación y configura colores, título, descripción y enlace.

4.11 Feature

Para qué sirve: bloque de característica/beneficio en variante Simple o Bloque. Cómo usarlo: elige “Tipo Contenido” y completa solo los campos de esa variante; agrupa varios en Grilla para filas de beneficios.

4.12 Tabs (Pestañas)

Para qué sirve: organiza contenido en pestañas o en opciones tipo radio. Cada pestaña es un Tab Item. Cómo usarlo: inserta Tabs, añade/edita los Tab Items (etiqueta, icono opcional, bloques internos) y configura estilo, orientación y pestaña inicial.

Cada Tab Item: título del tab, icono (opcional) y contenido interno (bloques anidados). El Tab Item se gestiona desde el bloque Tabs, no suelto.

4.13 Acordeón

Para qué sirve: lista de elementos expandibles/colapsables. Cómo usarlo: “Añadir acordeón” por cada ítem, edita título y contenido, y configura comportamiento y estilos.

4.14 Carrusel Slider

Para qué sirve: secuencia deslizable de bloques hijos con controles, autoplay y ajustes por breakpoint. Cómo usarlo: “Agregar item” por cada slide (dentro inserta Cards, Accesos…), y configura general, navegación, responsive y estilos.

Ancho del contenedor: igual al Contenedor (ancho %, alineación, max/min width).

Opciones — General

Opciones — Navegación

Opciones — Responsive

Opciones — Advanced (ResizeObserver, Observer, Observe parents): déjalas por defecto. Estilos/Dimensiones: padding/margin por viewport, radio de esquinas y color de fondo.

5. Módulos de contenido y sus CPT

Los módulos insertan funcionalidades dinámicas (listados, buscadores, mapas). El dato no se crea en el bloque, sino en un CPT del menú lateral; el bloque define cómo se muestra.

¿No ves resultados? No hay registros publicados/activos en ese idioma, o el filtro por defecto no coincide. Crea/traduce el contenido en el idioma de la página (Polylang).

Relación bloque ↔ CPT

CPT auxiliar: Generador de Listas

Alimenta desplegables (tipo, categoría, etc.) en módulos y formularios. Menú: Generador de Listas → dashboard · Ver opciones · Importar/Exportar.

Cómo usarlo: crea/edita la lista (ej. Tipo de relación comercial, Tipo de negocio), añade sus opciones (términos) y publícala; las opciones inactivas/no publicadas no aparecen. Traducción: puedes traducir solo las opciones y el CMS genera la lista en el otro idioma automáticamente (misma taxonomía y slug).

5.1 Preguntas Frecuentes

Para qué sirve: listado de FAQs con filtro por categoría y paginación. Las preguntas se gestionan en el CPT, no dentro del bloque.

Cómo crear / editar una FAQ: Preguntas Frecuentes → Añadir → completa título, contenido, orden y categoría → marca Estado → Activa → asigna idioma (Polylang) y publica.

Campos del CPT

Opciones del bloque

Muestra solo FAQs del idioma actual y respeta el orden del CPT.

5.2 Documentos y reportes

Para qué sirve: listado de documentos/reportes con filtros por categoría y fecha (año/mes). Los archivos se cargan en el CPT.

Cómo crear / editar un documento: Documentos y reportes → Añadir → título, descripción, tipo de recurso (archivo o enlace), categoría → ajusta la fecha de publicación (alimenta el filtro año/mes) → marca Estado → Activo y publica.

Campos del CPT

Opciones del bloque — Título y listado

Opciones del bloque — Textos de filtros y resultados (útiles para traducir al inglés): texto de la barra de filtro, etiquetas de selector de año/mes, textos de “Limpiar/Aplicar filtro” y del contador de resultados (“Mostrando”, “resultado(s)”, “para”).

5.3 Detalle del mapa

Para qué sirve: mapa por coordenadas + información en dos columnas + CTA. Ideal para “cómo llegar” a una sede u oficina. Sin CPT: coordenadas y textos se configuran en el propio bloque.

El frontend genera el mapa a partir de las coordenadas.

6. Formularios del sitio

Cada formulario tiene dos piezas que no debes confundir:

En el editor no se rellenan las respuestas del ciudadano: se configura la presentación. Las respuestas aparecen después en el CPT.

6.1 Opciones comunes (todos los formularios)

6.2 Personalización por campo (patrón que se repite)

Para cada campo visible, el bloque genera un grupo de opciones (no todos los tipos muestran todas):

Los campos técnicos (Idioma, Estado…) los gestiona el sistema.

6.3 Contacto

Para qué sirve: formulario general de contacto. Tipo: solicitud (guarda envío). CPT: Form. Contacto → Registros. Configuración: Form. Contacto → Configuración (máscara de correo, destinatarios, plantilla de email).

6.4 Negocios

Para qué sirve: canal de interés comercial / propuestas de negocio. Tipo: solicitud en dos pasos. CPT: Form. Negocio → Registros (form_business). Configuración: Form. Negocio → Configuración (máscara, plantilla y Destinatarios por Tipo de Relación).

Paso 1 — Datos de la empresa

Paso 2 — Interés comercial

Destinatarios según la relación elegida: en ajustes del formulario → Destinatarios por Tipo de Relación, cada fila enlaza una opción de la lista (ES y EN separadas por coma, ej. Ser proveedor,Become a supplier) con sus correos. Si añades una opción nueva a la lista, agrega su fila de correos.

6.5 Reclamo / Sugerencia

Para qué sirve: gestión de reclamos o sugerencias en varios pasos. Tipo: solicitud multipaso. CPT: Form. Reclamo/Sugerencia → Registros (form_complaints_sugg). Los adjuntos se guardan en Medios (carpeta FileBird “Reclamos y Sugerencias”). En la ficha hay “Estado” y “Estado SharePoint”.

Campos configurables (principales):

6.6 Recurso Impugnatorio

Para qué sirve: recepción de recursos impugnatorios. Tipo: solicitud. CPT: Form. Recurso Impugnatorio → Registros (form_appeals). Adjuntos en FileBird “Recursos Impugnatorios”. Ficha con “Estado” y “Estado SharePoint”.

6.7 Gestión de envíos (CPT de solicitudes)

Cada envío del sitio se guarda como un registro Privado (sin URL pública). Se trabaja desde Form. … → Registros.

Cómo llega un registro: el visitante envía → WordPress crea un ítem del CPT en estado “Privado” → el título se arma con datos del envío + fecha → los campos ACF se rellenan → “Estado” queda en “Pendiente” → si el formulario envía correo, usa la plantilla y los destinatarios de Configuración → los adjuntos van a Medios y a su carpeta FileBird.

Trabajo diario: - Abrir/revisar: Registros → título. Verás los campos del usuario más los de sistema: Idioma (solo lectura), Estado (pásalo a “Leído” cuando gestiones el caso) y Estado SharePoint (solo lectura; si dice error, avisa a técnico). - Exportar: botones CSV / XLSX sobre el listado (respeta el filtro), en lote (marcar filas) o por fila. Solo perfiles con permiso de edición. - Configuración (Form. … → Configuración): máscara y correo del administrador, plantilla de email; en Reclamo/Recurso, datos de SharePoint (equipo técnico). - Buenas prácticas: trabaja desde Registros (no crees ítems a mano), no publiques el registro (déjalo Privado), exporta con filtro de fechas si el listado es grande.

7. Usuarios y roles

Sección para el Administrador del CMS. Explica cómo crear roles por área y dar de alta usuarios. Los editores de área no ven estas pantallas.

Tipos de cuenta

Regla: crea primero el rol (qué ve el área), luego el usuario y asígnale un solo rol. Lo no marcado no aparece en el menú y da “Acceso denegado” incluso pegando la URL.

7.1 Crear un rol de contenido

Usuarios → Roles de contenido → Añadir rol.

El checklist agrupa: Catálogos y contenido (FAQs, Documentos y reportes…), Formularios (Contacto, Negocio, Reclamo/Sugerencia, Recurso Impugnatorio), Plugins del proyecto (Chatbot, Generador de Listas, Dynamic Blocks) y Opciones del sitio.

Ejemplo de asignación por área: Comunicaciones (FAQs, Documentos) · Comercial (Form. Negocio) · Legal (Documentos, Reclamos, Recursos) · Atención al cliente (Contacto, Reclamos). Varias áreas pueden compartir un módulo; quien lo tenga marcado ve todos los registros de ese CPT.

7.2 Editar o eliminar un rol

Usuarios → Roles de contenido → Editar (cambia nombre o checklist) → Guardar cambios. El identificador no se edita. No se puede eliminar un rol con usuarios asignados: reasígnalos antes.

7.3 Crear un usuario

Usuarios → Añadir usuario. El rol de contenido debe existir antes.

7.4 Cambiar el rol de un usuario ya creado

Usuarios → Todos los usuarios → ficha → Rol → Actualizar usuario. Para desactivar el acceso sin borrar el historial, deshabilita o elimina el usuario según la política.

7.5 Comprobar que el permiso funciona

Buenas prácticas: TI = Administrador; el resto usa un rol de contenido. Una persona, un usuario, un rol. Marcar un módulo da acceso a todo ese CPT o plugin.

A. Apéndice de referencia

A.1 Catálogo de módulos ↔ CPT

A.2 Mapa del menú de administración

• Contenido/CPT: Páginas · Preguntas Frecuentes · Documentos y reportes · Medios
• Formularios: Form. Contacto · Form. Negocio · Form. Reclamo/Sugerencia · Form. Recurso Impugnatorio
• Herramientas del proyecto: Dynamic Blocks · Generador de Listas · Chatbot · Menús · Más Opciones
• Administración: Usuarios → Roles de contenido · Ajustes → Generales · FrontEnd Configuración (técnico)

A.3 Inventario de plugins

Propios del producto (wp-headless-*): Dynamic Blocks Builder (genera los bloques/módulos), Core (menús, opciones, header/footer, home), Form (formularios y envíos), Form List Cascading (Generador de Listas), Altcha (captcha), MFA Email OTP (segundo factor), Security (REST/GraphQL), Cache Manager (revalidación de caché), Chatbot (dashboard).

De terceros (soporte): Advanced Custom Fields Pro (campos), Polylang (multi-idioma), FileBird (carpetas de medios), LiteSpeed Cache, Windows Azure Storage, Akismet.

Wiki de Gestión de Contenidos · Entelgy DX Pro · versión detallada con imágenes.