PHPackages                             lambry/batchpress - 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. [Utility & Helpers](/categories/utility)
4. /
5. lambry/batchpress

ActiveWordpress-plugin[Utility & Helpers](/categories/utility)

lambry/batchpress
=================

WordPress plugin to help process data in batches.

0.4.2(3y ago)58GPL-2.0-or-laterPHPPHP >=7.4

Since Feb 26Pushed 3y ago2 watchersCompare

[ Source](https://github.com/lambry/batchpress)[ Packagist](https://packagist.org/packages/lambry/batchpress)[ Docs](https://github.com/lambry/batchpress)[ RSS](/packages/lambry-batchpress/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (1)Versions (4)Used By (0)

BatchPress
==========

[](#batchpress)

BatchPress is a little plugin to help process data in batches, with BatchPress you can run, monitor and cancel batched jobs.

Install: `composer require lambry/batchpress`

[![screenshot](screenshot.png)](screenshot.png)

Usage
-----

[](#usage)

To use BatchPress create a new class per job and register those classes using the `batchpress/jobs` filter.

Job class outline:

- Required: `label` property to describe the job.
- Required: `process` method which is passed a single item for processing; any info/errors can be returned and will be displayed in the log.
- Optional|Required: `items` method is optional if the upload property is set to true, in this case it can be used to filter the uploaded content before staring the job. If upload if false or not defined the method is then required to return an array of items for processing.
- Optional: `upload` property to tell BatchPress if a CSV upload is required.
- Optional: `batch` property to set the number of items to process per batch.
- Optional: `description` property to provide extra details about the job.

Basic Example
-------------

[](#basic-example)

```
class Update {
  public $batch = 10;
  public $label = 'Update data';

  // Prepare an array of items for processing
  public function items() : array { }

  // Process each item and optionally return log info
  public function process($item) : mixed { }
}
```

Example with CSV upload
-----------------------

[](#example-with-csv-upload)

```
class Import {
  public $batch = 10;
  public $upload = true;
  public $label = 'Import data';

  // Optionally filter and format the uploaded content before processing
  public function items(array $data) : array { }

  // Process each item and optionally return log info
  public function process($item) : mixed { }
}
```

Registering jobs
----------------

[](#registering-jobs)

```
add_filter('batchpress/jobs', fn() => [Update::class, Import::class]);
```

Helpers
-------

[](#helpers)

BatchPress provides some helper methods as well, to use them just include the `Helpers` trait in your job class.

```
use Lambry\BatchPress\Helpers;

class Update {
  use Helpers;

  public function process($item) : mixed {
    // Adding an image to a post
    $id = this->uploadImage($item['url'], $item['id'], $item['title']);
    // Adding a file to a post
    $id = this->uploadFile($item['url'], $item['id'], $item['title']);
  }
}
```

###  Health Score

21

—

LowBetter than 18% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~206 days

Total

3

Last Release

1176d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/1dcafc214bf8026968a6d87387ede6dd60ce57cd8b344f4c276efed4b9eff076?d=identicon)[lambry](/maintainers/lambry)

---

Top Contributors

[![lambry](https://avatars.githubusercontent.com/u/287178?v=4)](https://github.com/lambry "lambry (16 commits)")

---

Tags

pluginwordpresspluginwordpress

### Embed Badge

![Health badge](/badges/lambry-batchpress/health.svg)

```
[![Health](https://phpackages.com/badges/lambry-batchpress/health.svg)](https://phpackages.com/packages/lambry-batchpress)
```

###  Alternatives

[helsingborg-stad/municipio

A bootstrap theme for creating municipality sites.

4028.5k10](/packages/helsingborg-stad-municipio)[iceicetimmy/acf-post-type-selector

Post type selector for Advanced Custom Fields.

559.0k](/packages/iceicetimmy-acf-post-type-selector)

PHPackages © 2026

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