The E-Shop add-on transforms your Larapen website into a full e-commerce store — sell physical products, digital goods, and external products with a complete shopping cart, checkout flow, coupon system, order management, and merchant feed generation.
Key Features
- Product management — Create products with translatable name, description, short description, SKU, pricing, stock tracking, and featured images. Supports three product types: internal, external, and digital.
- Product variants — Define variants (size, color, etc.) with individual SKU, price, and stock per variant. Variant attributes stored as flexible JSON.
- External products — List products that link to external retailers with a "Buy Now" button instead of the internal cart flow.
- Digital products — Sell downloadable files with configurable max downloads and expiry days. Buyers receive time-limited download links after payment.
- Product categories — Organize products into hierarchical categories with translatable names, descriptions, and SEO metadata.
- Sale pricing — Set a sale price alongside the regular price to display discounts.
- Shopping cart — Session-based cart for guests, database-backed cart for authenticated users. Automatic cart merging on login. Configurable max quantity per item.
- Checkout flow — Full checkout with billing and shipping address forms. Guest checkout can be enabled or disabled.
- Order management — Track orders through statuses: pending, processing, completed, cancelled, refunded. Unique order numbers auto-generated with configurable prefix.
- Order tracking — Public order tracking page where customers can check their order status.
- Coupon system — Create percentage or fixed-amount discount coupons with min order amount, max uses, date ranges, and maximum discount caps.
- Tax support — Configurable tax rate with inclusive/exclusive calculation.
- Shipping — Flat-rate shipping with free shipping threshold.
- Payment gateways — Extensible payment system via add-on payment gateways (Stripe, PayPal, Paddle, MTN MoMo). Discovers installed payment add-ons automatically.
- Merchant feeds — Generate product feeds for Google Shopping, Bing, Facebook, Amazon, TikTok, Yandex, and Baidu with customizable field mappings.
- Structured data — Automatic schema.org/Product JSON-LD output on product pages for rich search results, supporting variants, pricing, and availability.
- Stock management — Automatic stock reduction on order, restoration on cancellation, low stock threshold alerts.
- Notifications — Email notifications to admin on new orders and to customers on order status changes.
- Multilingual — All product fields (name, description, slug, SEO metadata) are fully translatable.
Admin Panel
| Section | Description |
|---|---|
| Products | List, search, filter, and manage all products (internal, external, digital). |
| Add Product | Create a new product with variants, gallery images, pricing, and SEO metadata. |
| Categories | Manage hierarchical product categories with translatable content. |
| Orders | View and manage customer orders, update statuses, process refunds, and deliver digital downloads. |
| Coupons | Create and manage discount coupons with flexible rules. |
| Merchant Feeds | Configure product feed generation for Google, Facebook, Amazon, TikTok, and other platforms. |
| Settings | Configure currency, tax, shipping, checkout, stock, digital download limits, and notification settings. |
Front-end
- Product catalog — Grid/list views with pagination, sidebar filters, and category navigation.
- Product pages — Individual product pages with image gallery, variants, pricing, structured data, and add-to-cart.
- Category pages — Browse products filtered by category.
- Shopping cart — Cart page with quantity editing and coupon application.
- Checkout — Checkout flow with billing/shipping forms, payment method selection, and order summary.
- "My Orders" — Logged-in users can track their orders and access digital downloads.
- Order tracking — Public page for checking order status by order number.
Menu integration
- Shop Product — Link to a specific product.
- Shop Category — Link to a product category.
Payment Gateways
The Shop uses an extensible payment gateway system. Payment gateways are separate add-ons that implement the PaymentGatewayInterface. Currently available:
- Stripe — Credit card payments via Stripe Payment Intents with 3D Secure support.
- PayPal — PayPal redirect-based checkout with REST API.
- Paddle — Paddle checkout overlay (merchant of record).
- MTN MoMo — Mobile money payments via MTN Mobile Money API.
Dependencies
None — the Shop add-on works independently. Payment gateway add-ons (Stripe, PayPal, Paddle, MTN MoMo) depend on Shop. Without a payment gateway, only Cash on Delivery is available.
Requires user account
Yes — for order tracking and "My Orders" functionality. Guest checkout is available when enabled.
Ideal for
- Online stores selling physical products with inventory tracking.
- Digital product sales (templates, ebooks, software, music).
- Affiliate and external product listings.
- Multi-channel commerce with merchant feed syndication to Google Shopping, Facebook, and more.