QOL Dev Toolkit

A small, growing set of quality-of-life admin tools for WordPress — no bloat, no external services, no heavy background jobs.

Features

🖼️ Orphaned Media

Scans the Media Library for images that aren't used anywhere on the site, so you can review and clean them up manually.

Checks against:

• Featured images
• Post attachments (post_parent)
• Post content
• Custom fields / page builder data
• Theme Customizer settings (logo, background, site icon)
• Widgets

Nothing is ever deleted automatically — you review the flagged list, select what you want gone, and confirm before anything is removed.

🔗 Broken Internal Links

Automatically checks internal links whenever a post or page is saved, and flags any that no longer resolve to a real post, page, category, or tag.

• Shows a warning directly on the post edit screen when broken links are found
• Site-wide overview under Dev Toolkit → Broken Links
• "Scan All Content Now" button to check your existing content in one pass
• Only checks internal links — never makes outbound HTTP requests

Installation

1. Download or clone this repo
2. Upload the folder to /wp-content/plugins/ so the path looks like:

   /wp-content/plugins/qol-dev-toolkit/qol-dev-toolkit.php

3. Activate QOL Dev Toolkit from the Plugins screen
4. Find both tools under the new Dev Toolkit menu in the WordPress admin sidebar

Alternatively, zip the qol-dev-toolkit folder and install it via Plugins → Add New → Upload Plugin.

Requirements

• WordPress 5.8 or later
• PHP 7.4 or later

Permissions

Every screen & every action in this plugin requires the manage_options capability — by default, only Administrators can access it.

Notes & Limitations

• On very large media libraries, the orphaned-media scan can take a little longer since some of its checks aren't index-friendly. This is a deliberate trade-off to keep the tool lightweight rather than adding a full background-job system.
• The broken link checker's category/tag detection is best-effort — links to custom taxonomies with unusual slugs may occasionally show up as a false positive. Worth a quick glance before treating every flagged link as truly broken.

Roadmap

This plugin is intended to grow over time with more small, focused quality-of-life tools. Suggestions and pull requests are welcome.

Changelog

1.0.0

• Initial release
• Orphaned media detection and cleanup
• Broken internal link checker

License

Licensed under the GPL v2 or later, the same license as WordPress itself.

Author

Pathmaka Galappaththi

Credits

Built with the help of Claude (Anthropic).