Skip to content

FleetQ/website-plugin-ecommerce

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 

Repository files navigation

FleetQ Website E-commerce Plugin

Add a fully functional online store to any website built with the FleetQ Website Builder.

Features

  • 5 GrapesJS blocks: Product Grid (dynamic), Product Card, Product Detail Hero, Checkout Button, Cart Summary
  • Multi-provider payments: Stripe Checkout and Paddle (PayPal, Apple Pay, cards)
  • Zero custom checkout page: Customers are redirected to the provider's hosted checkout
  • MCP tools: Manage products and settings via AI agents
  • Settings UI: Configure payment provider in the FleetQ admin panel

Installation

composer require fleetq/website-plugin-ecommerce

Auto-discovery registers the plugin via EcommercePluginServiceProvider.

Configuration

In the FleetQ admin panel, go to Settings → Plugins → E-commerce to configure:

  • Payment Provider: Stripe Checkout or Paddle
  • API Keys: Your provider's keys (money goes to your account, not FleetQ)
  • Redirect URLs: Where to send customers after payment / on cancel

Payment Providers

Stripe Checkout (default)

Publishable Key: pk_live_...
Secret Key:      sk_live_...

Paddle

Includes PayPal, Apple Pay, Google Pay, and card payments.

Vendor ID:        12345
Vendor Auth Code: ••••••••

How It Works

  1. User adds a Product Grid or Checkout Button block to their page
  2. Customer clicks "Buy Now" on the live site
  3. Browser calls POST /api/public/sites/{slug}/checkout
  4. FleetQ creates a checkout session with your credentials
  5. Customer is redirected to Stripe/Paddle hosted checkout
  6. After payment, customer is redirected to your success URL

Product Pages

Products are WebsitePage entries with page_type = product. Add fields via the page meta:

Field Type Description
price int Price in cents (e.g. 2999 = €29.99)
currency string ISO code (default: eur)
in_stock bool Stock status
sku string Product SKU
images array Image URLs
stripe_price_id string Pre-created Stripe Price ID

MCP Tools

Tool Description
ecommerce_product_list List products for a website
ecommerce_product_create Create a product page
ecommerce_product_update Update price, stock, images
ecommerce_settings_get Read payment configuration
ecommerce_settings_update Update payment provider keys

License

MIT

About

E-commerce blocks and multi-provider checkout (Stripe, Paddle) for the FleetQ Website Builder

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors