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