Marketplace Suite for WooCommerce
Open-source modular multi-vendor marketplace framework for WooCommerce with vendor lifecycle management, product ownership, commission primitives, double-entry ledger foundations, REST APIs, idempotent financial operations, and HPOS/Cart & Checkout Blocks compatibility for secure WordPress marketplace development.
by Shahin Ilderemi · github.com/ildrm/woocommerce-marketplace-suite · website
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/ildrm/woocommerce-marketplace-suite/archive/refs/heads/main.zipMarketplace Suite is an open-source, modular multi-vendor marketplace operating system built on WordPress and WooCommerce public APIs. WooCommerce remains authoritative for products, customers, orders, taxes, and coupons; marketplace-owned transactional data uses versioned custom tables.
The repository is under active implementation. The exact status of every requirement is tracked in docs/FEATURE-MATRIX.md, with the current phase and verified commands in IMPLEMENTATION-STATUS.md. No unfinished capability is represented as release-complete.
Current verified foundation
- Lazy dependency-aware module kernel.
- Exact minor-unit money arithmetic with deterministic rounding and allocation.
- Vendor creation and audited lifecycle transitions with ownership-aware REST authorization.
- Immutable commission snapshots and balanced ledger journal primitives.
- Persistent database-backed idempotency claims.
- Versioned indexed custom-table migrations.
- HPOS and Cart/Checkout Blocks compatibility declarations.
- WordPress 7.1 / WooCommerce 11.1 runtime activation smoke coverage.
Development
Requirements: PHP 8.1+, Composer 2, Node 20+/npm 10+, and Docker Desktop for the isolated runtime test.
composer install
composer check
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/integration-test.ps1
npm run package
npm run test:package
The release archive is written to dist/marketplace-suite-for-woocommerce.zip from an explicit runtime allowlist.
Architecture and security
Start with docs/ARCHITECTURE.md, docs/DATA-MODEL.md, docs/SECURITY-MODEL.md, and docs/FINANCIAL-MODEL.md. Significant decisions are recorded under docs/ADR/.
License
GPL-2.0-or-later. See LICENSE.