Extended
Implementation and developer documentation for the Extended add-on.
The Extended add-on provides a suite of premium features and functionality to enhance the core Instant Images plugin.
In this section:
Search History & Suggestions
The history and suggestions feature of the Extended add-on provides an interface for displaying your most recent searches and autocomplete suggestions for predicting your intended search query. Both of these features can save valuable time when searching for the perfect image and switching between providers.
The predictive search and recent search UI is displayed automatically when interacting with the Instant Images search component.
Batch Image Imports
Run batch imports from your favorite image providers from right inside your WordPress admin with the Extended add-on.
How to Run a Batch Import
- Open the Instant Images Settings screen and scroll to the Import Images section.
Settings → Instant Images → Import Images
- Select from the various query parameters and click the Import Images button.
- Track the progress of the import using the feedback display and tools.
During the import process, direct links to each upload will be displayed beneath the Import Images controls.
CLI Imports
The Extended add-on provides WordPress CLI commands to batch import up to 100 images directly to the media library from your terminal.
wp instant-images import
BashParameters
The following parameters are available to modify the CLI image query.
Parameter | Description | Default |
---|---|---|
provider | The image provider. unsplash|pexels|pixabay | unsplash |
number | The number of images to import. | 10 |
search | Optional search term. | null |
attribution | Automatically add image attributions. | false |
wp instant-images import --provider=pexels --search="Coffee Shop" --attribution=true
BashImage Filters
The Image Filters feature of the Extended add-on is a block filter that extends the WordPress core image
block and provides a curated set of 34 Instagram-inspired filters that can be applied to existing media library items.
How to Use Image Filters
- Add
image
block to the block editor. - Click the Instant Images icon in the
image
block toolbar. - Select an image filter from the curated list.
- The existing image will be replaced with the newly filtered image.
Applying an image filter will create a new image in the media library.
Gutenberg Block
The custom Instant Images block for the WordPress Block Editor editor allows you to search, find and insert images into posts and pages within a matter of seconds.
How to Use the Gutenberg Block
- Insert the
Instant Images
block from the WordPress block inserter. - Browse images from Unsplash, Openverse, Pixabay, and Pexels from right inside the Instant Images block.
- Click an image to upload and insert the image immediately into the block editor.
After image selection, the Instant Images
block is immediately replaced with a core image
block with the selected image attached.