PHPackages                             carloswph/wc-order-status - 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. carloswph/wc-order-status

ActiveLibrary[Utility & Helpers](/categories/utility)

carloswph/wc-order-status
=========================

WooCommerce comprehensive helper for custom order statuses.

v1.0.1(5y ago)313GPL-3.0-or-laterPHP

Since Feb 22Pushed 5y ago1 watchersCompare

[ Source](https://github.com/carloswph/wc-order-status)[ Packagist](https://packagist.org/packages/carloswph/wc-order-status)[ RSS](/packages/carloswph-wc-order-status/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)DependenciesVersions (3)Used By (0)

wc-order-status
===============

[](#wc-order-status)

Adding custom order statuses to the Woocommerce platform could be definitely easier - and I am not talking about installing yet another plugin for dealing with silly tasks. This helper aims to automate and incept some intelligence to the way developers and web designers add, manage, style and even link behaviours and reactions to the custom statuses created.

First and foremost, we established a class to make the painful routine of adding custom statuses a single line of code.

Installation
============

[](#installation)

No additional plugins, please. This library can be installed using Composer or, if you prefer, just download the main class `OrderStatus` and add to your project.

Usage
=====

[](#usage)

By definition, for adding a new status to WC orders we first need to register such status in Wordpress, and then include the newly added status to the pool where order statuses are saved within Woocommerce. So... why not doing that at once, instead of successive functions and hooks? So let's see how to simply add new statuses:

```
use WPH\WC\OrderStatus;
// Composer autoload
require __DIR__ . '/vendor/autoload.php';

/**
 * Follow the format:
 * new OrderStatus(*STATUS_NAME*, array(*BACKGROUND_COLOR*, *FONT_COLOR*));
 * And that's it.
 */
new OrderStatus('Custom Status', array('orange', '#ededed'));
```

**Obs:** any CSS predefined color name and HEX color will work, but also any other format accepted in CSS (rgb, rgba, hsl, hsla).

Todo
====

[](#todo)

We are planning some new features shortly. With new statuses, sometimes we face the need of trigger or hook functions or actions to them. So it makes sense to generate a controller class where you can encapsulate any kind of desired behavior. Also, we expect to add:

- An easy way of customizing table actions and icons for new statuses
- Autogenerated email templates for them
- Support for Woocommerce Subscriptions

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity54

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 ~1 days

Total

2

Last Release

1904d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/13c91dcf5209989038da335ba42538fa84670bf27400f220d182a76e0a720b74?d=identicon)[carloswph](/maintainers/carloswph)

---

Top Contributors

[![meuppt](https://avatars.githubusercontent.com/u/37983141?v=4)](https://github.com/meuppt "meuppt (8 commits)")

---

Tags

wordpressorderswoocommercewoocommerce-pluginwc

### Embed Badge

![Health badge](/badges/carloswph-wc-order-status/health.svg)

```
[![Health](https://phpackages.com/badges/carloswph-wc-order-status/health.svg)](https://phpackages.com/packages/carloswph-wc-order-status)
```

###  Alternatives

[php-stubs/woocommerce-stubs

WooCommerce function and class declaration stubs for static analysis.

942.9M66](/packages/php-stubs-woocommerce-stubs)[woocommerce/woocommerce-sniffs

WooCommerce sniffs

496.8M42](/packages/woocommerce-woocommerce-sniffs)

PHPackages © 2026

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