This plugin is a content migration service tool. It imports externally hosted images found in your Post contents.
A typical use case for downloading and importing external images, is to aid importing of all the contents after the site's migration from one host to another.
The plugin can first attempt to import the images from local files, if you have them available as local files, or if not, it will download and import them from the source URL.
The plugin features CLI commands with parameters which offer a flexible set of basic features.
If you have images available in your local files, and you use the --folder-local-images parameter, the plugin will first attempt to import these directly, without downloading them.
The plugin downloads all the externally hosted images by default. Optionally, we can set to download just from specific hosts.
There is a helper command called scan-existing-images-hostnames which lists all the host names used in images. After listing all existing hosts, we can chose to download just from specific ones (via the --only-download-from-hosts command parameter).
Also optional. Alternatively, you can specify hosts not to download images from, and the plugin will download images from all the hosts except these, e.g. *.google.* (the --exclude-hosts parameter). Wildcards are also supported to use all domain extensions and/or subdomains.
To speed up downloading, you could run several commands in parallel. This is done by grouping your existing Post IDs into several batches, and then running the command with different --post-id-from and --post-id-to ID ranges.
Except from downloading images with the standard https://... src prefix, by providing the --default-image-host-and-schema=https://example-origin.com, these URI types get downloaded too:
- absolute referenced sources, e.g.
/path/image.jpg, - the Plugin also attempts to download relative referenced sources, e.g.
path/image.jpg, by treating them as absolute ones (which makes sense if the page where the images were located at is located at the root path, e.g.https://host.com/my_post_with_images)
By default, the Plugin downloads or imports external images from all the public Posts and Pages, and this can be customized with --post-types and --post-statuses.
Creates detailed custom error logs for review afterwards.
You may simulate and run the command without actual downloads or changes to your content by using the --dry-run flag.
Run composer install.
Can be found here.
A fresh WordPress site supports importing a number of image formats. In case of different formats, you may find this error in your logs:
Sorry, this file type is not permitted for security reasons.
In this case, you can additionally use the upload_mimes WP hook to temporarily or permanently permit additional formats.
Or even (temporarily) set the following constant in your wp-config.php
define( 'ALLOW_UNFILTERED_UPLOADS', true );