MarketPro Docs

📋 Overview

MarketPro is a production-ready multi-vendor e-commerce platform on Laravel 12. It requires no Node.js, no npm, and no build step — all frontend assets load via CDN. One Artisan command installs everything.

⚙️ Requirements

📦 Installation

composer install

cp .env.example .env
php artisan key:generate

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_DATABASE=marketpro
DB_USERNAME=root
DB_PASSWORD=your_password

php artisan marketpro:install

# Flags:
# --fresh     Drop all tables and reinstall from scratch
# --no-seed   Migrate only, skip demo data seeding

php artisan serve
# Open: http://127.0.0.1:8000

📁 File Structure

marketpro/
├── app/
│   ├── Console/Commands/
│   │   ├── InstallCommand.php          # marketpro:install
│   │   └── MarketProCommands.php       # sync-uploads, create-admin, backup, clear-ai-cache
│   ├── Helpers/
│   │   ├── functions.php              # setting(), currency_format(), ai_enabled(), theme_css()…
│   │   └── UploadHelper.php           # upload(), delete(), url() → public/uploads/
│   ├── Http/Controllers/
│   │   ├── Admin/                      # AdminControllers, MoreAdminControllers, AiControllers…
│   │   ├── Vendor/VendorControllers.php
│   │   ├── Customer/                   # CartController, CheckoutController, CustomerControllers
│   │   ├── SubAdmin/DashboardController.php
│   │   ├── Api/AiChatController.php
│   │   └── Auth/AuthController.php
│   ├── Http/Middleware/
│   │   ├── SetLocale.php              # Resolves locale: session → user pref → site default
│   │   ├── ShareViewData.php          # Injects cartCount into all views
│   │   └── VendorApproved.php         # Blocks suspended/unapproved vendors every request
│   ├── Models/
│   │   ├── Models.php                 # All 30+ Eloquent models
│   │   ├── AiSetting.php              # canUse(), hasApiKey(), getApiKey()
│   │   └── Currency.php               # 20+ currencies, session-based conversion
│   └── Services/
│       ├── AiService.php              # 13 AI methods, all with graceful fallbacks
│       ├── OrderService.php           # createOrder(), updateStatus(), updatePaymentStatus()
│       ├── SmsService.php             # 5 SMS gateway integrations
│       └── NotificationService.php    # In-app + email notifications
├── database/
│   ├── migrations/                     # All tables in 2 migration files
│   └── seeders/DatabaseSeeder.php      # Demo admin, vendor, customer + all default settings
├── public/
│   ├── uploads/                        # Created by installer — 11 subdirectories
│   └── images/payments/                # SVG payment logos
├── resources/views/                    # 103 Blade views across 8 sections
│   ├── layouts/                        # admin.blade.php, app.blade.php
│   ├── admin/                          # 49 views
│   ├── vendor/                         # 10 views
│   ├── customer/                       # 25 views
│   ├── subadmin/                       # 4 views
│   ├── emails/                         # invoice, order-confirmation, order-status-updated
│   └── partials/                       # product-card, ai-chat-widget
└── routes/web.php                      # All routes, grouped by role with middleware

🔐 User Roles

MarketPro uses Spatie Laravel-Permission. Four roles are seeded automatically.

Sub-Admin Permissions

12 granular permissions assignable per sub-admin from Admin → Sub Admins → Edit. The sidebar automatically shows only permitted sections:

manage_products    manage_orders      manage_customers
manage_vendors     manage_categories  manage_coupons
manage_banners     manage_reports     manage_shipping
manage_payments    manage_reviews     manage_settings

🗄️ Database Models

📦 Order System

Single vs Multi-Vendor Orders

Single-vendor checkout creates exactly one order row with vendor_id set directly and parent_order_id = null. No child order is created.

Multi-vendor checkout creates a parent order (vendor_id = null) plus one child order per vendor (parent_order_id = parent.id). The parent holds all items for invoicing. The admin orders index filters to whereNull('parent_order_id').

Order Status Flow

pending → confirmed → processing → shipped → out_for_delivery → delivered
                                                              ↘ cancelled (from any state)

Each status change creates an OrderStatusHistory record. Customer is notified by email and SMS (if configured) on each transition.

Invoice Generation

Invoices are generated as PDFs using DomPDF. The view is resources/views/emails/invoice.blade.php. Prices display in base currency using base_currency_format() — not the customer's session currency — because invoices reflect the actual charged amount.

✦ AI Features Reference

All AI features use Claude claude-sonnet-4-6 via the Anthropic API. Each is gated by AiSetting::canUse($feature) which verifies: master switch ON + feature toggle ON + API key present.

Enabling AI

# .env — only these two lines needed
ANTHROPIC_API_KEY=sk-ant-api03-...
ANTHROPIC_MODEL=claude-sonnet-4-6   # optional, this is the default

Then go to Admin → AI Features and toggle the master switch ON. Individual features can be toggled independently.

💳 Payment Gateways

Configure all gateways from Admin → Payments → Payment Gateways. Credentials store in the database — no .env editing required after initial setup.

🌍 Multi-Language

Language strings are stored as JSON files in resources/lang/{code}.json. The admin language manager (Admin → Languages) allows adding, editing, auto-translating, and toggling languages.

Adding a Language

💱 Multi-Currency

MarketPro ships with 20 pre-configured currencies. Prices are stored in your base currency. When a customer switches currency, prices are converted in real-time using session-stored exchange rates.

How it works

// Customer switches to EUR → stored in session:
currency_code     = "EUR"
currency_symbol   = "€"
currency_rate     = 0.92    // multiplied against USD base price

// currency_format() applies the conversion automatically
currency_format(100.00)  // → "€92.00"

// base_currency_format() always shows base currency (for invoices, admin)
base_currency_format(100.00)  // → "$100.00"

Enable the frontend switcher in Admin → Settings → General → Enable Multi-Currency Switcher. Customers then see a currency dropdown in the site header.

📁 File Uploads

All uploads go to public/uploads/ with sub-directories per content type. This means no storage:link symlink is needed — files are directly accessible as public assets.

public/uploads/
├── products/        # Product thumbnails and gallery images
├── avatars/         # User profile photos
├── vendors/         # Vendor logos and store banners
├── categories/      # Category images
├── branding/        # Site logo, favicon
├── banners/         # Homepage banners
├── flags/           # Language flag images
├── reviews/         # Review photos
├── brands/          # Brand logos
├── pages/           # CMS page images
└── payments/        # Payment confirmation screenshots

The UploadHelper class handles all file operations. Use upload_url($path) in Blade to get the full URL with fallback to a placeholder image.

🔧 Environment Variables

💻 Artisan Commands

🎨 Branding & Theme

Go to Admin → Branding & Theme to customise the visual identity without touching code. All settings are applied via CSS custom properties injected by the theme_css() helper function in every layout.

🔩 Helper Functions

🔑 Demo Credentials

🔨 Troubleshooting