PHPackages                             deliciousbrains/wp-image-processing-queue - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Queues &amp; Workers](/categories/queues)
4. /
5. deliciousbrains/wp-image-processing-queue

ActiveLibrary[Queues &amp; Workers](/categories/queues)

deliciousbrains/wp-image-processing-queue
=========================================

Resize WordPress images in the background

1.0.0(8y ago)2061.4k18[6 issues](https://github.com/deliciousbrains/wp-image-processing-queue/issues)GPLv2PHPPHP &gt;=5.3.0

Since Mar 7Pushed 7y ago18 watchersCompare

[ Source](https://github.com/deliciousbrains/wp-image-processing-queue)[ Packagist](https://packagist.org/packages/deliciousbrains/wp-image-processing-queue)[ RSS](/packages/deliciousbrains-wp-image-processing-queue/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (2)Dependencies (1)Versions (3)Used By (0)

Image Processing Queue
======================

[](#image-processing-queue)

Image Processing Queue is an alternative to on-the-fly (OTF) image processing (e.g. [Aqua Resizer](https://github.com/syamilmj/Aqua-Resizer)) for WordPress themes.

Like OTF image processing, it allows theme developers to define image sizes for specific theme contexts rather than defining a size for all uploaded images. This greatly reduces the number of resized images and hence reduces disk space usage and the wait time when uploading an image.

Image Processing Queue differs from OTF image processing in how it behaves when an image doesn't exist yet. OTF generates the image right away and the end-user has to wait for the image to be generated. With Image Processing Queue there's no waiting. It immediately returns an image that already exists (that is the closest fit to the image size requested) and adds the image size to a queue. Image sizes are quietly generated in the background using [WP Queue](https://github.com/A5hleyRich/wp-queue).

Image Processing Queue also accommodates responsive themes much better than OTF. It allows theme developers to define a list of image sizes that will work best for their theme's responsive breakpoints. Images generated by Image Processing Queue are added to the post meta so that WordPress core's responsive functions will automatically add them to the `srcset` and delete them from the filesystem when the image is deleted from the Media Library.

Installation
------------

[](#installation)

### Install as a Plugin

[](#install-as-a-plugin)

To install Image Processing Queue as a plugin search for "[Image Processing Queue](https://wordpress.org/plugins/image-processing-queue/)" in your WordPress dashboard and install it from there.

### Install as a Library

[](#install-as-a-library)

If you're a plugin or theme developer you will need to require Image Processing Queue using Composer:

```
$ composer require deliciousbrains/wp-image-processing-queue

```

The following boilerplate will need adding to your project, which will load the required files and ensure WP cron processes the images in the background:

```
require_once '/vendor/autoload.php';

Image_Processing_Queue\Queue::instance();

wp_queue()->cron();
```

The following database tables will also need creating:

```
CREATE TABLE {$wpdb->prefix}queue_jobs (
id bigint(20) NOT NULL AUTO_INCREMENT,
job longtext NOT NULL,
attempts tinyint(3) NOT NULL DEFAULT 0,
reserved_at datetime DEFAULT NULL,
available_at datetime NOT NULL,
created_at datetime NOT NULL,
PRIMARY KEY  (id)

CREATE TABLE {$wpdb->prefix}queue_failures (
id bigint(20) NOT NULL AUTO_INCREMENT,
job longtext NOT NULL,
error text DEFAULT NULL,
failed_at datetime NOT NULL,
PRIMARY KEY  (id)
```

You can use the `wp_queue_install_tables()` helper function to create the required database tables. This should be called from within an [activation hook](https://developer.wordpress.org/reference/functions/register_activation_hook/) or custom upgrade routine.

Usage
-----

[](#usage)

When you want to output an image in your theme, simply call the `ipq_get_theme_image()` function passing in the ID of the image post, an array of sizes you've decided on for the image in this particular context, and an array of additional HTML attributes for the `` tag:

```
echo ipq_get_theme_image( $post_id, array(
        array( 600, 400, false ),
        array( 1280, 720, false ),
        array( 1600, 1067, false ),
    ),
    array(
        'class' => 'header-banner'
    )
);
```

You can return an image URL directly using the `ipq_get_theme_image_url()` function by passing in the image ID and required size. If the image size doesn't exist it will be pushed to the queue and the closest matching image URL will be returned.

```
echo ipq_get_theme_image_url( $post_id, array( 600, 400, false ) );
```

License
-------

[](#license)

[GPLv2+](http://www.gnu.org/licenses/gpl-2.0.html)

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity33

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 72.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~251 days

Total

2

Last Release

3196d ago

Major Versions

0.1 → 1.0.02017-11-13

### Community

Maintainers

![](https://www.gravatar.com/avatar/c404609458a1a91e293ba27bf9909ed84785fe13a30f8e731e24d851fbdbe4f2?d=identicon)[deliciousbrains](/maintainers/deliciousbrains)

---

Top Contributors

[![A5hleyRich](https://avatars.githubusercontent.com/u/1422996?v=4)](https://github.com/A5hleyRich "A5hleyRich (21 commits)")[![bradt](https://avatars.githubusercontent.com/u/190095?v=4)](https://github.com/bradt "bradt (6 commits)")[![grappler](https://avatars.githubusercontent.com/u/1785641?v=4)](https://github.com/grappler "grappler (1 commits)")[![rorymcdaniel](https://avatars.githubusercontent.com/u/331850?v=4)](https://github.com/rorymcdaniel "rorymcdaniel (1 commits)")

---

Tags

wordpressresizequeueimagescrop

### Embed Badge

![Health badge](/badges/deliciousbrains-wp-image-processing-queue/health.svg)

```
[![Health](https://phpackages.com/badges/deliciousbrains-wp-image-processing-queue/health.svg)](https://phpackages.com/packages/deliciousbrains-wp-image-processing-queue)
```

###  Alternatives

[a5hleyrich/wp-queue

WordPress job queues

18321.9k1](/packages/a5hleyrich-wp-queue)[jbzoo/image

A PHP class that simplifies working with images

171130.3k3](/packages/jbzoo-image)[deliciousbrains/wp-queue

WordPress job queues

1828.4k1](/packages/deliciousbrains-wp-queue)[renoki-co/horizon-exporter

Export Laravel Horizon metrics using this Prometheus exporter.

24152.9k](/packages/renoki-co-horizon-exporter)[ayvazyan10/nova-imagic

Imagic is a Laravel Nova field package that allows for image manipulation capabilities, such as cropping, resizing, quality adjustment, and WebP conversion. It utilizes the powerful Intervention Image class for image manipulation.

144.5k1](/packages/ayvazyan10-nova-imagic)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
