=== 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.
