WP Doctor 🩺

A diagnostic & troubleshooting toolbox for the WordPress admin panel — inspect post types, capabilities, admin menus, active plugins and more to find the source of admin-panel problems.

جعبه‌ابزار تشخیص و عیب‌یابی برای پنل ادمین وردپرس — بررسی پست‌تایپ‌ها، Capabilityها، منوهای ادمین، پلاگین‌های فعال و موارد دیگر برای پیدا کردن منشأ مشکلات پنل ادمین.

🚧 In active development — Version 1.0.0 ships a working diagnostics dashboard; more tools are on the roadmap below. 🚧 در حال توسعه‌ی فعال — نسخه‌ی ۱.۰.۰ یک داشبورد تشخیصی کارا دارد؛ ابزارهای بیشتری در roadmap پایین در راه است.

English · فارسی

---

🇬🇧 English

WP Doctor is a single-screen diagnostic tool for WordPress. When the admin panel misbehaves — missing menus, stripped capabilities, plugin conflicts — WP Doctor surfaces the underlying state so you can find the cause fast, instead of guessing.

• Type: WordPress plugin (admin tool)
• Requires: WordPress 5.0+, PHP 7.4+, capability manage_options
• Bilingual: English + Persian (RTL-aware admin UI)
• License: GPL-2.0-or-later
• Origin: extracted from the YJ19 WordPress theme toolkit, now a standalone tool.

Current Features (v1.0.0)

• Environment overview: WordPress / PHP versions, active theme, current user & roles
• Debug flags: WP_DEBUG, WP_DEBUG_LOG, SCRIPT_DEBUG status
• Capabilities: the current user's caps (edit_posts, edit_pages, manage_options, …)
• Post types: every registered post type with public / show_ui / show_in_menu / DB count / in-admin-menu / diagnostic status columns
• Admin menus: the live admin menu tree from global $menu
• Plugins: active plugins + MU-Plugins
• Initial diagnosis: a summary section that suggests next troubleshooting steps

Roadmap (planned)

• 🔍 Hook Inspector — list all active actions / filters
• 📊 Options Viewer — browse & search wp_options
• 🗄️ DB Inspector — table status, size, row counts
• 🌐 REST API Tester — test WP REST endpoints
• ⏱ Performance — query info, memory, transients
• 📝 Error Log Viewer — read debug.log in the browser
• 🔐 Role & Capability Manager — view & edit roles

Installation

1. Copy the wp-doctor-plugin folder into wp-content/plugins/ (or zip it and upload from the Plugins screen)
2. In wp-admin → Plugins → activate WP Doctor
3. A new menu appears: 🩺 WP Doctor in the admin sidebar

Direct URL:

/wp-admin/admin.php?page=wp-doctor

Author

Yalda Jahanshahi — yaldajahanshahi.ir · @Yaldaj19

---

🇮🇷 فارسی

WP Doctor یک ابزار تشخیصی تک‌صفحه‌ای برای وردپرس است. وقتی پنل ادمین رفتار عجیب نشان می‌دهد — منوهای غایب، capabilityهای حذف‌شده، تداخل پلاگین — WP Doctor وضعیت زیرین را نمایش می‌دهد تا به‌جای حدس زدن، سریع منشأ مشکل را پیدا کنید.

• نوع: افزونه‌ی وردپرس (ابزار ادمین)
• نیازمندی‌ها: وردپرس ۵.۰ به بالا، PHP 7.4 به بالا، کاربر با capability manage_options
• دوزبانه: انگلیسی + فارسی (رابط ادمین با پشتیبانی RTL)
• مجوز: GPL-2.0-or-later
• خاستگاه: از جعبه‌ابزار قالب YJ19 استخراج شده و حالا یک ابزار مستقل است.

امکانات فعلی (نسخه ۱.۰.۰)

• نمای محیط: نسخه‌ی وردپرس / PHP، قالب فعال، کاربر فعلی و نقش‌ها
• پرچم‌های دیباگ: وضعیت WP_DEBUG, WP_DEBUG_LOG, SCRIPT_DEBUG
• Capabilityها: capabilityهای کاربر فعلی (edit_posts, edit_pages, manage_options, …)
• پست‌تایپ‌ها: همه‌ی پست‌تایپ‌های ثبت‌شده با ستون‌های public / show_ui / show_in_menu / تعداد در DB / در منوی ادمین / وضعیت تشخیصی
• منوهای ادمین: درخت زنده‌ی منوی ادمین از global $menu
• پلاگین‌ها: پلاگین‌های فعال + MU-Plugins
• تشخیص اولیه: بخش خلاصه که قدم‌های بعدی عیب‌یابی را پیشنهاد می‌دهد

نقشه‌ی راه (برنامه‌ریزی‌شده)

• 🔍 Hook Inspector — لیست همه‌ی actions / filters فعال
• 📊 Options Viewer — مرور و جستجو در wp_options
• 🗄️ DB Inspector — وضعیت جداول، اندازه، تعداد رکورد
• 🌐 REST API Tester — تست endpointهای WP REST
• ⏱ Performance — اطلاعات query، حافظه، transientها
• 📝 Error Log Viewer — مشاهده‌ی آنلاین debug.log
• 🔐 Role & Capability Manager — مشاهده و ویرایش نقش‌ها

نصب

۱. پوشه‌ی wp-doctor-plugin را در wp-content/plugins/ کپی کنید (یا ZIP کرده و از صفحه‌ی افزونه‌ها آپلود کنید) ۲. در پیشخوان وردپرس → افزونه‌ها → WP Doctor را فعال کنید ۳. منوی جدید: 🩺 WP Doctor در سایدبار ادمین

آدرس مستقیم:

/wp-admin/admin.php?page=wp-doctor

نویسنده

یلدا جهانشاهی — yaldajahanshahi.ir · @Yaldaj19

License

GPL-2.0-or-later