Agile Debug

📋 Overview

Agile Debug is a powerful WordPress debugging and development tool that helps developers monitor, log, and analyze WordPress hooks, filters, and custom debug messages during development and troubleshooting.

🎯 What Does This Plugin Do?

Agile Debug provides three main debugging features:

1. Debug Logger

• Log custom debug messages with automatic file and line number tracking
• Use the alog() function to log any variable, array, or object
• Clear accumulated logs with a single click
• View detailed log entries with collapsible sections showing:
  • File name and line number
  • Debug message
  • Full file path
  • Complete object/array data in pretty-printed format

2. Active Hooks Viewer

• Display all currently active WordPress hooks (actions)
• Shows hook names and their execution count
• Helps identify which hooks are being triggered on each page

3. Active Filters Viewer

• List all registered WordPress filters
• Shows filter names and the number of callbacks attached to each
• Essential for understanding filter chain dependencies

💡 Why You Need This Plugin

For Developers:

• Speed Up Development: Quickly debug custom code without writing separate log files
• Understand WordPress: Visualize how hooks and filters flow through your site
• Troubleshoot Issues: Identify what's happening at specific points in your code execution
• Track Variables: Log arrays and objects to inspect their structure and values

For Debugging:

• Non-invasive logging - doesn't interrupt site functionality
• All logs stored safely in WordPress database options
• Admin panel access only - secure debugging information

📦 Installation

Method 1: Manual Installation (Recommended)

1. Download the agile-debug plugin folder
2. Place it in /wp-content/plugins/ directory on your WordPress installation
3. Go to WordPress Admin Dashboard → Plugins
4. Find "Agile Debug" in the plugin list
5. Click Activate

Method 2: Upload via Dashboard

1. Go to WordPress Admin Dashboard → Plugins → Add New
2. Click Upload Plugin
3. Select the agile-debug folder (zipped)
4. Click Install Now → Activate

🚀 How to Use

Access the Plugin

Once activated, you'll see "Agile Debug" in the WordPress admin menu with three sections:

• Agile Dbg - Main debug log viewer
• Active Hooks - View all active WordPress hooks
• Active Filters - View all registered filters

Using the Debug Logger

Add logging to your WordPress theme or plugin code:

// Simple message logging
alog('User ID retrieved');

// Log arrays and objects
alog('User Data', $user_array);

// Log filter hooks
alog('my_filter_name', 'FILTERHOOK');

Understanding the Logger Output

Each log entry shows:

• Filename & Line Number: Where the alog() call was made
• Message: Your custom debug message
• Expandable Section: Click to see full file path and complete object details

Clearing the Log

Click the Clear Log button at the top of the debug page to delete all accumulated log entries.

📝 Plugin Information

• Plugin Name: Agile Debug
• Current Version: 1.4
• Author: Sikandar Abbas

🎨 Features

✅ Easy-to-use debug logging function
✅ Collapsible log entries for better readability
✅ View active hooks and filters in real-time
✅ Database-backed log storage
✅ Clear logs with one click
✅ Secure admin-only access
✅ No external dependencies (uses built-in jQuery)

🔧 System Requirements

• WordPress 3.0 or higher
• PHP 5.6 or higher
• Admin access required to use

📚 Example Usage

// In your plugin or theme

// Log a simple message
alog('Custom admin page loaded');

// Log user information
$current_user = wp_get_current_user();
alog('Current User', $current_user);

// Log post data
$post = get_post(123);
alog('Post Data', $post);

// Log filter hooks
alog('wp_footer', 'FILTERHOOK');

🛠️ Troubleshooting

Q: Why don't I see the plugin in my admin menu?
A: Ensure the plugin is activated and you're logged in as an administrator.

Q: Are debug logs visible to site visitors?
A: No. The debug logs are only visible in the WordPress admin panel and require admin access.

Q: Does this slow down my site?
A: No. The plugin only activates in the admin panel and has minimal overhead.

📞 Support

For issues or questions about this plugin, contact:

• Author: Sikandar Abbas

---

Happy Debugging! 🐛

This plugin makes WordPress development easier and faster by providing essential debugging tools right in your admin panel.