⚡ DevForge — Developer Toolkit

The Ultimate All-in-One Development & Debugging Suite for WordPress Theme and Plugin Developers.

Features • Multisite • Installation • Frontend HUD • Admin Console

---

📖 Overview

DevForge is a development-only WordPress plugin designed from the ground up to solve daily friction points encountered by theme and plugin creators across single-site and multisite network installations.

Tired of hard-refreshing your browser when changing CSS/JS files? Losing track of which PHP template is loading in a complex hierarchy? Need to inspect debug.log in real time without digging through terminal tabs? DevForge brings all of this directly into your WordPress workspace with an obsidian dark developer interface.

---

✨ Key Features

🌐 1. First-Class Multisite Network Support

• Network Admin & Subsite Menus: Accessible from both Network Admin (/wp-admin/network/) and individual subsite dashboards.
• Super Admin & Admin Access: Seamless permission model honoring is_super_admin() across all subsites and network screens.
• Network Transients Cleanup: Purges both site transients from $wpdb->sitemeta and subsite transients from $wpdb->options.
• Multisite Context in HUD: Floating HUD displays the active Site ID (Site #1), site name, and domain.

⚡ 2. Cache & State Buster

• 1-Click Global Flush: Flushes Object Cache, Transients, Rewrite Rules, and OpCache in one click.
• Granular Flushers: Flush individual caches (Object, Transients, Rewrites, OpCache, Block Caches).
• Automatic Asset Cache-Busting: Automatically attaches dynamic timestamps (?ver=microtime()) to all local enqueued styles and scripts. Say goodbye to stale CSS and JS!
• Block / FSE Cache Clear: Clears theme.json cache and block template transient caches.

🐛 3. Real-Time Debug Log Console

• Instant Log Viewer: Efficient tail reader for wp-content/debug.log without loading huge files into memory.
• Live Auto-Refresh: Continuously polls and streams the log every 3 seconds while you work.
• 📋 Copy All or Selected Logs:
  • Copy All Visible: 1-click button to copy every currently filtered log entry to your clipboard.
  • Copy Selected: Multi-select logs using checkboxes (with "Select All" toggle) to copy only the specific errors you need.
  • Single Entry Copy: Convenient 📋 Copy button on every log entry card for instant stack trace copying.
  • Clean Formatting: Formatted with timestamps, severity levels, messages, and full stack traces, ideal for pasting into GitHub issues, tickets, or AI prompts.
• Level Filtering & Search: Categorize logs by severity tag:
  • ● Fatal Errors
  • ● Warnings
  • ● Notices
  • ● Deprecated
• Log Utilities: 1-click Clear, direct Download (.log file), and safe Test Error Trigger buttons to verify custom error handlers.

🎨 4. Theme & Template Hierarchy Inspector

• Active Template Identifier: Instantly reveals the exact PHP or Block template rendering the current page.
• Template Parts Loaded: Lists every get_template_part() call along with its individual execution time.
• Query Conditionals: Visual badges for active conditionals (is_front_page, is_single, is_archive, is_paged, etc.).
• Queried Object Info: Displays queried object type, ID, slug, and post title.

👥 5. Instant User Switcher

• Role & User Switching: Switch into any user account (Administrator, Editor, Author, Subscriber) with 1 click to test permissions, front-end visibility, or checkout flows without typing passwords.
• Secure Session: Uses HMAC-signed authentication tokens.
• Fast Revert: Prominent top-bar banner to switch back to your original administrator account at any time.

📬 6. Local Mail Trap

• Safe Local Interception: Intercepts wp_mail() calls locally in dev environments—no accidental emails sent to real users.
• Rich Preview Modal: View rendered HTML emails and plain text with recipient, subject, and header inspection.
• Test Email Sender: Verify email triggers with a 1-click test button.

🖥️ 7. System & Config Audit

• Real-time audit of key WordPress debugging constants:
  • WP_DEBUG
  • WP_DEBUG_LOG
  • WP_DEBUG_DISPLAY
  • SCRIPT_DEBUG
  • SAVEQUERIES
• Server metrics: PHP version, MySQL version, PHP memory limits, max execution time, and total queries.

---

🎮 Frontend HUD Inspector

When viewing your site on the frontend as an administrator, DevForge displays a sleek floating pill in the bottom-right corner:

┌─────────────────────────────────────────────────────────────┐
│ ⚡  0.08s  •  🧠 18.2MB  •  🗄️ 24 Qs  •  📄 single-post.php  │
└─────────────────────────────────────────────────────────────┘

Keyboard Shortcuts

Shortcut	Action
Alt + D	Toggle the Frontend Inspector HUD panel
Click on Template Path	Copies relative template path to clipboard

---

🛠️ Admin Developer Console

Access the full suite directly in your WordPress dashboard under:

Tools → DevForge ⚡

Tabs included:

1. 🐛 Debug Log: Live log console, search, filters, test triggers.
2. ⚡ Cache & Assets: Toggle asset cache-busting, run granular flushes.
3. 🎨 Theme & Hierarchy: Active theme details and hierarchy guide.
4. 📬 Mail Trap: Intercepted emails table and modal previewer.
5. 👥 User Switcher: Fast role switching table.
6. 🖥️ System & Constants: Config inspection and server environment overview.

---

📂 File Architecture

wp-content/plugins/devforge/
├── devforge.php                     # Plugin header, constants, and bootstrapper
├── README.md                        # Documentation & quick-start guide
├── readme.txt                       # WordPress.org standard plugin readme
├── includes/
│   ├── class-devforge-cache.php     # Cache flushes & script/style ver busting
│   ├── class-devforge-logger.php    # debug.log tailing, grouping & filters
│   ├── class-devforge-inspector.php # Template hierarchy, query & performance HUD
│   ├── class-devforge-users.php     # Fast user switching & HMAC token sessions
│   ├── class-devforge-mail.php      # wp_mail interception & HTML previewer
│   └── class-devforge-admin.php     # Admin console, Top Admin Bar & AJAX handlers
└── assets/
    ├── css/
    │   ├── devforge-admin.css       # Obsidian dark theme for admin console
    │   └── devforge-hud.css         # Glassmorphic floating HUD styles
    └── js/
        ├── devforge-admin.js        # Polling, live filters, toasts & AJAX actions
        └── devforge-hud.js          # HUD drawer toggle, shortcut (Alt+D), copy

---

🚀 Installation

1. Clone or copy the devforge directory into your WordPress plugins folder:

   wp-content/plugins/devforge/

2. Navigate to WordPress Admin → Plugins → Installed Plugins.
3. Locate DevForge - Developer Toolkit and click Activate.
4. Access the developer console under Tools > DevForge ⚡ or use the Admin Bar at the top of any page.

---

🔒 Security Note

[!IMPORTANT] DevForge is designed strictly for local and staging development environments. All AJAX endpoints and dashboard features require manage_options administrative capabilities and secure nonce verification. Do not install or activate on public production environments.

---

📄 License

DevForge is open-source software licensed under the GNU General Public License v2.0 or later.