Agregar plugin WP Debug para diagnóstico sistemático

wp-content/plugins/wp-debug/readme.txt

@@ -0,0 +1,106 @@
+=== WP Debug ===
+Contributors: Developer Team
+Tags: debug, diagnostics, performance, developer tools, wp-cli
+Requires at least: 6.0
+Tested up to: 6.8
+Requires PHP: 7.4
+Stable tag: 1.0.0
+License: GPLv2 or later
+License URI: https://www.gnu.org/licenses/gpl-2.0.html
+
+Sistema avanzado de debug y diagnóstico para WordPress. Monitorea hooks, templates, assets, queries y performance en tiempo real.
+
+== Description ==
+
+WP Debug es un sistema de diagnóstico avanzado diseñado para desarrolladores de WordPress que necesitan visibilidad completa del ciclo de rendering, hooks, queries y performance.
+
+= Características =
+
+* **Hook Monitor:** Rastrea todos los hooks de WordPress ejecutados con timestamps
+* **Template Tracer:** Identifica qué templates se cargan y en qué orden
+* **Asset Tracker:** Monitorea CSS/JS encolados con dependencias y duplicados
+* **Performance Profiler:** Mide tiempos de ejecución y detecta bottlenecks
+* **Query Analyzer:** Analiza queries SQL y detecta problemas N+1
+* **Frontend Panel:** Panel visual flotante en frontend (solo admins)
+* **WP-CLI Commands:** Comandos desde terminal para diagnóstico avanzado
+
+= Casos de Uso =
+
+* Diagnosticar por qué un sidebar no es sticky
+* Identificar hooks que no se ejecutan
+* Detectar CSS/JS que se cargan en orden incorrecto
+* Encontrar queries lentas o duplicadas
+* Medir performance de funciones críticas
+* Debugging de templates y template-parts
+
+= Comandos WP-CLI =
+
+* `wp debug status` - Ver estado del sistema
+* `wp debug hooks` - Listar hooks ejecutados
+* `wp debug templates` - Listar templates cargados
+* `wp debug export` - Exportar reporte completo
+* `wp debug clear` - Limpiar logs
+
+= API Programática =
+
+```php
+// Logging
+wp_debug_log('Mensaje de debug', 'INFO');
+
+// Performance profiling
+wp_debug_start_timer('mi_funcion');
+// ... tu código ...
+wp_debug_end_timer('mi_funcion');
+
+// Obtener datos
+$hooks = wp_debug_get_hooks();
+$templates = wp_debug_get_templates();
+```
+
+== Installation ==
+
+1. Sube la carpeta `wp-debug` a `/wp-content/plugins/`
+2. Activa el plugin desde el menú 'Plugins' de WordPress
+3. Ve a Tools → WP Debug para ver el dashboard
+4. (Opcional) Usa comandos WP-CLI para diagnóstico avanzado
+
+== Frequently Asked Questions ==
+
+= ¿Afecta el performance del sitio? =
+
+El plugin está optimizado para mínimo overhead (<5%). Se recomienda usar solo en staging/desarrollo.
+
+= ¿Puedo usarlo en producción? =
+
+Sí, pero se recomienda desactivar módulos innecesarios y usar solo en modo debug.
+
+= ¿Dónde se guardan los logs? =
+
+En `/wp-content/logs/wp-debug/` y en tablas de base de datos.
+
+= ¿Cómo lo uso en mi plugin? =
+
+Simplemente llama a las funciones API: `wp_debug_log()`, `wp_debug_start_timer()`, etc.
+
+== Screenshots ==
+
+1. Dashboard principal en Tools → WP Debug
+2. Frontend panel flotante (solo admins)
+3. Hook monitor en tiempo real
+4. Template tracer con backtraces
+5. Performance profiler con métricas
+
+== Changelog ==
+
+= 1.0.0 =
+* Release inicial
+* 8 módulos de diagnóstico
+* WP-CLI commands
+* API programática
+* Frontend panel
+* Admin dashboard
+
+== Upgrade Notice ==
+
+= 1.0.0 =
+Primera versión del plugin.