PHPackages                             thefrosty/wp-upgrade-task-runner - 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. thefrosty/wp-upgrade-task-runner

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

thefrosty/wp-upgrade-task-runner
================================

A WordPress plugin for developers to write custom migration tasks.

2.8.0(2y ago)418.0k1[3 issues](https://github.com/thefrosty/wp-upgrade-task-runner/issues)MITPHPPHP ^8.1CI passing

Since Mar 6Pushed 4mo ago1 watchersCompare

[ Source](https://github.com/thefrosty/wp-upgrade-task-runner)[ Packagist](https://packagist.org/packages/thefrosty/wp-upgrade-task-runner)[ RSS](/packages/thefrosty-wp-upgrade-task-runner/feed)WikiDiscussions develop Synced 1mo ago

READMEChangelog (10)Dependencies (13)Versions (26)Used By (0)

WordPress Upgrade Task Runner
=============================

[](#wordpress-upgrade-task-runner)

[![WP Upgrade Task Runner](.github/wp-upgrade-task-runner.jpg?raw=true "Upgrade Task Runner")](.github/wp-upgrade-task-runner.jpg?raw=true)

![PHP from Packagist](https://camo.githubusercontent.com/f312b8a646be76171b9ada7afa607f8e4bf65be04e4b6db687daf65f9496c5d2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f74686566726f7374792f77702d757067726164652d7461736b2d72756e6e65722e737667)[![Latest Stable Version](https://camo.githubusercontent.com/691e55b493d82d1b99a7ae18cfd488bca90911f98b06e7c302953e2280fac9e1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f74686566726f7374792f77702d757067726164652d7461736b2d72756e6e65722e737667)](https://packagist.org/packages/thefrosty/wp-upgrade-task-runner)[![Total Downloads](https://camo.githubusercontent.com/deb90ccdb9b55af5675a367daa79c677f4f9251044279fcffd3a37bdf489a5a7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f74686566726f7374792f77702d757067726164652d7461736b2d72756e6e65722e737667)](https://packagist.org/packages/thefrosty/wp-upgrade-task-runner)[![License](https://camo.githubusercontent.com/ab2761b900d1a3e3de9dae8787142c7de607eb0f8c89031e2aa698e34d310788/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f74686566726f7374792f77702d757067726164652d7461736b2d72756e6e65722e737667)](https://packagist.org/packages/thefrosty/wp-upgrade-task-runner)[![Build Status](https://github.com/thefrosty/wp-upgrade-task-runner/actions/workflows/main.yml/badge.svg)](https://github.com/thefrosty/wp-upgrade-task-runner/actions/workflows/main.yml/badge.svg)[![codecov](https://camo.githubusercontent.com/4b561064402342bb76d624c8f550ea70ed59b78ba4dd78e3e0014fa9e2759406/68747470733a2f2f636f6465636f762e696f2f67682f74686566726f7374792f77702d757067726164652d7461736b2d72756e6e65722f6272616e63682f646576656c6f702f67726170682f62616467652e737667)](https://codecov.io/gh/thefrosty/wp-upgrade-task-runner)

Register custom migration tasks that can be triggered from a dashboard in the admin and run via AJAX.

### Requirements

[](#requirements)

```
PHP >= 8.1
WordPress >= 6.2

```

The required WordPress version will always be the most recent point release of the previous major release branch.

For both PHP and WordPress requirements, although this library may work with a version below the required versions, they will not be supported and any compatibility is entirely coincidental.

### Installation

[](#installation)

To install this library, use Composer:

```
composer require thefrosty/wp-upgrade-task-runner:^2

```

Getting Started
---------------

[](#getting-started)

If a new task is needed, there are only two required steps that are needed.

1. A class needs to be created and this class needs to extend the `AbstractTaskRunner`class. See the `ExampleMigrationTask` example class.
2. Register the new task class via the `TaskLoader::REGISTER_TASKS_TAG` filter:

```
use TheFrosty\WpUpgradeTaskRunner\Tasks\TaskLoader;

\add_filter(TaskLoader::REGISTER_TASKS_TAG, static function(array $tasks): array {
    $tasks[] = new \Project\SomeCustomTask();
    return $tasks;
});
```

### The task class

[](#the-task-class)

When a class is added, it needs to have a few pre-defined class values. Both the DATE and TITLE constant are required to be unique. These are what registers a one off cron task when manually *running* the task from the admin page.

### The `TaskLoader`

[](#the-taskloader)

Add the new class as a property in the `TaskLoader` class and instantiate it in the `register_tasks` method (just like the `ExampleMigrationTask`).

### CLI

[](#cli)

Run all registered tasks (not already run) via wp-cli: `$ wp upgrade-task-runner`.

#### CLI OPTIONS

[](#cli-options)

```
 [--task=] : The fully qualified registered task to run.
 [--user=] : The user ID to associate with running said task(s).

```

###  Health Score

43

—

FairBetter than 90% of packages

Maintenance38

Infrequent updates — may be unmaintained

Popularity27

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity78

Established project with proven stability

 Bus Factor1

Top contributor holds 94.7% 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 ~80 days

Recently: every ~217 days

Total

24

Last Release

777d ago

Major Versions

1.3.0 → 2.0.02019-12-04

PHP version history (6 changes)1.1.0PHP >=7.1

2.0.0PHP >=7.3

2.5.0-RC1PHP ^7.4|^8.0

2.6.0PHP ^7.4 || ^8.0

2.7.0PHP ^8.0

2.8.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/9297f4f4d23d5528e50d33af9d3f79bcfe7900dfdda17993be767157098f58bb?d=identicon)[thefrosty](/maintainers/thefrosty)

---

Top Contributors

[![thefrosty](https://avatars.githubusercontent.com/u/367897?v=4)](https://github.com/thefrosty "thefrosty (177 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (9 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (1 commits)")

---

Tags

ajaxmigration-toolphpwordpresswordpress-plugin

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/thefrosty-wp-upgrade-task-runner/health.svg)

```
[![Health](https://phpackages.com/badges/thefrosty-wp-upgrade-task-runner/health.svg)](https://phpackages.com/packages/thefrosty-wp-upgrade-task-runner)
```

###  Alternatives

[leapt/core-bundle

Symfony LeaptCoreBundle

2529.1k4](/packages/leapt-core-bundle)[numero2/contao-storelocator

Contao Plugin for managing stores (or in common address data) and providing a frontend-search based on geo data

121.5k](/packages/numero2-contao-storelocator)

PHPackages © 2026

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