WP Manifestindependent plugin directory
manifest / ecommerce / woocommerce-pos2

WooCommerce POS Pro (Enterprise Edition)

A premium POS plugin for WP Woocoommerce

★ 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/saliu74/woocommerce-pos2/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.

WooCommerce POS Pro

A multi-branch, multi-register point-of-sale system built directly on top of WooCommerce. Cashiers ring up in-person sales from a dedicated terminal screen, while every product, stock level, customer, and order stays in perfect sync with your existing WooCommerce store — no separate POS catalog to maintain.

Current version: 1.8.3


Features

  • POS Terminal — a fast, touch/mobile-friendly checkout screen (/pos) with instant product search, category filters, variation picking, a live cart, and parked/resumable sales.
  • Multi-branch & multi-register — model multiple physical locations, assign registers to branches, and optionally track stock per branch (opt-in per product; everything else falls back to the shared store-wide WooCommerce stock count).
  • Inventory protection — out-of-stock items are blocked from the cart server-side (not just visually disabled), stock is deducted atomically with row-level locking to prevent overselling, and variable-product stock is resolved from its variations rather than the (often unmanaged) parent product.
  • Payments — Cash, Card, Bank Transfer, and Split payment modes (Split covers all three), with a cash-tendered/change-due calculator and split-balance validation.
  • Delivery / Pickup — orders can be tagged as pickup or delivery; delivery orders require an address (validated client- and server-side), stored on the order and mirrored into WooCommerce's own shipping-address field.
  • Discounts — per-item and whole-order discounts, each supporting a real WooCommerce coupon code, a manual percentage, or a manual fixed amount. Coupon codes are self-authorizing; manual percentage/fixed discounts require manager PIN confirmation at the terminal, independently re-checked server-side via the override_wc_pos_prices capability.
  • PIN security — quick-access PIN login with attempt throttling (5 failed attempts locks the account for 5 minutes), plus self-service "Change My PIN" from the terminal at any time (itself requires the current PIN).
  • Reprint Receipt — reconstructs and reprints the exact receipt for any past order from Order History.
  • Reporting suite (POS → Reports) — Sales Summary, Shift History/Cash Reconciliation, Top Products, Cashier Performance, and Branch Comparison, each with date-range/branch filtering and CSV export.
  • Mobile-responsive terminal — below ~1024px, the layout switches to a mobile flow: full-screen product grid, a full-screen cart view opened via a floating button, a collapsible nav sidebar, and a sticky checkout footer that's always reachable without scrolling.
  • Role-based access — a dedicated pos_cashier role plus four custom capabilities (below) let you grant exactly the level of access each staff member needs.

Shift tracking (enforcement currently disabled)

Registers can still be opened/closed as a shift with a cash-reconciliation summary, and every past shift remains visible in POS → Reports → Shift History — this data model, the admin Force Close Shift recovery tool, and the underlying REST endpoints are all fully intact. However, requiring an open shift before a sale can be processed is currently switched off at both the terminal and API level, after repeated reliability issues in the shift-close flow caused real disruption to live sales. Re-enabling the block is a small, contained change (see SalesEngine::create_pos_order()) if you want to revisit it later — the groundwork (closing-time reminders, stale-shift detection, cross-day enforcement) is already built, just disconnected from checkout.


Requirements

  • WordPress
  • WooCommerce (active) — the plugin will not initialize without it
  • PHP 7.4+ (uses namespaces, short array syntax, null coalescing)
  • A modern browser for the terminal (Chrome/Safari/Edge/Firefox, desktop or mobile)

Installation

  1. Upload the wc-pos-pro folder to wp-content/plugins/, or install the zip via Plugins → Add New → Upload Plugin.
  2. Activate WooCommerce POS Pro from the Plugins screen.
  3. On activation, the plugin creates its database tables, registers the pos_cashier role and custom capabilities, and adds the /pos rewrite rule (a permalink flush happens automatically).
  4. Set up the essentials in this order:
    • POS → Branches — create at least one branch (a "Main Branch" is seeded automatically for single-location stores).
    • POS → Registers — create a register and assign it to a branch.
    • Visit /pos on your site, select the branch/register, and start selling — no shift needs to be opened first (see Shift tracking above).
  5. Optional: POS → Branch Stock to allocate per-branch stock counts, POS → Tax for POS-specific tax rates, POS → Receipt Builder to customize the receipt template.

Note: table creation is self-healing — on every version change (not just a fresh activation), the plugin re-verifies and repairs its schema, including adding columns to tables that already existed from an earlier version. No deactivate/reactivate needed if a table or column ever ends up missing.


Architecture

wc-pos-pro/
├── wc-pos-pro.php                     # Bootstrap: activation/deactivation, hooks, rewrite rules,
│                                       #   placeholder-email blocking
├── uninstall.php                      # Full data cleanup (opt-in via a setting)
├── includes/
│   ├── Autoloader.php                 # PSR-4-style autoloader for the WCPOS\ namespace
│   ├── API/
│   │   ├── REST_Server.php            # Core REST API: products, customers, orders, shifts, tax,
│   │   │                              #   PIN, coupon validation
│   │   └── Branches_Controller.php    # REST API for branches + per-branch stock
│   ├── Admin/
│   │   ├── AdminMenu.php              # All wp-admin screens (Branches, Registers, Branch Stock,
│   │   │                              #   Reports, Tax, Receipt Builder, Settings)
│   │   └── Permissions.php            # Registers the pos_cashier role + custom capabilities
│   ├── Database/
│   │   └── Tables.php                 # dbDelta schema for all custom tables
│   ├── Orders/
│   │   └── SalesEngine.php            # Order creation: stock pre-checks, discount/coupon
│   │                                  #   authorization, atomic deduction, order meta
│   └── POS/
│       └── Inventory.php              # Atomic, row-locked stock deduction (global + per-branch)
└── templates/
    └── pos-terminal.php                # The entire terminal UI: HTML/Tailwind/vanilla JS, single file

