POSMall - PostgreSQL eCommerce, POS, Services and Virtual Products
POSMall is a PostgreSQL-first eCommerce plugin for October CMS and Laravel. It is designed for stores that need a fast product catalog, point-of-sale workflows, service products, virtual products, checkout, orders, payments, shipping, taxes, reviews and API-ready commerce automation.
The plugin provides the commerce engine. The companion POSMall Theme provides the customer storefront and is available separately:
https://github.com/TjoBiZ/POSMallTheme
Use POSMall when you need an October CMS commerce backend with structured catalog management, PostgreSQL indexing, backend order management, tax automation helpers, API token scopes and a clean path for external integrations.
Core capabilities:
- Product catalog, categories, brands, properties, prices, stock and optimized product media.
- Physical products, virtual products, downloadable products and service options.
- Cart, checkout, orders, order states, payment methods, shipping methods, discounts and tax rules.
- Reviews, customer profiles, addresses and Favorite Lists.
- PostgreSQL-first catalog indexing and filtering architecture.
- Backend tools for orders, products, services, vendors, channels, warehouses, taxes and API access.
- REST API documentation and API token permission tree for controlled integrations.
- Private GraphQL-ready architecture for internal commerce automation.
- Companion storefront theme support for catalog, product, service, cart, checkout and account pages.
POSMall is built for small and growing businesses that want a Laravel / October CMS commerce stack with PostgreSQL as the primary database.
The following plugins are required
User
Front-end user management.
User
Front-end user management.
Translate
Enables multi-lingual websites and translate website contents.
Translate
Enables multi-lingual websites and translate website contents.
Location
Adds location based features, such as Country and State.
Location
Adds location based features, such as Country and State.
Installation via Command Line
php artisan plugin:install KodZero.POSMall
POSMall Documentation
Requirements
- October CMS 4.x
- Laravel 12.x runtime used by October CMS 4.x
- PHP 8.2 or newer
- PostgreSQL
- RainLab.User, RainLab.Location and RainLab.Translate when customer accounts, addresses and multilingual storefront behavior are required
Installation
Install the plugin through October CMS Marketplace or Composer, then run the normal October CMS migration/update flow.
After installation:
- Open the backend.
- Configure POSMall general settings.
- Configure currencies, payment methods, shipping methods and tax rules.
- Add categories, brands, products, services, virtual products and prices.
- Rebuild the POSMall catalog index when importing or changing large product sets.
- Generate optimized catalog images before benchmarking or going live.
- Use the companion POSMall Theme for the ready storefront experience.
Companion Theme
The recommended storefront is POSMall Theme:
https://github.com/TjoBiZ/POSMallTheme
The theme contains the public catalog, product detail pages, services, cart, checkout, customer account pages, payment-link pages and optimized assets wired for POSMall components.
Backend Areas
POSMall adds backend sections for:
- Orders and order context
- Products and variants
- Services and service options
- Categories, brands and properties
- Vendors, channels and warehouses
- Taxes and USA tax source helpers
- Payment and shipping settings
- REST API documentation and API tokens
API
POSMall includes public backend documentation for REST API v1 and controlled API tokens. API access is managed through a backend permission tree so each token can be limited to specific catalog, cart, checkout, order, customer, vendor, warehouse, review or Favorite List capabilities.
GraphQL-oriented documentation and internal AI-agent integration notes are intentionally private and are not exposed in public Marketplace documentation.
Taxes
The tax module supports manually configured tax rules and source-backed USA tax helper workflows. Source-backed rates can be imported and prepared for scheduled refreshes. Store owners remain responsible for legal and accounting validation of tax configuration.
Images and Page Speed
POSMall keeps originals separate from optimized catalog/card/detail derivatives. Optimized JPEG and WebP derivatives are generated for product cards, product detail pages, services, Favorite Lists, cart/order surfaces and other image-bearing storefront areas.
Support
Use the GitHub repository for source code, issues and project notes:
-
This plugin has not been reviewed yet.
-
| 1.0.20 |
Set USD as the default POSMall currency for clean installs and deployments. Jun 10, 2026 |
|---|---|
| 1.0.19 |
Seed default POSMall commerce settings required after a clean install. Jun 10, 2026 |
| 1.0.18 |
Add safe per-tax opt-in for scheduled USA tax source updates. Jun 10, 2026 |
| 1.0.17 |
Add optional vendor and channel context scope to standalone POSMall services. Jun 10, 2026 |
| 1.0.16 |
Add optional POSMall API token customer and commerce context allow-lists. Jun 10, 2026 |
| 1.0.15 |
Rename POSMall runtime morph keys from mall.* to posmall.*. Jun 10, 2026 |
| 1.0.14 |
Add optional POSMall product vendor, channel and warehouse inventory pivots. Jun 10, 2026 |
| 1.0.13 |
Scope POSMall API checkout idempotency to API token and commerce context. Jun 10, 2026 |
| 1.0.12 |
Seed default POSMall API commerce context rows. Jun 10, 2026 |
| 1.0.11 |
Add POSMall API token, commerce context and order payment-link foundation. Jun 10, 2026 |
| 1.0.10 |
Add PostgreSQL covering index for general catalog bestseller listing. Jun 10, 2026 |
| 1.0.9 |
Add optional delivery notes to POSMall addresses. Jun 10, 2026 |
| 1.0.8 |
Add PostgreSQL partial index for service-carrier product exclusion. Jun 10, 2026 |
| 1.0.7 |
Add PostgreSQL category index summary projections for large catalog counts and brand filters. Jun 10, 2026 |
| 1.0.6 |
Add PostgreSQL category index projection for large catalog listing and filter metadata. Jun 10, 2026 |
| 1.0.5 |
Add PostgreSQL index for catalog category render hot paths. Jun 10, 2026 |
| 1.0.4 |
Add local PostgreSQL load benchmark run storage. Jun 10, 2026 |
| 1.0.3 |
Add PostgreSQL indexes for checkout, account, payment recovery, and USA tax lookup hot paths. Jun 10, 2026 |
| 1.0.2 |
Add PostgreSQL trigram indexes for scalable product search. Jun 10, 2026 |
| 1.0.1 |
Track RainLab users explicitly created by POSMall before optional POSMall user purge. Jun 10, 2026 |
| 1.0.0 |
POSMall 1.0.0 PostgreSQL-first public release for OctoberCMS / Laravel. Jun 10, 2026 |
POSMall Upgrade Guide
v1.0.0
Initial public POSMall plugin release.
There are no previous public POSMall versions to migrate from.
Recommended first-install checklist:
- Install POSMall.
- Run October CMS updates/migrations.
- Configure currencies, payment methods, shipping methods and taxes.
- Install or enable the POSMall Theme if you need the ready storefront.
- Add products, services, virtual products, categories, brands and properties.
- Rebuild the POSMall catalog index.
- Generate optimized image derivatives.
- Configure REST API tokens only for the exact integration scopes needed.
If you are migrating from another commerce plugin, do not reuse old database tables directly. Import business data into POSMall's PostgreSQL-first schema and rebuild the POSMall index after import.