Back to Main Site

PolyCMS Plugin: PolyStore - Native E-Commerce Storefront for Perfex CRM

Last updated on Nov 22, 2026 11:53 AM 11:53 AM 5,016.37 ms

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:

  1. Navigate to Blog > Plugins (Plugin Manager Demo).
  2. 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:

  1. 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.
  2. 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.
  3. 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.xml and the XML Sitemap Plugin, plus Schema.org Product JSON-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

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.