👁 List of Products
👁 Products by Category
👁 sCommerce Settings block
👁 Latest Stable Version
👁 CMS Evolution
👁 PHP version
👁 License
👁 Issues
👁 Stars
👁 Total Downloads

Welcome to sCommerce!​

sCommerce is a comprehensive e-commerce solution designed specifically for Evolution CMS. It provides a complete framework for building online stores with products, categories, orders, payments, inventory management, and much more.

Whether you need a simple product catalog or a complex multi-vendor marketplace, sCommerce gives you the tools to create powerful e-commerce experiences with full control over your business logic and customer data.

👉 Start with Getting Started or explore Developer Guide.

Key Features​

✅ Product Management​

• Complete product catalog - Products with variants, attributes, and specifications
• Category management - Hierarchical category structure with unlimited depth
• Product variants - Size, color, material, and custom attribute combinations
• Inventory tracking - Real-time stock management with low stock alerts
• Product images - Multiple images per product with gallery support
• SEO optimization - Meta tags, URLs, and structured data for search engines
• Bulk operations - Import/export products via Excel/CSV files

✅ Order Management​

• Order processing - Complete order lifecycle from cart to delivery
• Order status tracking - Pending, processing, shipped, delivered, cancelled
• Order history - Complete customer order history and admin order management
• Order notifications - Email notifications for order status changes
• Order analytics - Sales reports and order statistics
• Order search - Advanced filtering and search capabilities

✅ Payment Integration​

• Multiple payment methods - Credit cards, PayPal, bank transfers, and more
• Payment gateways - Integration with popular payment processors
• Secure payments - PCI-compliant payment processing
• Payment status tracking - Real-time payment status updates
• Refund management - Process refunds and returns
• Payment analytics - Payment method performance and success rates

✅ Customer Management​

• Customer accounts - Registration, login, and profile management
• Customer groups - VIP customers, wholesale, and custom pricing
• Address book - Multiple shipping and billing addresses
• Order history - Complete purchase history and order tracking
• Customer communication - Email notifications and marketing tools
• Customer analytics - Purchase behavior and customer insights

✅ Shopping Cart & Checkout​

• Shopping cart - Persistent cart with session management
• Guest checkout - Checkout without registration
• Multiple currencies - Support for different currencies and exchange rates
• Tax calculation - Automatic tax calculation based on location
• Shipping calculation - Real-time shipping cost calculation
• Coupon system - Discount codes and promotional offers

✅ Admin Interface​

• Dashboard - Sales overview, recent orders, and key metrics
• Product management - Easy product creation and editing
• Order management - Process orders and update statuses
• Customer management - View and manage customer accounts
• Reports - Sales reports, product performance, and analytics
• Settings - Configure store settings, payment methods, and shipping

✅ Developer Features​

• REST API - Complete API for mobile apps and integrations
• Webhooks - Real-time notifications for external systems
• Custom fields - Extend products and orders with custom data
• Event system - Hook into order and product events
• Template system - Customizable product and category templates
• Plugin architecture - Extend functionality with custom plugins

Architecture Overview​

┌──────────────────────────────────────────┐
│ sCommerce Architecture │
├──────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ │
│ │ Products │ │ Orders │ │
│ ├──────────────┤ ├──────────────┤ │
│ │ Categories │─────>│ Order Items │ │
│ │ Attributes │─────>│ Payments │ │
│ │ Inventory │─────>│ Shipping │ │
│ │ Images │─────>│ Status │ │
│ └──────────────┘ └──────────────┘ │
│ │ │ │
│ v v │
│ ┌──────────────────────────────────┐ │
│ │ sCommerce Core │ │
│ ├──────────────────────────────────┤ │
│ │ - Product Management │ │
│ │ - Order Processing │ │
│ │ - Payment Integration │ │
│ │ - Customer Management │ │
│ │ - Cart & Checkout │ │
│ └──────────────────────────────────┘ │
│ │ │ │
│ v v │
│ ┌──────────────┐ ┌──────────────┐ │
│ │ Frontend │ │ Admin │ │
│ │ Templates │ │ Interface │ │
│ ├──────────────┤ ├──────────────┤ │
│ │ Product │ │ Dashboard │ │
│ │ Category │ │ Orders │ │
│ │ Cart │ │ Products │ │
│ │ Checkout │ │ Customers │ │
│ └──────────────┘ └──────────────┘ │
│ │
└──────────────────────────────────────────┘

Quick Example​

Create a Product​

use Seiger\sCommerce\Facades\sCommerce;
use Seiger\sCommerce\Models\sProduct;

