107 lines
3.1 KiB
Plaintext
107 lines
3.1 KiB
Plaintext
=== 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.
|