WooCommerce Order Status Manager

A production-ready WooCommerce plugin by rocketdeploy that gives store operators full control over custom and built-in order statuses - including ordering, visibility, localization, and styling.

---

Overview

WooCommerce Order Status Manager provides an admin-first workflow for managing order statuses in a structured and predictable way.

The plugin allows you to:

• Create and manage custom order statuses
• Control visibility in admin interfaces
• Assign badge colors
• Reorder both built-in and custom statuses via drag and drop
• Manage localized labels per WordPress admin user locale
• Import and export status configurations between environments

It is fully compatible with modern WooCommerce behavior, including HPOS (High-Performance Order Storage) order screens.

---

Key Features

• Create, update, and delete custom WooCommerce order statuses
• Drag-and-drop ordering for built-in and custom statuses (automatic persistence)
• Control visibility in:
  • Order edit dropdown
  • Bulk actions
• Customize status badge colors (color picker + HEX input)
• Multi-locale labels with locale-aware resolution and English fallback
• Import / Export configuration via normalized TXT + JSON format
• Built-in status metadata management (order and color control)

---

Screenshots

Status management interface	Drag & drop reordering

Multi-locale labels	Import preview workflow

---

Compatibility

• WordPress 6.0 - 6.8
• WooCommerce 7.0 - 10.2
• HPOS order screens

---

Security Model

Security is treated as a first-class concern:

• Capability checks (manage_woocommerce) for all state-changing actions
• Nonce validation for forms and AJAX requests
• Strict sanitization of input data
• Proper escaping for all admin output

---

Data Model

The plugin stores configuration in dedicated options:

• rd_wcosm_custom_statuses - custom status definitions
• rd_wcosm_builtin_statuses - metadata for built-in statuses

No core WooCommerce data is modified.

---

Import / Export

Use WooCommerce -> Order Statuses -> Import / Export to manage configuration files.

• Export generates a TXT file with embedded JSON markers
• Import supports the plugin's normalized export format
• The import wizard:
  • Provides a structured preview
  • Highlights conflicts
  • Requires explicit replacement selection before applying changes

This allows safe migration of status workflows between staging and production environments.

---

Localization

• English (EN) label is always required as a default
• Any installed WordPress locale can be added via modal selector
• Status labels resolve to the current user locale
• English is used as fallback when no localized label is available

---

Code Quality

This plugin follows WordPress Coding Standards (WPCS).

• PHPCS checks are enforced in CI
• Modern PHP structure with strict input/output handling
• Designed for maintainability and predictable behavior

---

Releases & Packaging

• Repository: https://github.com/rocketdeploy-dev/woocommerce-order-status-manager
• Versioning in this repository starts at 1.0.0.
• Releases are automated using release-please.
• Merging the Release PR creates:
  • Git tag
  • GitHub Release
• Installable ZIPs are built via the Package Plugin GitHub Actions workflow.
• Packaging can be triggered manually via the Run workflow button.

---

Why We Built This

We built this plugin to provide a structured and secure way to manage WooCommerce status workflows without introducing fragile overrides or inconsistent admin behavior.

---

License

GPL-2.0-or-later. See LICENSE.

---

Maintained by rocketdeploy

https://rocketdeploy.dev

---

Full Screenshot Gallery

1	2	3	4	5

6	7	8	9	10

---

Contributing & Security

• See CONTRIBUTING.md
• See SECURITY.md