Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/darwinroa/xenttia-test-form-plugin-wp/archive/refs/heads/main.zipFormulario interactivo y sistema de evaluación diagnóstica para WordPress del Índice de Bienestar Integral Xenttia (IBI-X).
Este plugin permite a los usuarios realizar un test autoaplicado de 30 preguntas organizadas en 6 dimensiones, asignando automáticamente un perfil de bienestar, generando un desglose visual por dimensión y entregando recomendaciones personalizadas. Además, cuenta con un completo panel de administración dentro de WordPress para consultar, filtrar, notificar y exportar la información capturada.
🌟 Características Principales
🎨 Frontend Interactivo y Diseño de Marca
- Paso a Paso (Multi-step Wizard): Experiencia fluida dividida en 7 etapas (Datos personales + 6 dimensiones) para evitar la fatiga del usuario.
- Tipografías y Paleta Oficial de Xenttia: Integración nativa con Ovo (titulares serif elegantes) y Manrope (cuerpo de texto y botones), utilizando la paleta oficial (
#417572,#D5E8DF,#F2F0EC,#9C9258). - Validaciones en Tiempo Real: Impide avanzar si no se ha completado la información obligatoria de la dimensión actual.
- Visualización de Resultados:
- Puntaje Global en escala de 0 a 100.
- Perfil Asignado según metodología IBI-X.
- Lista de fortalezas y áreas que requieren atención.
- Barras visuales por dimensión clasificadas en: Atención prioritaria, Área sensible, Área estable o Fortaleza actual.
- Recomendaciones automáticas agrupadas por dimensión.
🛡️ Backend & Panel de Administración (WP-Admin)
- Menú "Índice de Bienestar": Menú dedicado en la barra lateral de WordPress.
- Notificaciones de Nuevos Registros: Distintivo rojo de alertas (Badge) en el menú de WordPress con el número de evaluaciones no leídas (
Índice de Bienestar [N]). - Tabla Paginada y Filtros:
- Paginación configurable (25, 50 o 100 elementos por página).
- Búsqueda por texto (Nombre, Correo o Teléfono).
- Filtro por Rango de Fechas (Desde / Hasta).
- Filtro por Perfil de Bienestar.
- Modal Ficha de Registro: Ventana emergente con el detalle completo de respuestas y desgloses por dimensión sin salir de la página.
- Acciones en Lote: Marcar múltiples registros como Leído, No leído o Eliminar.
- Exportador a CSV (UTF-8 con BOM): Descarga un reporte completo respetando los filtros o búsquedas aplicadas en pantalla, optimizado para Excel y Google Sheets.
- Módulo de Estadísticas y Análisis: Gráfico visual de distribución por perfiles de la comunidad para evaluar la salud general.
- Notificaciones por Correo Electrónico: Configuración para enviar alertas automáticas a uno o múltiples destinatarios cuando un usuario complete el test.
📐 Metodología y Lógica de Evaluación (IBI-X)
Estructura del Test:
- Total Preguntas: 30 (5 preguntas por dimensión).
- Escala Likert: 1 a 5 (1 = Nunca, 2 = Casi nunca, 3 = A veces, 4 = Casi siempre, 5 = Siempre).
Dimensiones Evaluadas:
- Bienestar Emocional (Q1 - Q5)
- Bienestar Personal (Q6 - Q10)
- Bienestar Relacional (Q11 - Q15)
- Bienestar en la Intimidad (Q16 - Q20)
- Bienestar Corporal y Energético (Q21 - Q25)
- Bienestar de Propósito y Sentido (Q26 - Q30)
Fórmula de Cálculo:
$$\text{Puntaje Final} = \left( \frac{\text{Puntaje Obtención Total}}{150} \right) \times 100$$
Perfiles de Resultado:
- 0 a 39: Perfil Desconectado
- 40 a 59: Perfil en Pausa
- 60 a 74: Perfil en Construcción
- 75 a 89: Perfil en Equilibrio
- 90 a 100: Perfil en Plenitud Consciente
💻 Instalación y Uso
- Descarga o clona la carpeta
xenttia-ibi-formdentro del directorio de plugins de tu sitio WordPress:wp-content/plugins/xenttia-ibi-form/ - Ve al panel de administración WordPress > Plugins y activa Xenttia - Índice de Bienestar Integral (IBI-X).
- Para mostrar el formulario en cualquier página, entrada o maquetador (Elementor, Divi, Gutenberg), inserta el siguiente shortcode:
[xenttia_ibi_form]
📁 Estructura del Proyecto
xenttia-ibi-form/
├── assets/
│ ├── css/
│ │ ├── ibi-style.css # Estilos CSS Frontend de la marca Xenttia
│ │ └── ibi-admin.css # Estilos CSS Backend para WP-Admin
│ └── js/
│ ├── ibi-script.js # Script interactivo del test y AJAX público
│ └── ibi-admin.js # Script del panel admin, modals y acciones
├── includes/
│ ├── class-ibi-activator.php # Creación de tabla SQL (wp_xenttia_ibi_responses)
│ ├── class-ibi-admin.php # Panel de control, estadísticas y ajustes
│ ├── class-ibi-exporter.php # Generador y descargador de reportes CSV
│ ├── class-ibi-form-handler.php # Procesamiento AJAX, cálculos y mails
│ └── class-ibi-shortcode.php # Renderizado HTML del shortcode [xenttia_ibi_form]
├── README.md # Documentación del proyecto
└── xenttia-ibi-form.php # Archivo principal del plugin WordPress
⚙️ Requisitos
- WordPress: 5.8 o superior.
- PHP: 7.4 o superior.
- MySQL: 5.6 / MariaDB 10.1 o superior.
- Navegadores: Chrome, Safari, Firefox, Edge.
📄 Licencia
Desarrollado para Xenttia. Todos los derechos reservados.