The terminal (pos-terminal.php) is a single self-contained template — no build step, no bundler. It loads Tailwind via CDN and talks to the REST API directly with fetch().


REST API

Namespace: wc-pos/v1

Method Route Purpose
GET /health Basic connectivity check
GET /products Product list — real pagination (page param), title/SKU-only search (s), category and branch filters. Returns { products, page, totalPages, total }.
GET /categories Product categories
GET /customers Customer search (s param)
POST /customers Create a customer
GET /orders Order history
GET /orders/{id} Full order detail for receipt reprinting
POST /orders Create a POS sale (SalesEngine::create_pos_order())
POST /coupons/validate Preview a coupon code's discount before applying it at checkout
POST /registers/shift Open or close a register shift (tracking only — not enforced at checkout)
GET /registers List registers; status is derived live from the shifts table, not a cached column
GET/POST /tax-rates List / create POS tax rates
POST/DELETE /tax-rates/{id} Update / deactivate a tax rate
GET/POST /receipt-config Receipt template settings
POST /pin/verify Verify a cashier PIN (rate-limited)
POST /pin/set Set/change a PIN — requires the current PIN (or 1234 on first-time setup)
GET/POST /branches List / create branches
POST/DELETE /branches/{id} Update / delete a branch
GET/POST /branches/{id}/stock Read / write a branch's per-product stock allocation

Most routes require the process_wc_pos_sales capability (or manage_woocommerce); mutating routes for branches/tax/registers require manage_wc_pos_branches or manage_wc_pos respectively (or manage_woocommerce). Applying a manual (non-coupon) discount additionally requires override_wc_pos_prices.


Roles & Capabilities

Capability Grants
process_wc_pos_sales Terminal access: browse products, take payment, open/close shifts
manage_wc_pos General POS administration: settings, tax rates, receipt builder, reports
manage_wc_pos_branches Create/edit/delete branches, registers, and branch stock allocations
override_wc_pos_prices Apply manual (percentage/fixed) discounts at checkout — not required for a coupon code, which is self-authorizing

administrator and shop_manager receive all four automatically. A dedicated pos_cashier role is created on activation with process_wc_pos_sales and read_private_shop_orders — enough to run the till without full store-admin access. Assign the other three capabilities to any role that should also manage settings, branches, or discounts.


Database Tables

All prefixed with your site's table prefix (e.g. wp_):

  • wc_pos_branches — physical locations
  • wc_pos_branch_stock — optional per-branch stock allocations (product/variation → branch → quantity)
  • wc_pos_registers — tills, each assigned to a branch. The status column is a denormalized cache; the shifts table below is the actual source of truth for whether a register is open or closed.
  • wc_pos_shifts — every shift opened/closed, with cash reconciliation figures (cash/card/transfer sales breakdown, expected vs. actual cash). Still fully populated even though shift enforcement is currently disabled at checkout.
  • wc_pos_inventory_logs — immutable audit log of every stock change made through the POS
  • wc_pos_transfers — stock transfer records between branches (schema present; not yet exposed in the UI)
  • wc_pos_tax_rates — POS-specific tax rates

Orders themselves remain standard WooCommerce orders (wp_posts + related tables), tagged with POS-specific meta (_wc_pos_register_id, _wc_pos_branch_id, _wc_pos_cashier_id, _wc_pos_cashier_name, _wc_pos_payments, _wc_pos_terminal_reference, _wc_pos_fulfillment_type, _wc_pos_delivery_address) and created_via = 'wc_pos_pro'. customer_id is validated against a real WordPress user before being stored — an invalid/stale reference falls back to a guest order rather than being stored as-is, and billing name/email are populated from the customer's profile when a real customer is attached.


Notable behavior

  • Stock is deducted exactly once per sale. WooCommerce's own core stock-reduction hook fires automatically on the order's pending→processing transition; this plugin explicitly marks stock as already-reduced (via WooCommerce's own tracking) before that transition happens, so core doesn't reduce it a second time.
  • Placeholder customer emails never receive mail. Walk-in customers with no real email get an auto-generated @pos.local placeholder address so the system has something to store. A pre_wp_mail filter blocks any outgoing email to that address at the WordPress mail layer — this covers every plugin's emails, not just WooCommerce's own order emails, since other plugins (e.g. account/email-verification plugins) can independently notice the new user account this creates and try to email it.
  • Search matches product title or SKU only, as an exact phrase — not a full-text search across descriptions, and not an OR-match across individual words in a multi-word query.
  • Every database write in the shift and admin-form flows is verified after the fact, not just checked for a hard SQL error — $wpdb->update() returns rows-affected, not a boolean, so a query that runs without error but changes nothing is explicitly caught rather than treated as success.

Known Limitations / Roadmap

  • Shift enforcement is built but disabled — see Shift tracking above.
  • Stock transfers between branches (wc_pos_transfers) have a database schema but no admin UI yet.
  • No dedicated "void/cancel this sale" action at the terminal — cancellations currently go through WooCommerce's normal admin-side order tools.
  • Receipts print via the browser's native print dialog; there's no bespoke in-app "Download PDF" button — on devices without a connected printer, staff use the browser's own "Save as PDF" print destination instead.
  • Reports currently query orders directly (no caching/pre-aggregation) — fine at typical small-to-mid store volumes; a very high order volume may eventually warrant a summary table.

Support / Development Notes

This plugin is actively maintained. Please bump Version: in the plugin header and WC_POS_VERSION in wc-pos-pro.php together on every change, however small — several parts of the plugin (table self-healing, cache-busting) key off this value matching.