MGo - Demo Dashboards

MGo Demo Dashboards Plugin WordPress para visualizacion interactiva de datos con filtros dinamicos, graficas Chart.js, tablas paginadas y exportacion a CSV/PDF.

CARACTERISTICAS Dashboard interactivo Dos vistas: Clientes y Ventas con navegacion integrada KPIs dinamicos: Totales, importes y promedios actualizados en tiempo real Graficas Chart.js: Barras interactivas con tooltips formateados en euros Filtros avanzados: Selects dinamicos poblados desde BD (ciudad, segmento, categoria, estado) Rangos de fecha con validacion (01.01.2025 - 31.12.2025) Todos los filtros aplican consistentemente a: tabla, KPIs y graficas Tablas profesionales Paginacion server-side (20 registros por pagina) Ordenacion por columna: clic en cabecera para ASC/DESC Indicadores visuales del orden activo Enlaces interactivos (modal de detalle en clientes) Badges de estado con colores (pendiente, pagado, cancelado, reembolsado) Exportacion de datos CSV: Descarga inmediata con los filtros activos aplicados PDF: Reporte profesional con dompdf (KPIs + tabla + filtros usados) Ambos respetan filtros, ordenacion y paginacion logica Seguridad y rendimiento Nonces en todas las peticiones AJAX Sanitizacion centralizada con whitelist de campos Consultas preparadas con wpdb->prepare() Limite de filas en exportacion PDF para evitar agotar memoria Assets encolados solo cuando se usa el shortcode Responsive Diseño adaptable a movil, tablet y escritorio Tabla colapsable en pantallas pequenas Navegacion y filtros reorganizados para touch

INSTALACION Requisitos WordPress 5.6+ PHP 7.4+ MySQL 5.7+ / MariaDB 10.3+ Extensiones PHP: mbstring, xml, zip (para dompdf) Paso a paso Sube el plugin a /wp-content/plugins/: wp plugin install MGo-demo-dashboards --activate O sube la carpeta manualmente por FTP Instala dependencias PHP (dompdf): cd wp-content/plugins/MGo-demo-dashboards composer install --no-dev Si no usas Composer: descarga dompdf y colocalo en vendor/ Activa el plugin desde WordPress Admin -> Plugins. Inserta el shortcode en cualquier pagina o entrada: [demo_dashboard] O especifica vista inicial: [demo_dashboard type="ventas"] Visita la pagina y disfruta del dashboard.

ESTRUCTURA DE BASE DE DATOS El plugin crea dos tablas al activarse (prefijo wp_ configurable): wp_mgo_demo_clientes Campo Tipo Descripcion id INT UNSIGNED PK, autoincremental nombre VARCHAR(120) Nombre del cliente email VARCHAR(120) Email ciudad VARCHAR(80) Ciudad de registro segmento VARCHAR(80) Segmento comercial fecha_registro DATE Fecha de alta wp_mgo_demo_ventas Campo Tipo Descripcion id INT UNSIGNED PK, autoincremental cliente_id INT UNSIGNED FK -> clientes.id producto VARCHAR(120) Nombre del producto categoria VARCHAR(120) Categoria del producto importe DECIMAL(10,2) Importe de la venta estado ENUM pendiente, pagado, cancelado, reembolsado fecha DATE Fecha de la venta

ESTRUCTURA DE ARCHIVOS MGo-demo-dashboards/ ├── principal.php # Punto de entrada: hooks, shortcode, enqueue ├── includes/ │ ├── db.php # Modelo: consultas a BD + build_where │ └── functions.php # Controlador: sanitizacion, formateo, AJAX ├── sql/ │ ├── demo-dashboards-data.sql # Datos de ejemplo anonimizados ├── templates/ │ ├── dashboard-clientes.php # Vista: clientes │ └── dashboard-ventas.php # Vista: ventas ├── assets/ │ ├── css/ │ │ └── dashboard.css # Estilos responsive │ └── js/ │ └── dashboard.js # AJAX, Chart.js, ordenacion, exportacion ├── vendor/ # dompdf ├── composer.json # Dependencias PHP └── README.md # Este archivo

USO AVANZADO Filtros por URL Puedes pre-filtrar la vista anadiendo parametros a la URL: https://tusitio.es/demo-dashboard/?tipo=clientes&ciudad=Madrid&fecha_desde=2025-01-01 Parametro Valores posibles Aplica a tipo clientes, ventas Vista inicial ciudad Cualquier ciudad en BD Clientes segmento Cualquier segmento en BD Clientes categoria Cualquier categoria en BD Ventas estado pendiente, pagado, etc. Ventas fecha_desde YYYY-MM-DD Ambas vistas fecha_hasta YYYY-MM-DD Ambas vistas Ordenacion por defecto Para cambiar el orden inicial de la tabla, modifica init() en dashboard.js: this.args = { orderby: 'fecha_registro', order: 'DESC' }; Limite de exportacion PDF Para ajustar el maximo de filas en PDF (por defecto 200), edita mgo_demo_ajax_export_pdf(): $limit_pdf = 500;

HOOKS Y FILTROS DISPONIBLES Actions mgo_demo_tables_created: Despues de crear tablas en activacion mgo_demo_csv_data: Antes de exportar CSV (para modificar datos) mgo_demo_pdf_html: Antes de generar HTML para PDF Filtros de sanitizacion mgo_demo_campos_permitidos: Anadir campos personalizados

CREDITOS Chart.js - Graficas interactivas (MIT License) dompdf - Generacion de PDF (LGPL License) WordPress - Plataforma base (GPL)

NOTAS Antes de subir a produccion, prueba con un conjunto de datos y verifica que los filtros, ordenacion y exportacion funcionen con volumenes grandes. Para ayuda, revisa los logs en wp-content/debug.log.