Media Ranger

FAQ

Does this modify my original posts?

Yes, when not in dry-run mode, the plugin updates your post content to replace external image URLs with local ones. The original external images remain untouched on their servers.

What happens if an image fails to download?

The plugin logs the error and continues processing other images. Failed downloads are reported in the results.

Can I use this with WooCommerce products?

Yes! Simply include “product” in the Post Types field to scan WooCommerce products.

Does it work with WPML or Polylang?

Yes, the plugin is fully compatible with both WPML and Polylang. You can process all languages at once or select a specific language.

How do I avoid re-importing the same image?

The plugin stores the original source URL as attachment metadata. When scanning, it checks if an image was already imported and reuses the existing attachment.

Can I run this via WP-CLI or programmatically?

Yes, you can use the REST API endpoint. See the documentation for details on how to call /wp-json/media-ranger/v1/run.

How does the plugin protect against unsafe downloads?

Before downloading any remote image, the plugin rejects URLs that don’t use the http or https scheme, and performs a HEAD request that blocks requests to private/internal network addresses (via wp_safe_remote_head()). It also checks the Content-Type (must be an image) and the Content-Length (default max 20 MB) before downloading. These can be adjusted with the mran_allowed_mime_prefixes and mran_max_download_size filters, and the MRAN_HTTP_TIMEOUT constant (default 10 seconds, define it in wp-config.php).