// Create a new product
$product = sProduct::create([
 'name' => 'Premium T-Shirt',
 'alias' => 'premium-t-shirt',
 'price_regular' => 29.99,
 'description' => 'High-quality cotton t-shirt',
 'category' => 1, // Category ID
 'published' => 1,
 'in_stock' => 100
]);

// Add product images
$product->images()->create([
 'image' => 'tshirt-main.jpg',
 'alt' => 'Premium T-Shirt Front View',
 'sort' => 1
]);

// Add product attributes
$product->attributes()->create([
 'attribute' => 'color',
 'value' => 'Blue',
 'price_modifier' => 0
]);

Process an Order​

use Seiger\sCommerce\Models\sOrder;
use Seiger\sCommerce\Models\sOrderItem;

// Create order
$order = sOrder::create([
 'customer_id' => 1,
 'status' => 'pending',
 'total' => 59.98,
 'currency' => 'USD',
 'shipping_address' => [
 'name' => 'John Doe',
 'address' => '123 Main St',
 'city' => 'New York',
 'zip' => '10001',
 'country' => 'US'
 ]
]);

// Add order items
$order->items()->create([
 'product_id' => 1,
 'quantity' => 2,
 'price' => 29.99,
 'total' => 59.98
]);

// Process payment
$order->processPayment([
 'method' => 'credit_card',
 'transaction_id' => 'txn_123456',
 'status' => 'completed'
]);

// Update order status
$order->update(['status' => 'processing']);

Use the API​

// Get products
$products = sCommerce::getProducts([
 'category' => 1,
 'published' => true,
 'in_stock' => true
]);

// Get product details
$product = sCommerce::getProduct('premium-t-shirt');

// Add to cart
sCommerce::addToCart($product->id, 2);

// Get cart
$cart = sCommerce::getCart();

// Create order
$order = sCommerce::createOrder([
 'items' => $cart->items,
 'customer_id' => 1,
 'shipping_address' => $address
]);

Use Cases​

E-commerce Stores​

• Online retail - Complete product catalogs with shopping cart
• B2B sales - Wholesale pricing and customer groups
• Digital products - Software, ebooks, and digital downloads
• Subscription services - Recurring billing and subscription management
• Multi-vendor marketplaces - Multiple sellers on one platform

Business Applications​

• Inventory management - Track stock levels and reorder points
• Sales reporting - Detailed analytics and performance metrics
• Customer management - CRM integration and customer insights
• Order fulfillment - Warehouse management and shipping
• Financial reporting - Revenue tracking and tax reporting

Integration Scenarios​

• ERP systems - Sync with enterprise resource planning
• Accounting software - Export orders and financial data
• Marketing tools - Customer data for email campaigns
• Analytics platforms - E-commerce tracking and conversion
• Mobile apps - API integration for mobile commerce

Requirements​

• Evolution CMS 3.7+
• PHP 8.3+
• Composer 2.2+
• One of: MySQL 8.0+ / MariaDB 10.5+ / PostgreSQL 10+ / SQLite 3.25+
• sTask package for background processing (required for import/export and cache generation)

Installation​

cd core
composer update
php artisan package:installrequire seiger/scommerce "*"
php artisan vendor:publish --tag=scommerce
php artisan migrate

See Getting Started for detailed installation instructions.

Performance​

sCommerce is designed for high performance:

• Optimized queries - Efficient database queries with proper indexing
• Caching system - Product and category caching for fast loading
• Image optimization - Automatic image resizing and compression
• CDN support - Content delivery network integration
• Database optimization - Proper indexing and query optimization
• Memory management - Efficient memory usage for large catalogs

Benchmarks​

Typical performance on standard hardware:

Processing 10,000 products:

• Product listing: ~200ms
• Category filtering: ~150ms
• Search operations: ~300ms
• Bulk operations: ~2 minutes

Performance varies based on catalog size and system resources.

Future Features​

• Multi-language support - Full internationalization
• Advanced analytics - Detailed sales and customer analytics
• AI recommendations - Product recommendation engine
• Mobile app - Native mobile application
• Advanced shipping - Complex shipping rules and zones
• Loyalty program - Points and rewards system
• A/B testing - Product and page testing
• Advanced reporting - Custom report builder
• API v2 - Enhanced REST API
• GraphQL support - Modern API query language

Community & Support​

• Documentation: https://seiger.github.io/sCommerce
• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Author: Seiger
• License: MIT

Contributing​

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Write tests if applicable
5. Submit a pull request

License​

sCommerce is open-source software licensed under the MIT license.

Credits​

Developed and maintained by Seiger.