UploadSleuth 1.0.2

UploadSleuth 1.0.2

This release adopts the new UploadSleuth – Media Audit & Cleanup name and hardens every filesystem action for WordPress.org directory review.

Highlights

• Renamed the plugin, package, dashboard, WP-CLI command, and text domain to upload-sleuth.
• Limited quarantine, restore, backup, and delete operations to file types recognised by WordPress.
• Kept --all-files available for reporting while preventing it from expanding filesystem-action scope.
• Replaced WP-CLI backup trees with one verified ZIP archive.
• Stored runtime files only below the dedicated uploads/upload-sleuth directory.
• Added direct-access protection files and a non-executable suffix for quarantined files.
• Rejected symbolic links during quarantine and restore operations.

All findings remain review candidates rather than guarantees that a file is unused.

Media Audit 1.0.1

Media Audit 1.0.1

Version 1.0.1 makes the WordPress admin experience more consistent and gives users clearer guidance before they act on audit findings.

What's improved

• The Settings tab now uses the same available width as the other Media Audit sections.
• The How it works page has been expanded from a short summary into a practical guide.

The guide now explains

• How Media Audit limits scans to WordPress uploads and applies scope and ignore rules.
• How files are matched against Media Library metadata and database references.
• What each finding label means, including fast-scan and partial results.
• When to use quarantine, ZIP-and-remove, or permanent deletion.
• What to review before removing files from a live site.

This patch does not change the scan engine or cleanup behavior. Findings remain review candidates, and quarantine is still the recommended first cleanup step.

Download media-audit-1.0.1.zip below or review the full comparison from 1.0.0 to 1.0.1.

Media Audit 1.0.0

Media Audit 1.0.0

Version 1.0.0 is the first stable release of Media Audit: a WordPress tool for finding files that may be unused, checking Media Library integrity, and cleaning up uploads through guarded, review-first workflows.

Audit WordPress uploads

• Scan the complete uploads directory or start with a specific year, month, or subdirectory.
• Match files against attachment originals, generated image sizes, edited copies, and recorded backup sizes.
• Search posts, metadata, options, and configured custom tables for file references.
• Stop a long-running scan without losing findings from completed batches.
• Filter, sort, and review large result sets without rendering every row at once.

Clean up more safely

• Preview file actions with dry-run mode.
• Move files to quarantine and restore them to their original paths when needed.
• Download a ZIP backup before removing originals.
• Permanently delete selected findings or all current findings with progress feedback.
• Revalidate references before actions to detect files that became referenced after the scan.
• Tune scan and action batch sizes for slower servers.

Check Media Library integrity

• Find attachment records whose original local file is missing.
• Report generated image sizes that are recorded in metadata but absent from disk.
• Remove confirmed leftover attachment records through WordPress's native deletion APIs.

Use it from WP-CLI

• Run audits and guarded file actions from the command line.
• Produce table, CSV, JSON, or YAML output for review and automation.
• Add size, age, scope, ignore-pattern, and custom-table filters.
• Use summary and exit-code options in scheduled jobs or CI workflows.

Safety first

Media Audit reports candidates, not guarantees. Encoded data, custom storage, external services, dynamically constructed URLs, and hardcoded references may not be detectable. Review findings, keep reliable backups, and prefer quarantine before permanent deletion.

Download media-audit-1.0.0.zip below or browse the source for this release.