Documentation

SPARKCOMMERCE SUITE

How every feature works and what each one needs. Save this whole document as a PDF with the button below and keep it for reference — it's yours to download any time.

Version 1.5.0 Updated August 2026 xperiarch.co.za
Get support
WordPress6.4 or newer
WooCommerce8.0 or newer
PHP8.1 or newer
CompatibilityHPOS (High-Performance Order Storage) + Cart/Checkout Blocks

Core architecture & WooCommerce integration

What it does
The foundation the whole suite runs on — a layered, no-code engine that plugs into WooCommerce without touching your product prices or order tables.
How it works
All pricing is applied dynamically at runtime through official WooCommerce hooks, so nothing is ever written over your stored data and every change is reversible. Declares HPOS and Cart/Checkout Blocks compatibility.
How to set up
Install the plugin (Plugins → Add New → Upload), activate it, and it appears under WooCommerce → Marketing → SparkCommerce.
Requirements
WordPress 6.4+, WooCommerce 8.0+, PHP 8.1+.

Smart Promotion Engine

What it does
Create percentage, fixed-amount, bulk-tier and Buy-X-Get-Y promotions with scheduling, priority and stacking rules — all from a clean admin, no code.
How it works
The engine resolves which promotions apply to each product at runtime and adjusts the price dynamically in the catalog and cart. Stored prices are never overwritten, so promotions are 100% reversible.
How to set up
Marketing → SparkCommerce → Create Promotion. Choose the type, target products/categories, set discount, schedule and priority, then publish.
Requirements
At least one published WooCommerce product. Scheduling uses each promotion's own timezone.

Sales Analytics & Performance Tracking

What it does
Run multiple promotions at once and see which perform best — revenue, orders and conversion tracked per campaign so you can double down on the winners.
How it works
When an order reaches "Completed", the plugin records revenue and units per promotion into its own analytics table (read only through WooCommerce APIs, HPOS-safe). The Analytics screen shows totals, a time series and a top-promotions ranking.
How to set up
No setup — it records automatically. View it under Marketing → SparkCommerce → Analytics. Figures populate as orders using a promotion are completed.
Requirements
Completed WooCommerce orders that used a promotion.

Styled Cart & Checkout

What it does
A polished, mobile-ready cart and checkout the plugin generates for you and wires into WooCommerce — one click, no page building.
How it works
The cart uses native WooCommerce cart fields (so it works even without JavaScript) plus live AJAX quantity steppers. The checkout wraps WooCommerce's own checkout form, so every payment gateway and validation rule keeps working; order-pay and thank-you pages are handed back to WooCommerce untouched.
How to set up
Marketing → SparkCommerce → Quotes & Bulk → "Create my pages". It builds the Cart and Checkout pages, makes them your store's cart/checkout, and (optionally) adds them to your menu. Deactivating restores your previous pages.
Requirements
WooCommerce active. For edge-to-edge width, use a full-width page template.

Multi-Location Inventory

What it does
Track stock for a product across any number of stores or warehouses.
How it works
Per-location stock is stored as product meta; the product's total WooCommerce stock is kept in sync as the sum across locations, so normal cart/checkout stock rules are unaffected. Optionally shows per-location availability on the product page.
How to set up
Edit a product → Inventory tab → enable multi-location and add locations with their stock. Toggle the product-page display under Settings → Show on product pages.
Requirements
WooCommerce simple (or non-variable) products. Uses WooCommerce product APIs only (HPOS-safe).

Per-Location Delivery Pricing

What it does
Charge delivery by cart quantity using configurable tiers, with optional per-location overrides.
How it works
A dedicated "SparkCommerce Delivery" shipping method resolves the right price from your quantity tiers and recalculates live at checkout as the cart changes. The highest threshold not exceeding the cart quantity wins.
How to set up
Settings → Delivery Pricing: enable it and define your base tiers (and any per-location tiers). Then add the "SparkCommerce Delivery" method to a shipping zone under WooCommerce → Settings → Shipping.
Requirements
WooCommerce shipping zones configured. Pairs naturally with Multi-Location Inventory.

10 Showcase Skins + Custom CSS

What it does
Present promotions as a deals grid, slider or popup in ten polished skins, each with its own custom-CSS box.
How it works
Showcases render server-side (so they're SEO-friendly) and inherit the active skin. Per-skin CSS is automatically scoped to that skin, so edits never leak between skins. The Cart & Checkout inherit the skin too.
How to set up
Choose the skin under Settings → Promotions Showcase and place a showcase shortcode (deals / slider / popup) on a page, or enable the automatic popup.
Requirements
At least one active promotion (with a banner image for the slider/popup).

Quotes & Wholesale

What it does
Let customers request a quote, browse a bulk/wholesale catalog with tier pricing, and pay their quote online — with one-click PDF quotes.
How it works
Quotes are stored as native WooCommerce orders. You review a request, mark it ready, and the customer is emailed a link to pay. A receipt is generated once and emailed on payment. Customers can also look up a quote by number + email.
How to set up
Use "Create my pages" (Quotes & Bulk) to build the Request a Quote, Your Quote, Pay a Quote and Bulk catalog pages, then set the Quote View page under Settings.
Requirements
WooCommerce orders enabled. Reliable email delivery (an SMTP plugin is recommended on most hosts).

Social Sharing

What it does
Share buttons on promotions and deals for Facebook, X, WhatsApp, LinkedIn, Pinterest, Telegram, Email and copy-link.
How it works
Every share link is built from your own site URLs, so it always resolves back to the correct page. Featured promotions get a rich Open Graph / Twitter Card preview (headline, subtitle, banner) on a lightweight, noindex landing that forwards to the promotion.
How to set up
Settings → Social Sharing: enable and pick the platforms. No configuration of the links themselves is needed.
Requirements
None beyond WooCommerce. Loads no remote fonts or third-party trackers.

SEO — promotions search engines can see

What it does
Makes discounted products search-engine friendly so sale prices can appear in Google rich results.
How it works
Because promoted products already show their reduced price on the shop/product pages, WooCommerce's own Product structured data reports the sale price — no duplicate schema. This module adds the "priceValidUntil" date Google recommends for sale offers, taken from the promotion's end date.
How to set up
On by default. Toggle under Settings → SEO. Best with standard percentage / fixed / store-wide promotions (bulk and Buy-X-Get-Y are quantity-based and excluded).
Requirements
A live product with an active catalog promotion. Verify with Google's Rich Results Test.

Shortcode reference

[sparkcommerce_cart]Styled cart page.
[sparkcommerce_checkout]Styled checkout page.
[sparkcommerce_deals]Auto-discovered grid of discounted products.
[sparkcommerce_promo_slider]Carousel of featured promotions.
[sparkcommerce_promo_popup]Modal for a featured promotion.
[sparkcommerce_bulk_catalog]Wholesale/bulk catalog with tier pricing.
[sparkcommerce_quote_request]Request-a-quote form.
[sparkcommerce_quote_lookup]Look up & pay a quote by number + email.
[sparkcommerce_quote_view]Printable quote / receipt + pay button.
Scroll to Top