https://github.com/prathushan/wp-site-inspector

A powerful admin-only tool that scans your active theme to list shortcodes, hooks, templates, APIs, post types, plugins used, and published content. Perfect for debugging and auditing complex or legacy WordPress projects.
https://github.com/prathushan/wp-site-inspector

code-mapping custom-post-types debugging developer-tools hook-inspector php plugin-development shortcode site-audit theme-audit theme-debugger theme-development wordpres-development wordpress wordpress-hooks wordpress-plugin wordpress-tools wp-cli

Last synced: 4 months ago
JSON representation

Host: GitHub
URL: https://github.com/prathushan/wp-site-inspector
Owner: prathushan
License: gpl-2.0
Created: 2025-05-15T16:35:35.000Z (5 months ago)
Default Branch: main
Last Pushed: 2025-06-12T06:09:30.000Z (4 months ago)
Last Synced: 2025-06-12T07:26:26.131Z (4 months ago)
Topics: code-mapping, custom-post-types, debugging, developer-tools, hook-inspector, php, plugin-development, shortcode, site-audit, theme-audit, theme-debugger, theme-development, wordpres-development, wordpress, wordpress-hooks, wordpress-plugin, wordpress-tools, wp-cli
Language: PHP
Homepage:
Size: 158 KB
Stars: 22
Watchers: 2
Forks: 1
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE.txt

Awesome Lists containing this project

README

# 🛠️ WP Site Inspector — Your WordPress Debug & Discovery Co-Pilot

**WP Site Inspector** is an open-source WordPress plugin for developers, freelancers, and agencies who need **instant insights** into what’s happening under the hood of any WordPress site.

Think of it as your site’s x-ray machine — mapping everything from shortcodes and hooks to REST APIs, templates, and logs.

> ⚡ No more digging through files. No more flying blind.

**👉 [⭐ Star us on GitHub](https://github.com/prathushan/WP-Site-Inspector)**
**🐞 [Report a Bug](https://github.com/prathushan/WP-Site-Inspector/issues)** · 💡 [Request a Feature](https://github.com/prathushan/WP-Site-Inspector/issues)

![Site Inspector Screenshot](./assets/site-inspector.png)

---

## ✨ Features

✅ Scan active and parent themes — *no setup needed*
✅ Instantly list shortcodes, hooks, templates, post types
✅ View full file paths & line numbers
✅ Detect REST API calls & CDN links
✅ Display all published pages, posts & CPTs
✅ Export results to `.xls`
✅ Admin-only access with security best practices
✅ Fatal error detection + email alerts
✅ Built-in AI chatbot for log analysis *(BYOK)*
✅ Multilingual UI: English, French, Spanish
✅ One-click full site `.zip` backup

---

## 🚀 Why Use It?

If you've ever said:

> “What’s even happening on this site?”
> “Where is this shortcode defined?”
> “What template is this page using?”
> “Which plugin is breaking the homepage?”

Then **WP Site Inspector** is made for you.

Perfect for debugging legacy projects, onboarding new ones, or simply understanding someone else’s codebase — this plugin gives you **superpowers**.

---

## 🔍 Use Cases

- 🧩 Auditing undocumented WP themes
- 🛠️ Debugging custom features with clarity
- 🔄 Refactoring old code safely
- 🤝 Handoff-ready documentation
- 📋 Exporting a complete technical site map

**Ideal for:**
🧑‍💻 Freelancers · 🧪 QA Engineers · 🏢 Agencies · 💡 WP Contributors · 👩‍🎓 Students

---

## 🤖 Smarter Debugging with AI (NEW!)

Bring intelligence to your debug flow using **AI Code Assistant** and **Code AI** — both powered by your own API key (BYOK).

### 🔍 AI Code Assistant — Debug Smarter, Not Harder

![Ask AI Screenshot](./assets/Ask-AI.png)

Integrate with:

- 🔑 OpenAI (ChatGPT)
- 🔑 Anthropic (Claude)
- 🔑 DeepSeek, Gemini, or OpenRouter-compatible models

Ask:

> “Why did this error happen?”
> “Which plugin triggered this warning?”
> “How do I fix this deprecated function?”

🧠 It’s like **ChatGPT for your error logs** — secure, private, and built into WP.

---

### 💻 Code AI — Your AI Pair Programmer in WP

![Code AI Screenshot](./assets/Code-AI.png)

Directly inside your theme and plugin files — BYOK-powered.

- 🧩 Understand complex or legacy functions
- 🛠️ Refactor outdated logic
- 🧪 Spot bugs and security issues
- ✍️ Generate WP-specific snippets
- 🔍 Evaluate logs inline

> Example queries:
> “What does this function do?”
> “Rewrite this as a shortcode”
> “Generate WP_Query for 5 products”

⚙️ Powered by **your choice of LLM** — no vendor lock-in.

![BYOK Illustration](./assets/byok.png)

---

## ✅ Unified BYOK Support

No subscriptions, no limits — just plug in your API key.

**Supported models:**

- OpenAI
- Anthropic
- DeepSeek
- OpenRouter

Your tools. Your rules.

---

## 📤 One-Click xls Export

Export everything with a click — clean `.xls` format.

Great for:

- 🧪 QA teams
- 🧾 Client reports
- 🔧 Dev handoffs
- 📁 Project docs

---

## 🌍 Multilingual Ready

Currently supports:

- 🇬🇧 English
- 🇫🇷 French
- 🇪🇸 Spanish

UI adapts to your site’s language automatically — no setup needed.

---

## 🔄 One-Click Backup

Back up your entire site — files + DB — in one click.
Creates a downloadable `.zip`. No extra plugins needed.

---

## 📦 Coming Soon

- ⚡ AI-powered log auto-fix
- 🔍 Plugin folder scanner
- 📁 File/function filters
- 🧪 WP-CLI integration
- 🧠 AI-based fix suggestions
- 🗃️ Visual theme dependency map

---

## ⚙️ How to Install

1. Download the `.zip` from GitHub
2. Go to `Plugins > Add New > Upload Plugin`
3. Upload and click **Install Now**, then **Activate**
4. Start inspecting via the WP Admin menu

---

## 🧠 Why We Built This

We created WP Site Inspector because:

- WordPress sites grow messy — fast
- Devs spend hours asking “What’s active and why?”
- Legacy code makes debugging painful

This plugin saves time, simplifies audits, and ensures smoother handoffs.
No fluff. No guesswork. Just answers.

---

## 📃 License

Distributed under the MIT License.

---

## 📬 Contact

We’d love your feedback or contributions!

📧 Email: `prathusha.nammi@gmail.com`
🐛 GitHub: [Open an issue](https://github.com/prathushan/WP-Site-Inspector/issues)

---

## 🙌 Authors

**Made with ❤️ by [Prathusha](https://github.com/prathushan), [Prem](https://github.com/PremKumar-Softscripts), and [Vinay](https://github.com/v-i-nay)**

**Contributions welcome** 👉 [Open a PR or feature request](https://github.com/prathushan/WP-Site-Inspector/issues)

---

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/prathushan/wp-site-inspector

Awesome Lists containing this project

README