PHPackages devmonowar/janitorix-media-audit - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. devmonowar/janitorix-media-audit ActiveWordpress-plugin devmonowar/janitorix-media-audit ================================ Finds unused images and removes them safely — by proving they are unused first. 1.0.1(2d ago)01↑2900%GPL-2.0-or-laterPHPPHP >=7.4CI passing Since Aug 22Pushed todayCompare [ Source](https://github.com/devmonowar/janitorix-media-audit)[ Packagist](https://packagist.org/packages/devmonowar/janitorix-media-audit)[ RSS](/packages/devmonowar-janitorix-media-audit/feed)WikiDiscussions main Synced today READMEChangelogDependencies (4)Versions (2)Used By (0) Janitorix Media Audit ===================== [](#janitorix-media-audit) > A WordPress plugin that finds unused images and removes them **safely** — by proving they are unused first. > > **Status:** v1.0.0 — first stable release, shipped. **Plugin name**Janitorix Media Audit**Current version**1.0.0**Distribution**[GitHub Releases](https://github.com/devmonowar/janitorix-media-audit/releases) — WordPress.org listing not published yet**Namespace**`JanitorixMediaAudit\`**Prefix**`JANITORIX_`**License**[GPL-2.0-or-later](LICENSE) — required by WordPress.org, and not optional: WordPress itself is GPL--- What this repository is ----------------------- [](#what-this-repository-is) A complete, working WordPress plugin — eleven scanners, a Confidence Engine, a Risk Engine, a Recommendation Engine, and five admin screens (Dashboard, Images, Image Details, Scan History, Settings). See `readme.txt` for the full feature description and changelog, or the [help docs](docs/README.md) for how to use it. The plugin is not yet listed on WordPress.org — install it from a [GitHub release](https://github.com/devmonowar/janitorix-media-audit/releases) in the meantime. --- Start here ---------- [](#start-here) If you want to…Read**Use the plugin**[docs/README.md](docs/README.md) — Getting Started, Understanding Your Results, Staying Safe, FAQ**Extend it** — hook into a scan or add a scanner[Developer Hooks](docs/hooks.md)Know what shipped and when`readme.txt` → Changelog--- The idea in one screen ---------------------- [](#the-idea-in-one-screen) Other cleanup plugins say `Unused. Delete?` This one says: ``` Unused. Confidence 97% Risk Very Low Why? ✓ Not used in Posts (2,431 checked) ✓ Not used in Pages (184 checked) ✓ Not used in Elementor (56 documents parsed) ✓ Not used in ACF (312 fields resolved) ✓ Not used in Theme Options ✓ No broken references ✓ 100% scan coverage · 42 checks Recommendation: Move to Trash ``` Every score has a reason. Every recommendation has evidence. Nothing is deleted in one step. --- Documentation ------------- [](#documentation) ``` docs/ ├── README.md ← index — start here ├── getting-started.md ← install it, run your first scan, see what comes back ├── understanding-your-results.md ← what Confidence, Risk, and each recommendation mean ├── staying-safe.md ← what the plugin will never do, how Trash/Restore work ├── faq.md ← quick answers to the questions people ask most └── hooks.md ← developer hooks, for extending scanners ``` For installation requirements, the full changelog, and the short-form FAQ, see `readme.txt` — that's also what will show up on the plugin's WordPress.org listing page once published. --- Installation ------------ [](#installation) 1. Download the latest release from [GitHub Releases](https://github.com/devmonowar/janitorix-media-audit/releases). 2. Upload the plugin via **Plugins → Add New → Upload Plugin**, or extract it into `/wp-content/plugins/`. 3. Activate it through the **Plugins** screen. 4. Open the new **Janitorix** menu in the WordPress admin sidebar and click **Start the first scan**. Requirements ------------ [](#requirements) - WordPress 6.2+ — every table name is passed to `$wpdb->prepare()` as a `%i` identifier placeholder, and `%i` was added in 6.2 - PHP 7.4+ - Elementor supported directly; other page builders (Divi, Bricks, Oxygen) fall back to a conservative scanner that blocks deletions it can't verify rather than guessing. Development ----------- [](#development) ``` composer install composer test # safety-invariant tests — no WordPress or database needed composer analyse # PHPStan composer lint # PHPCS (WordPress Coding Standards) composer check # test + analyse + lint ``` --- Core principles --------------- [](#core-principles) **Engine first, features second.** Build the architecture, then the UI, then the features. A feature-first plugin needs its core rewritten every time something is added. **Scanners find. Engines decide.** A scanner's only job is to answer *"which images does this content reference?"* and report evidence. It never calculates confidence, never assesses risk, never deletes anything. That single rule is what lets a Bricks or Divi scanner be added years from now without touching the Core Engine. Note which way round the question is asked. *"Where is this image used?"* — once per attachment — is O(images × content) and dies on a real site. Every scanner instead answers *"which images does this content reference?"* once per content item — see the `Scanner` contract in [`src/Scanner/Contracts/`](src/Scanner/Contracts/). **Trash first, delete later.** The strongest recommendation the plugin will ever make for an unused image is *Move to Trash*. Permanent deletion is only offered afterwards, from the Trash. This bounds the damage if the Confidence Engine is ever wrong — and occasionally it will be. **Never show a score without a reason.** Users are never asked to trust a number they cannot inspect. --- License ------- [](#license) [GPL-2.0-or-later](LICENSE). --- > **"Scan with evidence, analyze with confidence, clean with safety."** ### Health Score 36 — LowBetter than 79% of packages Maintenance100 Actively maintained with recent releases Popularity2 Limited adoption so far Community6 Small or concentrated contributor base Maturity33 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 2d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/32286368?v=4)[devmonowar](/maintainers/devmonowar)[@devmonowar](https://github.com/devmonowar) --- Top Contributors [![devmonowar](https://avatars.githubusercontent.com/u/32286368?v=4)](https://github.com/devmonowar "devmonowar (5 commits)") ### Code Quality Static AnalysisPHPStan Code StylePHP\_CodeSniffer Type Coverage Yes ### Embed Badge ![Health badge](/badges/devmonowar-janitorix-media-audit/health.svg) ``` [![Health](https://phpackages.com/badges/devmonowar-janitorix-media-audit/health.svg)](https://phpackages.com/packages/devmonowar-janitorix-media-audit) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)