WC Inventory Overview WP Registry grade A. No security issues foundWP RegistryNo security issues foundOpen the reportA

Purchasing, receiving, inventory-position, and storefront expected-delivery platform for WooCommerce (HPOS-compatible).

Version: 1.34.0 (published — tag v1.34.0)
Releases: https://github.com/magpern/wc-inventory-overview/releases (tag v*)
Requires: WordPress 6.0+, PHP 7.4+, WooCommerce with HPOS supported
Platform status: Milestones M0–M17 complete and published (v1.34.0, schema DB_VERSION 11). M9–M12 shipped as one bundled feature-train release (v1.29.0); M13–M15 shipped as a second bundled feature-train release (v1.32.0); M16 released as standalone (v1.33.0); M17 released as standalone (v1.34.0) — see docs/GITHUB_RELEASE_NOTES_1.34.0.md and docs/ARCHITECTURE_BASELINE_v1.24.0.md.

Features

• Inventory overview with inline stock editing, filters, and CSV export
• Quick restock and average-cost adjustments
• Inventory movement ledger
• Order profit and product profitability reporting
• Exchange rate history and multi-currency purchasing
• Dashboard charts (Chart.js bundled in assets/vendor/)
• Suppliers (M1): WooCommerce → Purchasing submenu with first-class supplier entities (schema v6)
• Purchase Orders (M2): four-state PO lifecycle, PO numbering, expected dates/confidence, append-only event log (schema v7)
• Inventory Position (M3): read-only, derived {On Hand, Incoming, Position} with per-supply drill-down (no schema change)
• Goods Receipts (M4): the sole stock/cost mutation point — "Receive Stock" tab, Quick Receive Without PO (schema v8)
• PO Receiving (M5): receive directly against a Purchase Order; qty_received tracking with reconciliation CLI (schema v9)
• Migration & Retirement (M6): legacy Batch Intake history migrated into Goods Receipts; Batch Intake retired (schema v10)
• Storefront Expected Delivery (M7): customer-facing "Expected back around …" / "Expected during week …" / "Expected soon" text via a versioned public API (no schema change)
• Supplier Observed Lead Time (M9): read-only average/fastest/slowest delivery statistics from completed PO/receipt history
• PO Expected-Date Suggestion (M10): advisory Expected Date/Confidence pre-fill on new Purchase Orders
• Supplier On-Time Delivery Rate (M11): read-only on-time percentage against known expected dates + grace days
• Supplier List Performance (M12): Observed Lead Time and On-Time Rate columns on the Suppliers list
• Printable Purchase Order (M13): standalone, read-only printable HTML view of a Purchase Order, resilient to deleted product/supplier references
• Supplier Order History (M14): paginated, status-inclusive list of every Purchase Order for a supplier, with per-order Ordered/Received Value
• Supplier Spend Summary (M15): per-currency total of Ordered/Received Value across a supplier's committed Purchase Orders (currencies never blended)
• PO Expected-Date & Delay Transparency (M16): visibility into expected-date suggestion provenance, configurable PO delay grace period, Supplier and Status columns on Inventory Position drilldown
• Supplier Merge (M17): consolidate redundant suppliers by irreversibly merging source into target, reassigning all related POs and receipts, with full audit logging (schema v11)

Installation

1. Build or download builds/wc-inventory-overview-{version}.zip
2. WordPress Admin → Plugins → Add New → Upload Plugin
3. Activate WC Inventory Overview
4. Open WooCommerce → Inventory & Profit or WooCommerce → Purchasing

Or deploy by copying the plugin folder to wp-content/plugins/wc-inventory-overview/.

Build ZIP

./scripts/build-zip.sh
# Output: builds/wc-inventory-overview-{version}.zip

The archive contains a single top-level folder wc-inventory-overview/ suitable for WordPress uploads.

Development

# Syntax check (Docker)
docker run --rm -v "$(pwd):/app" -w /app php:8.2-cli \
  sh -c 'for f in $(find . -name "*.php" -not -path "./docs/*"); do php -l "$f"; done'

# Optional WP-CLI maintenance script (run inside WooCommerce stack)
# See cli/set-low-stock-threshold.php

Automated tests: see docs/testing.md (PHPUnit, PHPCS, Docker-based integration).

Documentation

Repository

Canonical Git: git@github.com:magpern/wc-inventory-overview.git — production ZIPs and GitHub Actions releases live here.

Development copy also exists under biopentra-custom-plugins/plugins/wc-inventory-overview/ (rsync mirror; do not tag wc-inventory-overview-v* on the monorepo).

License

GPL-2.0-or-later (WordPress plugin).