Title: Media Reference Inspector
Author: rejoyan9009
Published: <strong>14 آگوست 2026</strong>
Last modified: 25 آگوست 2026

---

جستجوی افزونه‌ها

![](https://ps.w.org/media-reference-inspector/assets/banner-772x250.png?rev=3665058)

![](https://ps.w.org/media-reference-inspector/assets/icon.svg?rev=3647213)

# Media Reference Inspector

 توسط [rejoyan9009](https://profiles.wordpress.org/rejoyan9009/)

[دانلود](https://downloads.wordpress.org/plugin/media-reference-inspector.2.4.1.zip)

 * [جزئیات](https://fa.wordpress.org/plugins/media-reference-inspector/#description)
 * [نقد و بررسی‌ها](https://fa.wordpress.org/plugins/media-reference-inspector/#reviews)
 *  [نصب](https://fa.wordpress.org/plugins/media-reference-inspector/#installation)
 * [توسعه](https://fa.wordpress.org/plugins/media-reference-inspector/#developers)

 [پشتیبانی](https://wordpress.org/support/plugin/media-reference-inspector/)

## توضیحات

Media Reference Inspector is a read-only WordPress admin tool for checking where
Media Library items are referenced.

The plugin does not delete files, modify content, create database tables, track 
users, or send analytics. Scan results are advisory: “No supported references found”
does not prove that a file is unused.

#### Scanner

Inspect one media item at a time with a professional WordPress-native workflow. 
Supported checks include:

 * Post, page, custom post type, synced/reusable block, and other post content or
   excerpts containing the primary URL, generated image-size URLs, or the WordPress`
   wp-image-ID` class.
 * Core Image, Gallery, Cover, Media & Text, File, Audio, and Video blocks that 
   store attachment IDs.
 * Featured images stored in `_thumbnail_id` metadata.
 * Navigation menu custom URLs.
 * WordPress Site Icon and Site Logo.
 * Active theme Custom Logo, Header Image, and Background Image settings.
 * Core media widgets and block widgets.
 * WooCommerce product gallery and product-category thumbnail attachment IDs.
 * Elementor saved media-control references when the saved JSON confirms the attachment
   ID.
 * Advanced Custom Fields (ACF) Image, File, and Gallery fields when ACF confirms
   the field type and saved attachment ID.
 * Reference evidence details including confidence, source category, and context
   for supported results.

#### Bulk Scan

Bulk Scan processes media items one at a time through bounded AJAX requests. It 
supports media type, upload-age, search, maximum-item filters, selected attachment
IDs, live progress, potential-unused review filtering, reference evidence and file-
health filtering, result sorting, CSV export, and a printable HTML audit report.

#### Broken URLs

Run a bounded, read-only scan for local WordPress uploads URLs saved in post content
or excerpts where the corresponding local file no longer exists. The scanner checks
local uploads paths only and does not make external network requests.

#### Page & Post Audit

Audit a post or page to list supported media attachment IDs, flag broken attachment
IDs, and review local file health without modifying content.

#### Duplicate Finder

Run an on-demand, bounded exact-file hash scan of recent local Media Library files.
The tool reports exact matches only and never deletes files.

#### Integration Coverage

The admin interface reports supported coverage for WordPress Core, WooCommerce, 
Elementor, and ACF so administrators can see which integration-aware checks are 
active on the site.

#### Media Library Status

Reference checks store a short-lived local scan-status cache for inspected attachments.
Media Library workflows can show a recent reference count/status and offer an explicit
re-scan without running a heavy scan on every page load.

#### Media Impact Preview

Single-item scans summarize supported reference categories that could be affected
before a media item is replaced or removed. The preview is advisory and read-only.

#### Extended Metadata and Builder Coverage

2.4 adds bounded validation for media-like post meta, term meta, selected option
values, known SEO/social image metadata, and supported Bricks, Divi, and Beaver 
Builder saved data. Candidate values are validated before a reference is reported.

#### Site Audit Summary

Run an explicit bounded audit of up to 100 recent Media Library items to review 
referenced items, potential-unused review results, file-health issues, broken local
uploads URLs, and exact duplicate groups.

#### Support

The Help tab includes an explicit support form for bug reports, feature requests,
and questions. Nothing is sent until an administrator submits the form. The message
and reply email are sent through the site’s configured WordPress mail system to 
plugin support.

#### Privacy

Media Reference Inspector does not send media or site data to analytics or telemetry
services and stores no scan history. Short-lived scan-status cache data stays in
WordPress. The Help support form sends a message only after an administrator explicitly
submits it.

## عکس‌های صفحه

[⌊Scanner and integration coverage: inspect supported references across WordPress
Core, WooCommerce, Elementor, and ACF.⌉⌊Scanner and integration coverage: inspect
supported references across WordPress Core, WooCommerce, Elementor, and ACF.⌉[

Scanner and integration coverage: inspect supported references across WordPress 
Core, WooCommerce, Elementor, and ACF.

[⌊Bulk reference scan: filter media, run bounded read-only scans, and export audit
results.⌉⌊Bulk reference scan: filter media, run bounded read-only scans, and export
audit results.⌉[

Bulk reference scan: filter media, run bounded read-only scans, and export audit
results.

[⌊Page & post media audit: review supported media references and local file health
for posts and pages.⌉⌊Page & post media audit: review supported media references
and local file health for posts and pages.⌉[

Page & post media audit: review supported media references and local file health
for posts and pages.

[⌊Help & support: review scanner guidance and submit an explicit administrator support
request. The example email value is obscured for privacy.⌉⌊Help & support: review
scanner guidance and submit an explicit administrator support request. The example
email value is obscured for privacy.⌉[

Help & support: review scanner guidance and submit an explicit administrator support
request. The example email value is obscured for privacy.

[⌊Broken local media URLs: find supported content that references local uploads 
files that no longer exist.⌉⌊Broken local media URLs: find supported content that
references local uploads files that no longer exist.⌉[

Broken local media URLs: find supported content that references local uploads files
that no longer exist.

## نصب

 1. Install Media Reference Inspector from the WordPress Plugin Directory, or upload
    an approved test ZIP.
 2. Activate the plugin.
 3. Go to Media > Media References.
 4. Use Scanner for one media item, Bulk Scan for a batch audit, Broken URLs for missing
    local uploads files referenced in content, Page Audit for post/page media review,
    Duplicates for exact-file checks, or Help for documentation and support.

## سوالات متداول

### Does this plugin delete media files?

No. It is intentionally read-only for media and content.

### Does “No supported references found” mean the file is safe to delete?

No. Themes, builders, custom tables, external applications, caches, or custom code
may store references outside the supported checks.

### Which WordPress blocks are detected by attachment ID?

Image, Gallery, Cover, Media & Text, File, Audio, and Video blocks are detected 
when their saved attributes reference the selected attachment.

### Does the plugin detect resized image URLs?

Yes. It checks generated image-size URLs recorded in WordPress attachment metadata
as well as the primary attachment URL.

### Does Broken URLs check external websites?

No. It checks URLs under the site’s own WordPress uploads base URL and verifies 
the corresponding local uploads file path. It does not request remote URLs.

### How does the support form work?

An administrator can explicitly submit a bug report, feature request, or question
from the Help tab. The form sends only the entered reply email and message plus 
the plugin and WordPress version through the site’s configured WordPress mail system.

### Who can use the scanner?

The scanner and support form require the `manage_options` capability because scan
results may reveal references to non-public content.

## نقد و بررسی‌ها

نقد و بررسی‌ای برای این افزونه یافت نشد.

## توسعه دهندگان و همکاران

“Media Reference Inspector” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت
کرده‌اند.

مشارکت کنندگان

 *   [ rejoyan9009 ](https://profiles.wordpress.org/rejoyan9009/)

[ترجمه “Media Reference Inspector” به زبان شما.](https://translate.wordpress.org/projects/wp-plugins/media-reference-inspector)

### علاقه‌ مند به توسعه هستید؟

[کد را مرور کنید](https://plugins.trac.wordpress.org/browser/media-reference-inspector/)،
[مخزن SVN](https://plugins.svn.wordpress.org/media-reference-inspector/) را بررسی
کنید، یا از طریق [RSS](https://plugins.trac.wordpress.org/log/media-reference-inspector/?limit=100&mode=stop_on_copy&format=rss)
در [گزارش توسعه](https://plugins.trac.wordpress.org/log/media-reference-inspector/)
مشترک شوید.

## گزارش تغییرات

#### 2.4.1

 * Added five polished, privacy-safe WordPress.org screenshots using real plugin
   admin UI.
 * Added matching screenshot captions for Scanner, Bulk Scan, Page Audit, Help, 
   and Broken URLs.
 * Preserved all 2.4.0 scanner behavior; this is a directory presentation maintenance
   release.

#### 2.4.0

 * Added Media Impact Preview for already-computed single-scan results.
 * Added bounded generic media-like post meta, term meta, and selected option validation.
 * Added known Yoast SEO and Rank Math social-image metadata checks.
 * Added modular Bricks, Divi, and Beaver Builder saved-media checks with value 
   validation.
 * Improved Media Library cached reference counts and explicit re-scan wording.
 * Added a bounded manual Site Audit Summary for up to 100 recent media items.
 * Added JSON export alongside CSV and printable HTML reports.
 * Added 2.4 NEW badges and updated What’s New guidance.
 * Added a one-time WordPress admin What’s New notice for existing installs after
   updating to 2.4.0.
 * Updated compatibility metadata and validation for WordPress 7.1.
 * Removed corrupt legacy WordPress.org screenshot assets so broken screenshots 
   are no longer served.
 * Revalidated WordPress.org banner sources for stable asset re-sync.
 * Preserved read-only behavior and added stricter bounds to new metadata queries.

#### 2.3.0

 * Added reference confidence, source-category, and context metadata for supported
   scan results.
 * Added integration coverage status for WordPress Core, WooCommerce, Elementor,
   and ACF.
 * Added a bounded Broken URLs scanner for missing local uploads files referenced
   in post content or excerpts.
 * Added short-lived local scan-status caching for on-demand Media Library reference
   status.
 * Added selected attachment-ID support to Bulk Scan.
 * Added Bulk Scan evidence/source and file-health filtering.
 * Added a printable HTML audit report alongside the existing CSV export.
 * Preserved existing Scanner, Page Audit, Duplicate Finder, support form, responsive
   UI, and read-only safety behavior.

#### 2.2.0

 * Added per-user NEW badges and a What’s New card that disappear after the new 
   feature tabs are visited.
 * Added Page & Post Media Audit with supported media listing, broken attachment-
   ID review, and file-health status.
 * Added Media File Health to single-item scan results.
 * Added a bounded exact Duplicate Finder for recent readable local files.
 * Added confirmed ACF Image, File, and Gallery field reference detection when ACF
   is active.
 * Added Bulk Scan result sorting and clearer Potential unused review wording.
 * Removed the temporary Diagnostics tab now that normal WordPress.org updates ar
   verified.
 * Rebuilt Bulk Scan controls for responsive desktop, tablet, and mobile layouts,
   including desktop-sized mobile viewports.
 * Added an explicit Help-tab support email form for bug reports, feature requests,
   and general questions.
 * Added nonce, capability, sanitization, rate-limit, and mail-delivery feedback
   protections to the support form.
 * Preserved all 2.1.0 scanner, integration, CSV, and read-only behavior.

#### 2.1.0

 * Added Diagnostics with exact plugin-basename and WordPress core update-cache 
   visibility plus a nonce-protected update-status refresh action.
 * Added core media widget and block-widget reference detection.
 * Added WooCommerce product-category thumbnail detection.
 * Added a scanner coverage summary for core, widgets, WooCommerce, and Elementor
   checks.
 * Added bulk upload-age filtering and increased bounded bulk batches up to 250 
   items.
 * Expanded CSV exports with media URL, file size, and upload date.
 * Added keyboard focus and reduced-motion accessibility polish.

#### 2.0.0

 * Redesigned the admin experience with a professional WordPress-native header and
   Scanner, Bulk Scan, and Help navigation.
 * Added responsive media cards, grouped scan results, clearer status states, and
   follow-up Edit/View actions.
 * Added bounded AJAX bulk scanning, live progress, result filtering, and CSV export.
 * Added a Media Library “Check references” row action.
 * Added WooCommerce product gallery detection.
 * Added Elementor saved media-control detection with JSON validation.
 * Preserved all 1.1.0 reference checks and read-only behavior.

#### 1.1.0

 * Added generated image-size URL detection and core media-block attachment ID detection.
 * Extended menu, header, and background checks to generated URL variants.
 * Added post IDs in the content-reference labels.

#### 1.0.2

 * Improved prepared SQL analysis and validated read-only navigation inputs.

#### 1.0.1

 * Improved responsive media-list layout and mobile usability.

#### 1.0.0

 * Initial release with read-only reference checks for standard WordPress content
   and settings.

## اطلاعات

 *  نگارش **2.4.1**
 *  آخرین به‌روزرسانی **4 روز پیش**
 *  نصب‌های فعال **کمتر از 10**
 *  نگارش وردپرس ** 6.2 یا بالاتر **
 *  آزمایش‌شده تا **7.1**
 *  نگارش PHP ** 7.4 یا بالاتر **
 *  زبان
 * [English (US)](https://wordpress.org/plugins/media-reference-inspector/)
 * برچسب
 * [Admin Tools](https://fa.wordpress.org/plugins/tags/admin-tools/)[attachments](https://fa.wordpress.org/plugins/tags/attachments/)
   [media library](https://fa.wordpress.org/plugins/tags/media-library/)[media usage](https://fa.wordpress.org/plugins/tags/media-usage/)
   [references](https://fa.wordpress.org/plugins/tags/references/)
 *  [نمایش پیشرفته](https://fa.wordpress.org/plugins/media-reference-inspector/advanced/)

## امتیازها

هنوز هیچ نقدی ارسال نشده است.

[بررسی شما](https://wordpress.org/support/plugin/media-reference-inspector/reviews/#new-post)

[مشاهدهٔ همهٔ بررسی‌ها](https://wordpress.org/support/plugin/media-reference-inspector/reviews/)

## مشارکت کنندگان

 *   [ rejoyan9009 ](https://profiles.wordpress.org/rejoyan9009/)

## پشتیبانی

چیزی برای گفتن دارید؟ نیاز به کمک دارید؟

 [مشاهده انجمن پشتیبانی](https://wordpress.org/support/plugin/media-reference-inspector/)