WP Manifestindependent plugin directory
manifest / ecommerce / commerceflow

CommerceFlow for WooCommerce

WooCommerce operations and automation platform — analytics dashboard, automation rules engine, order workflow, and shipping rules.

by Anisur Rahman · github.com/anisur2805/commerceflow · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/anisur2805/commerceflow/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/anisur2805/commerceflow ↗

A WooCommerce operations & automation platform: a single modern React admin dashboard to observe your store and automate the order lifecycle — analytics, event-driven rules, custom fulfillment workflows, and rule-based shipping — without writing code.

Status: v0.4 released — Shipping rules engine. See ROADMAP.md for what's planned.

A dashboard screenshot will be added to .github/screenshot-dashboard.png once a test store is available.

Requirements

  • PHP 8.1+
  • WordPress (latest stable)
  • WooCommerce (latest stable) with HPOS (High-Performance Order Storage) enabled

Features (shipped)

v0.1 — Walking skeleton + Dashboard

  • Plugin foundation: PSR-4 autoloading, DI container, module loader, logger, HPOS compatibility declaration.
  • REST API: GET /commerceflow/v1/dashboard (cached analytics), GET|PUT /commerceflow/v1/settings (persisted config).
  • Dashboard: Orders today, revenue today, pending orders, failed payments, 30-day revenue chart, top products — all read via WooCommerce CRUD layer only.
  • Settings page: Cache toggle and cache TTL control with toast notifications on save.
  • CI gate: PHPCS, PHPStan, ESLint, PHPUnit — all pass on main via GitHub Actions.

v0.2 — Automation Rules Engine

  • Rules engine: trigger → condition(s) → action(s) stored in dedicated tables, evaluated asynchronously via Action Scheduler.
  • Hard guarantees: loop prevention, idempotency under retry, partial-failure policy, and dry-run (no side effects).
  • REST API: /commerceflow/v1/automation CRUD, /automation/{id}/dry-run, /automation/logs.
  • React rule builder and a dashboard Automation Queue card.

v0.3 — Order Workflow & Timeline

  • Custom fulfillment statuses (Packing, Ready to Ship, Shipped) stored HPOS-compatibly, with guarded transitions — invalid moves are rejected, never persisted.
  • Per-order timeline: every status change and automation action, with actor and timestamp.
  • REST API: /commerceflow/v1/orders (list, guarded transition, timeline) and /logs (merged activity feed).
  • React Orders page with one-click transitions and a timeline modal, plus a dashboard Fulfillment card.

v0.4 — Shipping Rules Engine

  • Rule-based shipping: conditions on country, state, postcode, weight, subtotal, category, shipping class, and coupon — priority-ordered, first match wins.
  • Live injection: the winning rule's rate is added to the cart via woocommerce_package_rates; the same pure resolver powers the preview tool, so both agree.
  • REST API: /commerceflow/v1/shipping CRUD and /shipping/preview (no side effects).
  • React Shipping page with a rule builder and preview tool, plus a dashboard Shipping card.

Development

composer install       # PHP deps + dev tooling (PHPCS, PHPStan, PHPUnit)
npm install            # front-end deps
npm run build          # build the React admin (@wordpress/scripts)

Quality gate (must pass before a slice ships):

composer phpcs         # WordPress coding standards
composer phpstan       # static analysis
npm run lint           # ESLint
composer test          # PHPUnit

License

GPL v2 or later.