Mediachecker

Seven-signal media reference detection

• Checks attachment parent relationships through post_parent.
• Finds featured images, WooCommerce galleries, ACF values, and other attachment IDs stored in post meta.
• Parses WordPress gallery shortcodes for referenced media IDs.
• Reads Gutenberg image, gallery, and related block JSON.
• Matches full URLs, filenames, and generated size variants in content, widgets, options, and files.
• Scans theme templates, template parts, included PHP files, and stylesheets.
• Inspects serialized sidebar-widget configurations.
• Protects recent uploads through a configurable safety window that defaults to 30 days.

Safe unused-media cleanup

• Filters, searches, and selects orphaned media for batch actions.
• Supports deletion or detachment without forcing a single cleanup strategy.
• Re-verifies references immediately before deleting anything.
• Includes dry-run mode so administrators can preview a cleanup.
• Requires explicit confirmation and an opt-in force flag to bypass recent-upload protection.
• Displays file size and image dimensions to support informed decisions.

Automatic backup and restoration

• Exports attachment ID, title, filename, URL, MIME type, parent, date, metadata, and backup timestamp to JSON.
• Can package the original media files with metadata in a ZIP archive.
• Protects backup storage with access-denial and directory-silencing files.
• Restores attachment records, reconnects files, and regenerates WordPress attachment metadata.

Duplicate discovery

• Finds filename collisions when the same filename has been uploaded more than once.
• Uses MD5 content hashing to identify byte-identical files under different names.
• Uses perceptual hashing to detect visually similar images entirely on the server.
• Caches duplicate results to avoid unnecessary repeated work.

Optional AI media tools

• Generates descriptive, accessibility-focused image alt text through an OpenAI-compatible vision API.
• Categorizes media as photos, screenshots, logos, illustrations, icons, documents, graphics, infographics, charts, textures, or other types.
• Produces cleanup confidence scores with plain-language reasoning.
• Works with OpenAI, OpenRouter, or a compatible local vision endpoint.
• Keeps visual duplicate detection available without any API key.

Reporting and continuous monitoring

• Exports scan results as CSV with attachment IDs, titles, paths, URLs, dates, sizes, and MIME types.
• Filters exports by used or unused status.
• Runs scheduled scans hourly, daily, or weekly through WP-Cron.
• Sends email notifications when orphan counts cross a configured threshold.
• Offers exclusions for MIME types and upload directories.

Security and accountability

• Requires WordPress nonces for every AJAX action.
• Restricts scanning and cleanup to users with administrator capabilities.
• Sanitizes IDs, text fields, booleans, API settings, and other inputs.
• Escapes rendered content throughout the administration interface.
• Records every deletion, detachment, and restoration with its timestamp, user, action, and details.
• Caps the activity log to prevent unbounded option growth.