MediaFlock scans your WordPress posts for externally hosted media files and imports them directly into your WordPress media library. After import, it automatically replaces the old external URLs in your post content with the new local URLs, ensuring all your media is served from your own site.
How It Works
The plugin uses five complementary URL extraction strategies to find external files in your content:
- Regex pattern matching — Scans raw post content for URLs matching configured file extensions.
- HTML anchor tag parsing — Extracts URLs from
<a href>links pointing to external files. - Media tag parsing — Finds external sources in
<img>,<video>,<audio>, and<source>elements. - Srcset attribute parsing — Detects external images referenced in responsive
srcsetattributes on<img>and<source>tags. - CSS background-image parsing — Extracts URLs from
background-image: url(...)declarations in inline styles and<style>blocks.
Key Features
- Batch scanning — Processes posts in configurable batches (10-200 per request) to handle sites of any size.
- Dry run mode — Check file sizes via HEAD requests before committing to an import.
- Duplicate prevention — Already-imported files are detected and skipped automatically.
- Dead link detection — URLs that returned errors on previous attempts are tracked and auto-skipped.
- Resume interrupted scans — If a scan is interrupted (browser closed, timeout), resume exactly where you left off.
- Progress tracking — Real-time progress bars for scanning, importing, and dry runs.
- Import logs — Every import attempt is logged with status (success, error, skipped), timestamps, and details.
- CSV export — Download filtered logs as CSV for offline analysis or reporting.
- Retry failed imports — One-click retry of all previously failed imports.
- Dashboard statistics — Overview of total imports, success/error/skipped counts, disk space used, and top errors.
- Configurable file types — Choose which file extensions to scan for using a Select2 tagging interface.
- Multiple URL filters — Restrict scanning to specific external servers by adding one or more base URLs.
- Post type and status filters — Target specific post types and statuses (publish, draft, pending, private, future).
- Quick Scan — Spot-check a single post by entering its ID or URL.
- Permission levels — Restrict plugin access to administrators only or open it to editors and above.
- Internationalization — Fully translatable with English and Georgian (ka_GE) translations included.
- Clean uninstall — Removes all database tables and options when deleted.
URL Replacement
After importing a file, the plugin replaces the external URL in your post content. It handles multiple URL encoding variants to ensure no references are missed:
- Standard URLs
- HTML entity-encoded URLs (
&instead of&) - URL-encoded paths (
%20for spaces) - Fully encoded path segments
- Protocol-relative URLs (
//example.com/...)
