Documentation / Ecommerce

Ecommerce

Luminal CMS includes a complete ecommerce stack — product management, multi-gateway payments, print-on-demand merchandise, and affiliate product grids.

System Overview

Three modules work together under the Ecommerce menu group:

  • MyStore — Product management and customer-facing storefront
  • Payment Providers — Gateway configuration (PayPal, Stripe, Square)
  • Printful Manager — Print-on-demand merchandise integration
  • Affiliate Products — Affiliate link management with AI discovery

MyStore

Setup

  1. Navigate to My Store in the Ecommerce section.
  2. Add products with title, description, price, and images.
  3. Product images are stored in media/store/.
  4. Product data is stored in admin/data/mystore/products/ as individual JSON files.

Embedding the Store

Add the storefront to any page using the shortcode:

[[store]]
[[mystore]]

The storefront renders a product grid with add-to-cart functionality, a shopping cart, and checkout flow.

Orders

Orders are saved to admin/data/mystore/orders.json. Each order records the products, quantities, customer information, payment gateway used, and order status.

Payment Providers

Configure payment gateways that customers can use at checkout:

PayPal

  1. Open Payment Methods.
  2. On the PayPal card, enter your Client ID and Secret.
  3. Toggle Enabled on.
  4. Click Save.

Stripe

Enter your Stripe Publishable Key and Secret Key. Stripe supports credit card payments directly on your site.

Square

Enter your Square Application ID and Access Token for in-person and online payments.

You can enable multiple gateways simultaneously. Set one as the default — this is pre-selected at checkout but customers can choose any enabled gateway.

Printful Integration

Sell print-on-demand merchandise without managing inventory:

  1. Navigate to Printful in the Ecommerce section.
  2. Enter your Printful API key in the settings.
  3. Click Test Connection to verify.
  4. Click Sync Products to pull your Printful catalog.

Printful products appear in the storefront alongside your custom products, tagged with a POD badge. Orders for Printful products are automatically fulfilled by Printful.

Affiliate Products

Manage and display affiliate product grids:

  1. Navigate to Affiliate Products in the Ecommerce section.
  2. Click + Add Product.
  3. Paste the affiliate URL — the system auto-detects the source (Amazon, Walmart, Best Buy, Target, or generic).
  4. Fill in title, description, image URL, and category.
  5. Save the product.

AI Discovery

Use AI to discover relevant affiliate products:

  1. Click AI Discover in the toolbar.
  2. Enter a prompt describing the products you want (e.g., "studio recording equipment under $200").
  3. Review the AI suggestions.
  4. Click Approve on products you want to add.

Embedding Affiliate Products

[[affiliate-products]]
[[affiliate-products category="gear" limit="6" columns="4"]]
[[affiliate-product:product-id]]

Affiliate links automatically include rel="noopener nofollow sponsored" for FTC compliance.

Checkout Flow

  1. Customer browses the storefront (products from MyStore + Printful).
  2. Adds items to cart (stored in PHP session).
  3. At checkout, checkout-gateway.php presents enabled payment gateways.
  4. Customer selects gateway and completes payment.
  5. Order is recorded in admin/data/mystore/orders.json.
  6. Products tagged with source and fulfillment method (self or Printful).
AI Features Events & Podcasts All Documentation