WP Manifestindependent plugin directory
manifest / forms / xenttia-test-form-plugin-wp

Xenttia - Índice de Bienestar Integral (IBI-X)

Formulario interactivo del Índice de Bienestar Integral Xenttia con evaluación por 6 dimensiones, asignación de perfil y recomendaciones personalizadas.

★ 0stars

Install

Download source zip No release zip yet

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.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Formulario 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:

  1. Bienestar Emocional (Q1 - Q5)
  2. Bienestar Personal (Q6 - Q10)
  3. Bienestar Relacional (Q11 - Q15)
  4. Bienestar en la Intimidad (Q16 - Q20)
  5. Bienestar Corporal y Energético (Q21 - Q25)
  6. 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

  1. Descarga o clona la carpeta xenttia-ibi-form dentro del directorio de plugins de tu sitio WordPress:
    wp-content/plugins/xenttia-ibi-form/
  2. Ve al panel de administración WordPress > Plugins y activa Xenttia - Índice de Bienestar Integral (IBI-X).
  3. 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.