PolyCMS Plugin: PolyStore - Native E-Commerce Storefront for Perfex CRM
PolyStore transforms your Perfex CRM installation into a complete, native e-commerce storefront bundled directly inside PolyCMS (v1.4.0+). Manage simple, variable, digital, service, and B2B quote-only products alongside Perfex Items, Taxes, Currencies, Clients, Invoices, Estimates, Payment Gateways, and Email Templates without maintaining a separate WordPress or WooCommerce server.
Overview & Native CRM Integration
Instead of relying on external storefronts and fragile webhook sync bridges, PolyStore operates directly inside Perfex CRM while keeping internal CRM items private by default (opt-in publishing):
- Products & Pricing: Storefront products extend your Perfex Items catalog 1:1, automatically inheriting configured Perfex Currencies and Tax rates.
- Categories: Hierarchical storefront categories sync cleanly with Perfex Item Groups and support multi-category assignment with category thumbnails and SEO metadata.
- Customers & Accounts: Supports Guest Checkout, logged-in Perfex CRM Contacts, and instant customer account creation directly on the checkout page.
- Orders & Invoicing: Standard storefront checkouts automatically issue verified Perfex Invoices with PDF downloads and direct payment links.
- B2B Quote Requests: Quote-only items or B2B quote checkouts generate native Perfex Estimates that staff can review, adjust, and convert into Invoices in one click.
- Payment Gateways: Inherits all active Perfex Payment Modes (Stripe, PayPal, Bank Transfer, and offline payment methods) automatically.
- Transactional Emails: Seeds 9 native, editable Perfex Email Templates directly under Setup > Email Templates with 27 dynamic merge fields.
Activation & Automatic Setup
To activate PolyStore on your site:
- Navigate to Blog > Plugins (Plugin Manager Demo).
- Locate PolyStore and click Activate.
Upon activation, PolyStore automatically completes a zero-downtime setup:
- Creates the dedicated storefront tables without modifying core Perfex CRM tables.
- Seeds default storefront settings (order prefix
PS-, clean product and category URLs, shipping rules, and sitemap options). - Auto-provisions 7 essential storefront pages in Blog > Pages: Shop (
/shop), Cart (/cart), Checkout (/checkout), Order Received (/order-received), Track Order (/track-order), My Account (/my-account), and Store Terms (/store-terms). - Seeds a Shop link into your active Primary Navigation Menu automatically.
- Registers all 9 transactional order and quote email templates in Perfex CRM.
- Adds a dedicated top-level Store menu in the Perfex CRM admin sidebar.
Admin Store Management
Manage your entire storefront from the top-level Store sidebar menu in Perfex CRM Admin:
| Sidebar Menu | Admin Route | Purpose |
|---|---|---|
| Dashboard | admin/polycms/plugin/polystore/dashboard |
Store revenue summary, recent orders, low-stock alerts, and quick actions (Store Dashboard Demo) |
| Products | admin/polycms/plugin/polystore/products |
Create and edit products, sync from Perfex Items, configure variations, pricing, gallery images, inventory, and digital downloads |
| Categories | admin/polycms/plugin/polystore/categories |
Manage nested product categories, thumbnails, SEO fields, and Perfex Item Group sync |
| Attributes | admin/polycms/plugin/polystore/attributes |
Manage global attributes (Type, Size, Color, Model, Storage) and visual swatch display styles |
| Orders | admin/polycms/plugin/polystore/orders |
Manage storefront orders and B2B quotes, update fulfillment statuses, enter carrier tracking details, and open linked Perfex Invoices or Estimates |
| Coupons | admin/polycms/plugin/polystore/coupons |
Configure percentage or fixed promo codes, minimum spend, usage limits, expiry dates, and category or product restrictions |
| Settings | admin/polycms/plugin/polystore/settings |
Configure storefront pages, checkout modes, guest and registration options, shipping rates, payment methods, email alerts, and XML sitemaps |
Flexible Products, Multi-Attribute Variations & Faceted Filtering
Supported Product Types
- Simple Products: Standard catalog items with SKU, regular and scheduled sale pricing, gallery images, and optional stock tracking.
- Variable Products: Unlimited multi-attribute combinations ideal for apparel and print-on-demand (Product Type such as Tee, Hoodie, Canvas + Size + Color) or electronics (Model + Storage + Finish). Each variation supports independent SKU, regular/sale pricing, multi-currency overrides, tax overrides, dedicated variant images, stock quantities, and optional individual Perfex Item linking.
- Digital Products: Attach downloadable files per product or per variation with secure tokenized download links unlocked automatically once paid.
- Service & Quote-Only Products: Disable physical shipping and optionally require a B2B Estimate request instead of immediate invoice checkout.
Global Attributes & Swatch Display Modes
In Store > Attributes, create reusable global attributes with four visual storefront selector modes:
- Color Swatches: Visual hex color circles for apparel shades or hardware finishes.
- Image Swatches: Thumbnail preview swatches for textures, fabrics, or product styles.
- Button Pills: Clean pill buttons for sizes (
S,M,L,XL) or capacities (128GB,256GB,1TB). - Dropdown Select: Compact dropdown selector for long option lists or model codes.
High-Performance Faceted Catalog Filtering
PolyStore maintains an indexed catalog filter table rebuilt automatically on every product save, powering instant storefront filtering on /shop and category archives:
- Disjunctive Multi-Attribute Filtering: Selecting multiple options within one attribute applies OR logic (for example, Color = Black or Navy), while combining across attributes applies AND logic (for example, Size = L and Color = Black or Navy).
- Live Price Range, In-Stock & On-Sale Toggles: Fast filtering backed by precomputed product price bounds and variant stock summaries.
- Accurate Facet Counts & Active Filter Chips: Real-time matching product counts next to each filter term with one-click filter reset.
Unified Checkout: Guest, Account Creation & B2B Quotes
PolyStore supports three buying flows from a single /checkout experience:
- Guest Checkout: Shoppers complete an order using their billing and shipping information and immediately receive an order confirmation email containing a signed one-click tracking link and a Perfex Invoice payment link.
- Create an Account at Checkout: Guests can check "Create an account?" during checkout and provide an optional password (or let PolyStore generate one securely). PolyStore automatically creates their Perfex Client and Primary Contact, signs them into the storefront, dispatches the welcome email, and links their order directly inside
/my-account. - B2B Quote / Estimate Request: When quote checkout is enabled (or when a cart contains Quote-Only products), buyers submit a formal quote request that creates a native Perfex Estimate. Staff can negotiate pricing inside Perfex CRM and convert the approved Estimate into a Perfex Invoice in one click.
Bidirectional Perfex Invoice & Payment Sync
- Invoice Paid: Automatically marks the storefront order as paid, advances fulfillment to Processing, deducts inventory idempotently, unlocks digital downloads, and sends the Payment Confirmed email.
- Invoice Cancelled: Automatically cancels the linked storefront order, restores reserved stock, and emails the customer.
- Estimate Converted to Invoice: Automatically transitions a B2B quote order into a standard invoice order linked to the new Perfex Invoice.
Native Perfex Email Templates & Merge Fields
PolyStore registers 9 customizable email templates under Setup > Email Templates in Perfex CRM:
| Template Slug | Recipient | Trigger Event |
|---|---|---|
polystore-order-created-customer |
Customer | Immediately after a standard storefront order is placed |
polystore-new-order-admin |
Store Admin | Immediately after a new storefront order is placed |
polystore-order-paid-customer |
Customer | When the linked Perfex Invoice is paid online or manually recorded |
polystore-order-shipped-customer |
Customer | When staff marks an order as Shipped with carrier and tracking number |
polystore-order-completed-customer |
Customer | When staff marks an order as Completed |
polystore-order-cancelled-customer |
Customer | When an order or linked invoice is cancelled |
polystore-order-refunded-customer |
Customer | When staff marks an order as Refunded |
polystore-quote-requested-customer |
Customer | Immediately after a B2B quote request is submitted |
polystore-quote-requested-admin |
Store Admin | Immediately after a new B2B quote request is submitted |
All templates support 27 dynamic merge fields, including {order_number}, {order_date}, {order_status}, {order_payment_status}, {order_payment_method}, {order_subtotal}, {order_discount}, {order_shipping_cost}, {order_tax}, {order_total}, {order_items_table}, {order_shipping_carrier}, {order_tracking_number}, {order_tracking_url}, {order_tracking_page_url}, {order_view_url}, {order_admin_url}, {order_digital_downloads_html}, {order_notes}, {invoice_number}, {invoice_link}, {estimate_number}, {estimate_link}, {customer_name}, {customer_email}, {store_name}, and {store_url}.
Tip: Enable "Suppress duplicate Perfex invoice email" in Store > Settings if you want customers to receive only PolyStore's rich branded order confirmation email instead of both a PolyStore order email and Perfex's default invoice email.
Customer Portal & Public Order Tracking
Customer Account Portal (/my-account)
Logged-in customers access a clean five-tab storefront dashboard:
- Overview: Quick account metrics, recent orders, and direct navigation shortcuts.
- My Orders: Complete order history with fulfillment badges, carrier tracking links, line-item breakdowns, and View / Pay Invoice buttons.
- B2B Quotes: Submitted quote requests with direct links to official Perfex Estimate PDFs.
- Downloads: Active tokenized download links for paid digital products.
- Addresses: Billing and shipping details synchronized with the customer's Perfex Client profile.
Public Order Tracking (/track-order)
Guests and registered customers can verify fulfillment milestones anytime using the [polystore_order_tracking] shortcode. Enter an Order Number and Billing Email (or open the signed tracking link from any confirmation email) to inspect live order stages, shipment carrier tracking, itemized totals, and invoice payment status.
Storefront Shortcodes
PolyStore registers 11 shortcodes via the PolyCMS Shortcode Engine:
| Shortcode | Key Parameters | Description |
|---|---|---|
[polystore_shop] |
category, columns, per_page, sidebar, featured, on_sale |
Full faceted shop catalog with attribute and price filter sidebar |
[polystore_products] |
category, limit, columns, sort, featured, on_sale |
Curated product grid for homepages, landing pages, or promotions |
[polystore_product] |
id, slug |
Full interactive single-product detail block (id="auto" shows a featured product) |
[polystore_categories] |
columns |
Responsive grid of visible product categories with thumbnails and counts |
[polystore_add_to_cart] |
id, label |
Standalone quick Add-to-Cart button or Select Options CTA |
[polystore_cart] |
None | Interactive shopping cart with quantity updates and coupon redemption |
[polystore_checkout] |
None | Unified checkout form for guest orders, account creation, and B2B quotes |
[polystore_order_received] |
None | Order confirmation and payment summary view |
[polystore_order_tracking] |
None | Self-service order tracking lookup form and visual status timeline |
[polystore_my_account] |
None | Customer portal for orders, quotes, downloads, and addresses |
[polystore_mini_cart] |
None | Compact cart button with live item count badge |
Widgets, Menu Builder, SEO Sitemaps & MTBuilder Integration
- 6 Dedicated Store Widgets: Place Product Search, Product Categories, Products Showcase, Price & Stock Filter, Mini Cart, and Order Tracking into any sidebar or footer via Blog > Widgets (Widgets & Sidebars Guide).
- Menu Builder Sources: Adds Store Pages, Product Categories, and Products panels directly inside Blog > Menus (Menu Builder Guide).
- Product & Category XML Sitemaps: Automatically publishes
/product-sitemap.xml(chunked every 1,000 products with Google<image:image>tags) and/product-category-sitemap.xml, registered inside/sitemap_index.xmland the XML Sitemap Plugin, plus Schema.orgProductJSON-LD metadata on every product page. - 10 Visual MTBuilder Store Blocks & 7 Presets: When MTBuilder is active, drag and drop 10 visual Store elements (Shop Catalog, Products Grid, Product Categories, Single Product, Add to Cart Button, Shopping Cart, Checkout Form, Order Tracking, My Account Portal, and Mini Cart) or load 3 Store Full Page Templates and 4 Store Section Parts with live preview rendering.
For developers customizing pricing, checkout payloads, shipping methods, email merge fields, or order lifecycle webhooks, see the PolyCMS Hooks & Filters Complete Reference.
Related Documentation
- PolyCMS Plugin Management - Activate, configure, and manage all 8 bundled plugins.
- MTBuilder Visual Page Builder - Build custom storefronts with PolyStore visual blocks and E-commerce templates.
- Widgets & Sidebars in PolyCMS - Configure the 6 PolyStore widgets and storefront shortcodes.
- PolyCMS Menu Builder Guide - Add Store Pages, Product Categories, and Products to navigation menus.
- XML Sitemap Plugin - Automatic product and product category XML sitemaps for SEO.
- Hooks & Filters Complete Reference - Developer hooks for PolyStore orders, pricing, and MTBuilder extensibility.
Launch Your CMS for Perfex CRM — Lifetime Access for Just $19
Create blogs, pages, themes, plugins, and manage everything from one powerful unified admin panel.
Early Adopter Advantage
Current pricing reflects the module’s present feature set. As additional plugins, themes, multilingual capabilities, builders (MTBuilder), and ecosystem integrations are released, pricing may be adjusted. Early customers secure today’s price while benefiting from future updates.