Title: Media Ranger
Author: Luis Ruiz
Published: <strong>16 Agosto, 2026</strong>
Last modified: 16 Agosto, 2026

---

Procurar plugins

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

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

# Media Ranger

 Por [Luis Ruiz](https://profiles.wordpress.org/lruizcode/)

[Descarregar](https://downloads.wordpress.org/plugin/media-ranger.1.0.2.zip)

 * [Detalhes](https://pt.wordpress.org/plugins/media-ranger/#description)
 * [Avaliações](https://pt.wordpress.org/plugins/media-ranger/#reviews)
 *  [Instalação](https://pt.wordpress.org/plugins/media-ranger/#installation)
 * [Desenvolvimento](https://pt.wordpress.org/plugins/media-ranger/#developers)

 [Suporte](https://wordpress.org/support/plugin/media-ranger/)

## Descrição

**Media Ranger** scans your posts, pages, and custom post types for images hosted
on external domains. It then downloads those images to your WordPress Media Library
and automatically replaces the external URLs with local ones.

This is especially useful when:

 * Migrating content from another platform (Webflow, Squarespace, etc.)
 * Consolidating images from multiple CDNs
 * Ensuring all your media is hosted locally for better control
 * Improving site performance by serving images from your own server or CDN

**Features:**

 * Scan posts, pages, and any custom post type
 * Filter by post status (published, draft, any)
 * Process in batches to avoid timeouts
 * Include/exclude specific external hosts
 * Detect images in `src`, `data-src`, `srcset`, and `<source>` elements
 * Automatic deduplication (won’t re-import already imported images)
 * Optional: prefer original image size over thumbnails
 * Dry run mode to preview changes without modifying anything
 * REST API endpoint for programmatic access
 * Full WPML and Polylang compatibility
 * Support for modern image formats (WebP, AVIF)

### SUPPORT

**Need help or have a suggestion?**
 Please use the [official WordPress.org Support Forum](https://wordpress.org/support/plugin/media-ranger/)
for any issues related to the plugin.

**Official Website**
 For additional information or to get in touch with the development
team, please visit our [official website](https://www.bubuku.com/).

**Like the plugin?**
 Please [leave a 5-star review](https://wordpress.org/support/plugin/media-ranger/reviews/?filter=5)
and help others discover Media Ranger.

### ABOUT BUBUKU_CODE

We develop custom solutions for WordPress focused on performance, accessibility,
and maintainable code. Our work includes plugins, themes, and integrations designed
to improve the daily workflow of marketing and content teams.

## Ecrãs

[⌊Admin interface showing scan options⌉⌊Admin interface showing scan options⌉[

Admin interface showing scan options

[⌊Results after processing posts⌉⌊Results after processing posts⌉[

Results after processing posts

## Instalação

 1. Upload the `media-ranger` folder to `/wp-content/plugins/`
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. Go to Tools  Media Ranger

## Perguntas frequentes

### 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`).

## Avaliações

Este plugin não tem avaliações.

## Contribuidores e programadores

“Media Ranger” é software de código aberto. As seguintes pessoas contribuíram para
este plugin:

Contribuidores

 *   [ Luis Ruiz ](https://profiles.wordpress.org/lruizcode/)
 *   [ Bubuku I Code ](https://profiles.wordpress.org/bubuku/)

[Traduza o “Media Ranger” para o seu idioma.](https://translate.wordpress.org/projects/wp-plugins/media-ranger)

### Interessado no desenvolvimento?

[Consulte o código](https://plugins.trac.wordpress.org/browser/media-ranger/), consulte
o [repositório SVN](https://plugins.svn.wordpress.org/media-ranger/), ou subscreva
o [registo de alterações](https://plugins.trac.wordpress.org/log/media-ranger/) 
por [RSS](https://plugins.trac.wordpress.org/log/media-ranger/?limit=100&mode=stop_on_copy&format=rss).

## Registo de alterações

#### 1.0.2

 * Added plugin icons, banners, and screenshots for the WordPress.org assets directory

#### 1.0.1

 * Security: reject non-http(s) URLs before making any request
 * Security: use wp_safe_remote_head() to prevent requests to internal/private network
   addresses
 * Security: validate Content-Type and enforce a maximum download size (20 MB default,
   filterable) before downloading
 * Security: configurable HTTP timeout via MR_HTTP_TIMEOUT constant

#### 1.0.0

 * Complete rewrite following WordPress Coding Standards
 * Added namespace support and modular architecture
 * Improved WPML/Polylang compatibility
 * Added scan-only endpoint
 * Enhanced error handling and reporting
 * Added verbose mode for debugging
 * Better deduplication using attachment metadata
 * Initial release

## Metadados

 *  Versão **1.0.2**
 *  Última actualização **Há 6 dias**
 *  Instalações activas **Menos de 10**
 *  Versão do WordPress ** 6.0 ou superior **
 *  Testado até **7.0.4**
 *  Versão do PHP ** 7.4 ou superior **
 *  Idioma
 * [English (US)](https://wordpress.org/plugins/media-ranger/)
 * Etiquetas
 * [external](https://pt.wordpress.org/plugins/tags/external/)[images](https://pt.wordpress.org/plugins/tags/images/)
   [import](https://pt.wordpress.org/plugins/tags/import/)[media library](https://pt.wordpress.org/plugins/tags/media-library/)
   [migration](https://pt.wordpress.org/plugins/tags/migration/)
 *  [Visualização avançada](https://pt.wordpress.org/plugins/media-ranger/advanced/)

## Classificações

Ainda não foram submetidas avaliações.

[Your review](https://wordpress.org/support/plugin/media-ranger/reviews/#new-post)

[Ver todas as revisões](https://wordpress.org/support/plugin/media-ranger/reviews/)

## Contribuidores

 *   [ Luis Ruiz ](https://profiles.wordpress.org/lruizcode/)
 *   [ Bubuku I Code ](https://profiles.wordpress.org/bubuku/)

## Suporte

Tem algo a dizer? Precisa de ajuda?

 [Ver fórum de suporte](https://wordpress.org/support/plugin/media-ranger/)

## Doar

Gostaria de apoiar o desenvolvimento deste plugin?

 [ Fazer donativo para o plugin ](https://www.bubuku.com/)