Broken Media Checker for WordPress

Broken Media Checker for WordPress is a lightweight admin tool for finding missing WordPress media files and broken image references safely.

It is designed for WordPress site owners, developers, maintenance teams, and support teams who need a simple way to identify missing media files, broken image references, and missing attachment files from inside the WordPress admin area.

This plugin focuses only on WordPress media. It is not a general broken link checker, and it does not crawl the full frontend of your website. It checks post image references, WordPress attachments, and media-library files in a controlled admin-only workflow.

Key Features

- Scan post and page content for broken image references
- Detect missing WordPress attachment files
- Check media-library files against the local uploads directory
- Detect missing image files referenced in post content
- Parse image URLs from img src and srcset attributes
- Optional warning scan for missing generated image sizes
- Clear issue list with issue type, source, media URL, file path, status, and note
- Quick Edit Post and Edit Media links
- Manual status options: open, fixed, ignored
- Repair notes for each detected issue
- CSV export for reports and team workflows
- Batch scanning with progress display
- Admin-only screen under Media > Broken Media
- No frontend scripts or styles
- No external API dependency
- No automatic replacement, deletion, or image regeneration

What It Checks

- Image URLs inside post and page content
- Image URLs found in src and srcset attributes
- WordPress attachment records with missing original files
- Media-library files mapped to the local WordPress uploads directory
- Optional generated image sizes as warning-level issues
- Internal media URLs that can be safely mapped to local files

What It Does Not Do

- It does not crawl the full frontend of your website
- It does not scan all external links
- It does not work as a general SEO audit tool
- It does not automatically replace URLs
- It does not automatically delete files
- It does not regenerate thumbnails
- It does not connect to a CDN, S3, or external cloud storage
- It does not require WooCommerce
- It does not add frontend widgets, shortcodes, or public-facing features

Why Media-Only?

Many broken link tools scan every link on a website. That can be useful, but it can also be heavy, noisy, and risky on production sites.

Broken Media Checker for WordPress intentionally focuses only on WordPress media references. This keeps the workflow simpler, safer, and easier to understand.

The goal is not to automatically modify your website. The goal is to give you a reliable list of media issues so you can review and fix them manually.

Typical Use Cases

- Check whether old image URLs in posts still point to existing files
- Find attachment records where the original uploaded file is missing
- Review missing media after a migration
- Prepare a media QA report for a client
- Track manual repair work with notes and status labels
- Export broken media results to CSV for backup or team review

CSV Export

The plugin includes a CSV export feature for the current issue list.

The exported CSV includes fields such as issue type, source title, edit URL, media URL, attachment ID, file path, status, note, and detection time.

This is useful for client reports, internal QA workflows, migration checks, and manual repair tracking.

Installation

1. Download the main package from Codester.
2. Unzip the downloaded package on your computer.
3. Inside the package, locate the installable WordPress plugin ZIP:
   sg-broken-media-checker.zip
4. In WordPress, go to Plugins > Add New > Upload Plugin.
5. Upload sg-broken-media-checker.zip.
6. Click Install Now.
7. Click Activate.
8. Go to Media > Broken Media.

Important:
Do not upload codester-main.zip directly to WordPress.
codester-main.zip is the full Codester package. The installable WordPress plugin ZIP inside it is sg-broken-media-checker.zip.

Usage

1. Open Media > Broken Media in the WordPress admin area.
2. Select the scan options you want to run.
3. Click Run Scan.
4. Wait for the batch scan to complete.
5. Review the detected media issues.
6. Use Edit Post or Edit Media to manually fix the related content or attachment.
7. Add repair notes if needed.
8. Mark issues as fixed or ignored manually.
9. Export the results to CSV when you need a report.

Requirements

- WordPress 6.5 or higher
- Tested on WordPress 7.0
- PHP 8.0 or higher
- MySQL or MariaDB supported by your WordPress installation
- WordPress administrator access
- JavaScript enabled in the browser for the admin scan progress UI
- No external API required
- WooCommerce is not required

Security and Stability Notes

- Admin-only interface
- No frontend scripts or styles are loaded
- No automatic content replacement
- No automatic file deletion
- No automatic image regeneration
- No external API calls
- No cloud scanning
- WordPress nonce and capability checks are used for admin actions
- Local file checks are limited to safely mapped media paths
- The plugin is designed to help you review and fix issues manually

Files Included

- sg-broken-media-checker.zip - installable WordPress plugin ZIP
- Documentation/documentation.html - main user documentation
- Documentation/documentation.md - Markdown documentation
- Documentation/changelog.md - changelog
- Documentation/qa-checklist.md - QA checklist
- Documentation/test-report.md - test report
- Documentation/quality-gates.md - PHPCS/WPCS and Plugin Check summary
- License/LICENSE.txt - license file
- License/license-source.md - license source note
- Product/codester-description.html - product description source
- Product/codester-short-description.txt - short description source
- Product/codester-tags.txt - tag list
- Product/pricing-note.md - pricing note

Support

Support covers installation issues, reproducible plugin bugs, and documented features.

Support does not include custom development, server migration, recovering deleted files, creating replacement images, fixing unrelated third-party plugin conflicts, or adding new scan types.

Author:
SG Group

Support Contact:
https://sggroup.jp/contact/

Codester Profile:
https://www.codester.com/SGGro...

Changelog

Version 1.0.0

Initial release.

- Media-only broken reference checker for WordPress
- Post and page image reference scan
- Media-library file existence check
- Missing attachment file detection
- Optional generated image size warnings
- Issue list with manual status and repair notes
- CSV export
- Admin-only interface under Media > Broken Media
- No crawling, no automatic replacement, no file deletion

- Scan post and page content for broken image references
- Detect missing WordPress attachment files
- Check media-library files against local uploads storage
- Optional warning scan for missing generated image sizes
- Media-only checker: no full-site crawling
- No automatic replacement, deletion, or thumbnail regeneration
- Issue list with type, source, media URL, file path, status, and note
- Edit Post and Edit Media action links
- Manual status options: open, fixed, ignored
- Repair notes for each issue
- CSV export for reports and team workflows
- Batch scanning with progress display
- Admin-only screen under Media > Broken Media

- WordPress 6.5 or higher
- Tested on WordPress 7.0
- PHP 8.0 or higher
- MySQL or MariaDB supported by your WordPress installation
- WordPress administrator access
- JavaScript enabled in the browser for the admin scan progress UI
- No external API required
- WooCommerce is not required

1. Download the main package from Codester.
2. Unzip the main package on your computer.
3. Inside the package, locate the installable WordPress plugin ZIP:
   sg-broken-media-checker.zip
4. In WordPress, go to Plugins > Add New > Upload Plugin.
5. Upload sg-broken-media-checker.zip.
6. Click Install Now, then Activate.
7. Open Media > Broken Media.
8. Select the scan options you want to run.
9. Click Run Scan.
10. Review the detected media issues.
11. Use Edit Post or Edit Media to manually fix the source.
12. Add repair notes if needed.
13. Export the results to CSV when you need a report.

Important:
Do not upload codester-main.zip directly to WordPress.
codester-main.zip is the full Codester package. The installable plugin ZIP inside it is sg-broken-media-checker.zip.